Twenty MCP Server

Twenty MCP サーバー

Twenty CRM と連携する MCP サーバーです。カテゴリ別のツールを通じて、Twenty の REST API にアクセスできます。利用可能なツールは Twenty REST API 全体に対応しており、openapi-mcp-generator を使用して自動生成されています。

インストール

リポジトリをクローンして、ビルドします：npm install && npm run build

使用方法

このサーバーには、試行を通じて見つかったベストプラクティス（ワークフローの要件、書式の規則、検索のヒントなど）をまとめた使用方法の説明が src/instructions/instructions.md に含まれています。このファイルを編集して npm run build で再ビルドすることで、特定のユースケースに合わせてカスタマイズできます。

ツールのフィルタリング

この MCP サーバーは、カテゴリ別のフィルタリングと個別ツールのフィルタリングの両方に対応しており、必要なツールだけを選択して有効にできます。この方法により、コンテキストウィンドウの使用量を大幅に削減し、パフォーマンスを向上できます。

利用可能なカテゴリ

カテゴリ	説明
api-schema	API スキーマとメタデータ
crm	CRM と連絡先管理
tasks	タスクとプロジェクト管理
notes	メモとドキュメント
attachments	ファイル添付
calendar	カレンダーとイベント
messaging	メッセージングとコミュニケーション
preferences	ユーザー設定と組織
views	データビューとフィルタリング
workflow	ワークフローと自動化
system	システムと管理

利用可能なツール

利用可能なツールはすべて、Twenty REST API スキーマの operationId フィールドで確認できます。スキーマは https://your-twenty-instance.com/rest にあります。次のいずれかの方法で確認できます：

• Twenty インスタンスから OpenAPI 仕様をダウンロードする
• このリポジトリの /src/tools/ ディレクトリでツール定義を直接確認する

使用方法

MCP クライアントの設定

MCP クライアント（Claude Desktop など）でこのサーバーを設定する際に、カテゴリおよび／または特定のツールを指定する引数を使用して、利用可能なツールを制御できます。

ヒント

パフォーマンスに関する推奨事項
利用可能なツールは、必要なものだけに絞ることを強くおすすめします。これにより、利用可能なツールの表示に必要なコンテキストウィンドウのサイズが小さくなり、パフォーマンスとコスト効率の両方が向上します。

メモ

以下の「特定のツールを指定する」例で定義されているツールは、現在私が使用しているツール構成です。

カテゴリを使用する

事前定義されたカテゴリでツールをフィルタリングします：

{
  "mcpServers": {
    "twenty": {
      "command": "node",
      "args": [
        "/path/to/twenty-mcp-server/build/index.js",
        "--category=crm,tasks,notes"
      ],
      "env": {
        "TWENTY_BASE_URL": "https://your-twenty-instance.com/rest",
        "TWENTY_API_KEY": "your-api-key"
      }
    }
  }
}

特定のツールを指定する

名前で個別のツールを選択します：

{
  "mcpServers": {
    "twenty": {
      "command": "node",
      "args": [
        "/path/to/twenty-mcp-server/build/index.js",
        "--tools=findManyCompanies, createOneCompany, findOneCompany, UpdateOneCompany, findManyPeople, createOnePerson, findOnePerson, UpdateOnePerson,findOneNote, findManyNotes, createOneNote, createManyNotes, UpdateOneNote, createOneNoteTarget, createManyNoteTargets, findManyOpportunities, createOneOpportunity, findOneOpportunity, UpdateOneOpportunity"
      ],
      "env": {
        "TWENTY_BASE_URL": "https://your-twenty-instance.com/rest",
        "TWENTY_API_KEY": "your-api-key"
      }
    }
  }
}

カテゴリと特定のツールを組み合わせる

両方の方法を組み合わせて使用します：

{
  "mcpServers": {
    "twenty": {
      "command": "node",
      "args": [
        "/path/to/twenty-mcp-server/build/index.js",
        "--category=crm,tasks",
        "--tools=findManyAttachments,createOneAttachment"
      ],
      "env": {
        "TWENTY_BASE_URL": "https://your-twenty-instance.com/rest",
        "TWENTY_API_KEY": "your-api-key"
      }
    }
  }
}

---

デフォルトの動作

メモ

デフォルト設定 --category と --tools のどちらの引数も指定しない場合、デフォルトですべてのカテゴリが有効になります。これにより Twenty API 全体にアクセスできますが、利用可能なツールが多数あるため、パフォーマンスとコストに影響します。

注意

開発版
このサーバーは現在開発中であり、本番環境での使用は推奨されません。本番環境で使用する場合は、自己責任でお願いします。 この MCP サーバーは、api-key を使用して Twenty CRM API にアクセスします。認可、認証、アクセス制御の機能は組み込まれていません。