Twenty Crm MCP Server

🚀 🤖 Twenty CRM MCP Server

Twenty CRMをAIパワードのアシスタントに変えましょう。このサーバーはTwenty CRMとClaudeなどのAIアシスタントを接続し、顧客データとの自然言語対話を可能にします。

🚀 クイックスタート

✨ 主な機能

📦 インストール

前提条件

• Node.js 18以上
• Twenty CRMインスタンス（クラウドまたはセルフホスト）
• Claude Desktopまたは互換性のあるMCPクライアント

セットアップ

1. リポジトリをクローンします：

git clone https://github.com/mhenry3164/twenty-crm-mcp-server.git
cd twenty-crm-mcp-server

2. 依存関係をインストールします：

npm install

3. Twenty CRMのAPIキーを取得します：

   • Twenty CRMワークスペースにログインします。
   • 設定 → API & Webhooks（開発者向け）に移動します。
   • 新しいAPIキーを生成します。

4. Claude Desktopを設定します： claude_desktop_config.jsonにサーバーを追加します。

{
  "mcpServers": {
    "twenty-crm": {
      "command": "node",
      "args": ["/path/to/twenty-crm-mcp-server/index.js"],
      "env": {
        "TWENTY_API_KEY": "your_api_key_here",
        "TWENTY_BASE_URL": "https://api.twenty.com"
      }
    }
  }
}

セルフホストのTwentyインスタンスの場合は、TWENTY_BASE_URLをあなたのドメインに変更してください。

5. Claude Desktopを再起動して、新しいサーバーを読み込みます。

💻 使用例

基本的な使用法

設定が完了したら、自然言語を使ってTwenty CRMと対話できます。

👥 人物管理

"List the first 10 people in my CRM"
"Create a new person named John Doe with email john@example.com"
"Update Sarah's job title to Senior Developer"
"Find all people working at tech companies"

🏢 会社管理

"Show me all companies with more than 100 employees"
"Create a company called Tech Solutions with domain techsolutions.com"
"Update Acme Corp's annual revenue to $5M"

✅ タスク管理

"Create a task to follow up with John next Friday"
"Show me all overdue tasks"
"Mark the task 'Call client' as completed"

📝 メモと検索

"Add a note about my meeting with the client today"
"Search for any records mentioning 'blockchain'"
"Find all contacts without LinkedIn profiles"

📚 ドキュメント

🛠️ APIリファレンス

サーバーは以下のツールを提供します。

⚙️ 設定

環境変数

• TWENTY_API_KEY（必須）: あなたのTwenty CRM APIキー
• TWENTY_BASE_URL（オプション）: Twenty CRMのベースURL（デフォルトはhttps://api.twenty.com）

カスタムフィールド

サーバーはTwenty CRMインスタンスのカスタムフィールドを自動的に検出し、サポートします。新しいフィールドを追加する際には、設定を変更する必要はありません。

🔧 技術詳細

🤝 コントリビュート

コントリビューションを歓迎します！ガイドラインについてはCONTRIBUTING.mdを参照してください。

開発

1. リポジトリをクローンします：

git clone https://github.com/mhenry3164/twenty-crm-mcp-server.git
cd twenty-crm-mcp-server

2. 依存関係をインストールします：

npm install

3. 環境変数を設定します：

cp .env.example .env
# .envをあなたのAPIキーで編集します

4. サーバーをテストします：

npm test

🐛 トラブルシューティング

一般的な問題

• 認証エラー：APIキーが正しく、適切な権限を持っていることを確認してください。
• 接続失敗：TWENTY_BASE_URLが正しいことを確認してください（特にセルフホストのインスタンスの場合）。
• フィールドが見つからない：サーバーは自動的にフィールドを検出します。フィールドエラーが発生した場合は、まずメタデータを取得してみてください。例： "Show me the available fields for people"

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• Twenty CRM 素晴らしいオープンソースCRMを提供してくれたこと
• Anthropic モデルコンテキストプロトコルを提供してくれたこと
• MCPコミュニティ インスピレーションとサンプルを提供してくれたこと

🔗 リンク

• Twenty CRMドキュメント
• モデルコンテキストプロトコル仕様
• Claude Desktop