use-twenty-mcp

使用する場面

ユーザーが実行中の Twenty ワークスペースから読み取ったり、調査したりしたい場合にこのスキルを選択します。アプリのコードを変更する場合ではありません。代表的なトリガーは次のとおりです。

• 「Twenty の自分のすべての会社 / 人物 / 商談を一覧表示して」
• 「今週作成したレコードを見せて」
• 「自分の Twenty ワークスペースには何がある？」
• 「自分のエージェントを自分の Twenty ワークスペースに接続して」
• 「myworkspace.twenty.com 用に Twenty MCP をセットアップして」
• 「X について CRM にクエリして」
• 「Twenty から自分のパイプラインを要約して」
• 「会社オブジェクトのフィールドを見せて」

このスキルを、アプリの雛形作成（create-app を使用）、アプリのエンティティの追加や変更（develop-app を使用）、アプリの操作（manage-app を使用）、マーケットプレイス用アセットの準備（publish-app を使用）には使用しないでください。

これは何か

Twenty MCP は、エージェントを既存の Twenty ワークスペースに接続し、ワークスペースのデータとメタデータ（レコード、オブジェクト、フィールド、スキーマ、設定、および関連する CRM コンテキスト）を調査できるようにします。

これは Twenty アプリとは異なります。ユーザーが新しいアプリのコードベースの雛形作成を望む場合は $create-app を、オブジェクト、フィールド、ロジック、レイアウト、コンポーネントなどアプリ定義の機能の追加を望む場合は $develop-app を使用してください。

ユーザーがエージェントをすでに実行中のワークスペースに接続したい場合、ワークスペースのデータを取得または調査したい場合、メタデータを調査したい場合、または MCP アクセスをトラブルシューティングしたい場合は $use-twenty-mcp を使用してください。

ワークスペースをカスタマイズする既定の方法として MCP を使用しないでください。たとえば、MCP を直接使うのではなく、Twenty アプリを通じて新しいオブジェクトを作成することを優先してください。MCP をワークスペースのカスタマイズに使用するのは、ユーザーが明示的に MCP を通じて行うことを求めた場合のみにしてください。

セットアップ

ワークスペース URL の正規化、MCP サーバーの設定、OAuth のガードレール、セットアップのトラブルシューティングには ../../references/use-twenty-mcp/setup.md を使用してください。

取得

ワークスペースのレコードを取得、一覧表示、検索、要約、または表示する前に、../../references/use-twenty-mcp/result-formatting.md を読んでください。

このリファレンスは、適切な Twenty MCP ワークスペースの選択、レコードのクエリ、レコードリンクの構築、日付と値のフォーマット、および生の API 出力ではなく読みやすい Markdown の表示を行う際に適用してください。

出力契約

取得したワークスペースレコードの最終回答の前に:

• ツール出力に recordReferences が含まれる場合、最初のレコード名の列またはレコードの見出しは、各表示名を Twenty にリンクバックしなければなりません。
• リンクは、選択したワークスペースのオリジンと返された recordReferences を使用して {workspaceOrigin}/object/{objectNameSingular}/{recordId} として構築してください。
• ワークスペースのオリジンが不明な場合は、可能であれば選択した MCP サーバー URL から解決してください。それでも解決できない場合は、ホストをでっち上げるのではなく、直接のレコードリンクにはワークスペース URL が必要であることを述べてください。
• recordReferences とワークスペースのオリジンが利用可能な場合、レコードテーブルにリンクのないレコード名を表示しないでください。