MCP Folk

🚀 Folk CRM MCPサーバー

Folk CRMの機能にアクセスできるMCP（Model Context Protocol）サーバーです。AIアシスタントが連絡先、会社、メモ、リマインダーなどを管理できるようになります。

✨ 主な機能

• スマート検索：最小限のトークン使用量で名前で人や会社を検索できます。
• 二段階検索：クイック検索でIDを取得し、必要に応じて詳細情報を取得します。
• 連絡先管理：人や会社の作成、更新、削除ができます。
• メモとリマインダー：連絡先に関連するコンテキストを添付できます。
• インタラクションログ：メール、会議、通話を追跡できます。
• 組み込みスキルリソース：skill://folk/usage リソースを提供し、LLMに正しいツールルーティング、ID形式ルール、状況処理パターンを教えます。

📦 インストール

レジストリから（公開版）

# Folk APIキーを設定する
mpak config set @nimblebraininc/folk api_key=your_api_key_here

# Claude Codeに追加する
claude mcp add folk -- mpak run @nimblebraininc/folk

ローカル開発

# リポジトリをクローンして移動する
git clone https://github.com/NimbleBrainInc/mcp-folk.git
cd mcp-folk

# 依存関係をインストールする
uv sync

# バンドルをビルドする
make pack

# APIキーを設定する
mpak config set @nimblebraininc/folk api_key=your_api_key_here

# Claude Codeに追加する（絶対パスを使用）
claude mcp add folk -- mpak run --local /path/to/mcp-folk/mcp-folk-0.1.0-darwin-arm64.mcpb

🔧 設定

Folk APIキーの取得方法

1. Folkワークスペースにログインします。
2. 設定 > API に移動します。
3. 新しいAPIキーを作成します。
4. キーをコピーし、mpak config set で設定します。

💻 使用例

検索（最初に使用）

詳細情報（検索後）

ブラウズ

グループとフィルタリング

アクション

メモとリマインダー

ユーティリティ

一般的な利用シナリオ

• 連絡先の検索
  • "私のCRMにSarah Chenはいますか？"
  • "Acme Corpの全員を見つけてください。"
  • "Johnのメールアドレスは何ですか？"
• 会議後の連絡先追加
  • "今日の会議で出会ったMike Johnsonを追加してください。彼はStripeのPMです。"
  • "lisa@example.comの連絡先を作成してください。"
• メモの作成
  • "Sarahにメモを追加してください：Q2のロードマップについて話しました。彼女はエンタープライズプランに興味があります。"
  • "Acmeの取引に関するメモは何ですか？"
• フォローアップの設定
  • "来週の火曜日にJohnにフォローアップするようにリマインダーを設定してください。"
  • "2週間後にSarahに確認するリマインダーを設定してください。"
• インタラクションの記録
  • "今日Mikeとの通話を記録してください。"
  • "Acmeチームとの会議を記録してください。"
• 連絡先のブラウズ
  • "最近の連絡先を表示してください。"
  • "私のCRM内のすべての会社をリストしてください。"
• グループとパイプラインのクエリ
  • "ステータスが'Follow up 1'の'Demos Management'のリードを表示してください。"
  • "私のInvestorsグループ内のすべての人をリストしてください。"
  • "私のCustomersグループ内のアクティブなクライアントを見つけてください。"
  • "Folkにはどのようなグループがありますか？"

実行例

ユーザー: "私はAlex Riveraとコーヒーを飲みました。彼女は私たちのAPIに興味があります。来週にドキュメントを送るようにリマインダーを設定してください。"

AI: find_person("Alex Rivera")
→ {"found": true, "matches": [{"id": "abc123", "name": "Alex Rivera", "email": "alex@techco.io"}]}

AI: add_note("abc123", "Had coffee - interested in API, wants to see docs")
→ {"id": "note456", "added": true}

AI: log_interaction("abc123", "meeting", "2024-01-15T10:00:00Z")
→ {"id": "int789", "logged": true}

AI: set_reminder("abc123", "Send API docs to Alex", "2024-01-22T09:00:00Z")
→ {"id": "rem012", "set": true}

AI: "完了！コーヒーチャットに関するメモを追加し、会議を記録し、来週の月曜日にAPIドキュメントを送るリマインダーを設定しました。"

開発

# 開発用の依存関係をインストールする
uv sync --dev

# テストを実行する
uv run pytest tests/ -v

# コードを整形する
uv run ruff format .

# 静的解析を行う
uv run ruff check .

# 型チェックを行う
uv run mypy src/

# すべてのチェックを実行する
make check

# テスト用のバンドルをビルドする
make pack

📚 ドキュメント

このサーバーは Folk REST API を使用しています。主要なエンドポイントは以下の通りです。

• ベースURL: https://api.folk.app/v1
• 認証: ベアラートークン
• レート制限が適用されます（Folkのドキュメントを参照）

📄 ライセンス

MIT