Twenty
発信者を識別し、MCPサーバー経由でTwenty CRMに新しいリードを追加します。
受付担当は、Twentyに登録済みの発信者を識別し、新しい発信者を名前、電話番号、用件とともに人物として追加できるため、営業チームがフォローアップできます。ReceptionはTwenty内蔵の MCPサーバー に接続します。Twenty Cloudとセルフホスト版Twentyの両方に対応しています。TwentyのREST API用に Webhookツール を構築することもできますが、MCPサーバーなら設定の手間を抑えられます。人物の検索や追加に使える既成のツールが提供され、以下の用件フィールドを含め、ワークスペースのフィールドにあらかじめ対応しています。
セットアップ
用件のフィールドを追加する
TwentyのPeopleには専用のメモフィールドがありません。発信者の用件をレコードに保存するには、Settings → Data model を開き、People を選択して、Call reason という名前の Text フィールドを追加します。データモデルを変更できるのはワークスペース管理者だけです。
Reception.ai用のロールを作成する
Settings → Members → Roles に移動し、Peopleの読み取りと作成だけが可能なロールを作成します。次の手順で、このロールにAPIキーを割り当てます。
APIキーを作成する
Settings → Developers → API に移動し、+ Create key を選択します。Reception.ai などの名前を付け、すぐにコピーしてください。Twentyで表示されるのは一度だけです。その後、作成したロールを開き、Assignment タブでキーを割り当てます。
APIキーでは、ロールで許可されたすべてのデータを読み取り、変更できます。共有ドキュメントには記載せず、 漏えいした場合はTwentyで削除してください。
MCPサーバーを追加する
Reception.aiで Integrations に移動し、Add integration を選択して、MCP Server を選びます。
正確なアドレスは、Twentyの Settings → AI → MCP からコピーできます。URLに ?mode=meta を追加しないでください。このモードでは、あらゆるアクションを実行できる単一のツールが受付担当に提供されます。
Enable を選択します。Reception.aiはキーをBearerトークンとして送信し、Twentyのツールを一覧表示します。
ツールを割り当てる
Twentyでは、すべてのオブジェクトの各アクションに対応するツールが表示されます。Tools タブを開き、次のツールだけを Client（受付担当）に割り当てます。
find_many_people：電話番号で発信者を検索します。create_one_person：新しい発信者を名前、電話番号、用件とともに追加します。
更新・削除ツールと、他のオブジェクト用のツールは割り当てないでください。
手順を追加する
新規リード向けの 手順 を追加します。まず電話番号で発信者を検索し、一致する人物が見つからない場合だけ作成します。名、姓、電話番号、用件は必ず入力するようにしてください。また、受付担当がCRMレコードの内容を発信者に読み上げないようルールを追加します。
制限事項
- Twentyでは国番号が電話番号の残りの部分と分けて保存されます。国番号なし、または異なる形式で保存された発信者は見つからない場合があり、リピーターが重複して追加されることがあります。
- この設定では、受付担当はメモ、タスク、商談を作成しません。チームは People リストから新しい人物を確認します。たとえば、Call reason で絞り込んだビューを使用できます。
- セルフホストインスタンスでは、MCPサーバーを含むバージョンのTwentyが必要です。また、公開URLはインターネットからHTTPS経由でアクセスできる必要があります。
- TwentyのAPIでは、1分あたり100件までリクエストできます。他のインテグレーションも利用する使用量の多いワークスペースでは、上限に達する可能性があります。