> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Twenty

受付担当は、Twentyに登録済みの発信者を識別し、新しい発信者を名前、電話番号、用件とともに人物として追加できるため、営業チームがフォローアップできます。ReceptionはTwenty内蔵の [MCPサーバー](/docs/ja/reception-ai/integrations/mcp-server) に接続します。Twenty Cloudとセルフホスト版Twentyの両方に対応しています。TwentyのREST API用に [Webhookツール](/docs/ja/reception-ai/integrations/webhooks) を構築することもできますが、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** タブでキーを割り当てます。

> **Warning**
>
> APIキーでは、ロールで許可されたすべてのデータを読み取り、変更できます。共有ドキュメントには記載せず、
> 漏えいした場合はTwentyで削除してください。

### MCPサーバーを追加する

Reception.aiで **Integrations** に移動し、**Add integration** を選択して、**MCP Server** を選びます。

| フィールド            | 値                                     |
| ---------------- | ------------------------------------- |
| **Name**         | Twenty                                |
| **Server type**  | Streamable HTTP                       |
| **Server URL**   | 以下のとおり、ワークスペースのアドレスの末尾に `/mcp` を付けたもの |
| **Secret Token** | APIキー                                 |

| Twentyの実行環境  | サーバーURL                                          |
| ------------ | ------------------------------------------------ |
| Twenty Cloud | ワークスペースURL（例：`https://mycompany.twenty.com/mcp`） |
| セルフホスト       | インスタンスの公開URL（例：`https://crm.example.com/mcp`）    |

正確なアドレスは、Twentyの **Settings** → **AI** → **MCP** からコピーできます。URLに `?mode=meta` を追加しないでください。このモードでは、あらゆるアクションを実行できる単一のツールが受付担当に提供されます。

**Enable** を選択します。Reception.aiはキーをBearerトークンとして送信し、Twentyのツールを一覧表示します。

### ツールを割り当てる

Twentyでは、すべてのオブジェクトの各アクションに対応するツールが表示されます。**Tools** タブを開き、次のツールだけを **Client**（受付担当）に割り当てます。

* `find_many_people`：電話番号で発信者を検索します。
* `create_one_person`：新しい発信者を名前、電話番号、用件とともに追加します。

更新・削除ツールと、他のオブジェクト用のツールは割り当てないでください。

### 手順を追加する

新規リード向けの [手順](/docs/ja/reception-ai/receptionist/rules-and-procedures) を追加します。まず電話番号で発信者を検索し、一致する人物が見つからない場合だけ作成します。名、姓、電話番号、用件は必ず入力するようにしてください。また、受付担当がCRMレコードの内容を発信者に読み上げないようルールを追加します。

### テストする

Twentyの人物に保存されている番号から電話をかけ、その後、見積もりを希望する新規発信者として [受付担当をテスト](/docs/ja/reception-ai/receptionist/testing) します。新しい人物が **People** に表示され、用件が入力されます。

## 制限事項

* Twentyでは国番号が電話番号の残りの部分と分けて保存されます。国番号なし、または異なる形式で保存された発信者は見つからない場合があり、リピーターが重複して追加されることがあります。
* この設定では、受付担当はメモ、タスク、商談を作成しません。チームは **People** リストから新しい人物を確認します。たとえば、**Call reason** で絞り込んだビューを使用できます。
* セルフホストインスタンスでは、MCPサーバーを含むバージョンのTwentyが必要です。また、公開URLはインターネットからHTTPS経由でアクセスできる必要があります。
* TwentyのAPIでは、1分あたり100件までリクエストできます。他のインテグレーションも利用する使用量の多いワークスペースでは、上限に達する可能性があります。

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

| 問題              | 確認事項                                                                                                            |
| --------------- | --------------------------------------------------------------------------------------------------------------- |
| ツールが表示されない      | サーバータイプに **Streamable HTTP** を使用し、URLが `/mcp` で終わっていることを確認してください。セルフホストの場合、`SERVER_URL` の設定には公開URLを指定する必要があります。 |
| ツールから権限エラーが返される | キーのロールにPeopleの読み取りまたは作成権限がありません。**Settings** → **Members** → **Roles** でロールを編集してください。                           |
| 登録済みの発信者が見つからない | 電話番号を国番号付きの統一された形式で保存してください。                                                                                    |
| 用件が空になっている      | `Call reason` フィールドを追加した後に **Refresh tools** を選択し、変更されたツールで **Update** を選択してください。                               |
| キーを変更した         | インテグレーションを編集し、**Rotate Secret Token (optional)** を使用してください。保存したキーが再表示されることはありません。                               |