> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# モデルコンテキストプロトコル

> **ユーザーの責任**
>
> ElevenLabs会話型エージェントと統合するサードパーティMCPサーバーのセキュリティ、コンプライアンス、動作については、
> ユーザーが責任を負います。ElevenLabsは統合のためのプラットフォームを提供しますが、外部MCPサーバーの管理、推奨、
> セキュリティ確保は行いません。

## 概要

> **Note**
>
> このガイドでは、ElevenLabsエージェントに外部MCPサーバーへのアクセスを付与する方法について説明します。逆に、
> Claudeまたは別のMCPクライアントからElevenLabsエージェントを管理したい場合は、[ホスト型MCPサーバー](/docs/ja/eleven-agents/operate/hosted-mcp)を使用してください。

[モデルコンテキストプロトコル（MCP）](https://modelcontextprotocol.io/)は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供する方法を定義するオープンスタンダードです。MCPは、AIモデルが多様なデータソースやツールとシームレスに連携できるようにするユニバーサルコネクターと考えてください。MCPを実装するサーバーを統合することで、ElevenLabs会話型エージェントの機能を大幅に拡張できます。

> **Warning**
>
> 現在、Zero Retention Modeを利用しているユーザー、またはHIPAAコンプライアンスが必要なユーザーはMCPサポートを利用できません。

ElevenLabsでは、会話型エージェントを外部MCPサーバーに接続できます。これにより、エージェントは次のことが可能になります。

* MCPサーバーを介してさまざまなデータソースの情報にアクセスし、処理する
* MCPサーバーが公開する専門ツールや機能を利用する
* より動的で、知識豊富かつインタラクティブな会話体験を作成する

## ワークスペースでMCPを有効にする

MCPはすべてのワークスペースでデフォルトでは無効になっています。MCPサーバーを追加または使用するには、その前にワークスペースメンバーの1人がワークスペースを代表してオプトインする必要があります。

#### ダッシュボード

[MCPサーバーインテグレーションダッシュボード](https://elevenlabs.io/app/agents/integrations)から誰かが初めてMCPサーバーを追加しようとすると、自動的にオプトインされます。ダイアログでモデルコンテキストプロトコルサーバー利用規約の確認と同意を求められます。同意するとワークスペース全体でMCPが有効になり、ElevenAgentsにアクセスできるすべてのメンバーがMCPサーバーを追加してエージェントに接続できるようになります。

#### API

`can_use_mcp_servers`ワークスペース設定を更新すると、ワークスペースのMCPを直接有効または無効にできます。

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.settings.update(can_use_mcp_servers=True)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.settings.update({ canUseMcpServers: true });
```

`can_use_mcp_servers`を`false`に戻すと、ワークスペースのMCPが無効になります。既存のMCPサーバーインテグレーションは保持されますが、設定を再度有効にするまでエージェントは使用できなくなります。

> **Note**
>
> MCPの有効化はエージェント単位ではなく、ワークスペース全体の設定です。メンバーであれば誰でも、または`convai_write`権限を持つAPIキーであれば、
> 有効／無効を切り替えられます。ワークスペース管理者に限定されません。

ワークスペースでMCPを有効にすると、追加した各MCPサーバーはそれぞれ独自のリソースになります。作成したメンバーは、エージェントやナレッジベースドキュメントを共有する場合と同様に、ほかのワークスペースメンバーと個別に共有できます。

> **Warning**
>
> この設定を有効にしても、上記のZero Retention ModeおよびHIPAAの制限は解除されません。
> Zero Retention ModeまたはHIPAAコンプライアンスが有効なワークスペースでは、`can_use_mcp_servers`設定にかかわらずMCPサーバーを使用できません。

## はじめに

> **Note**
>
> ElevenLabsは、SSE（Server-Sent Events）とHTTPストリーミング可能トランスポートの両方のMCPサーバーをサポートしています。

この例では、ElevenAgentsを数百のツールやサービスに接続できる[Zapier MCP](https://zapier.com/mcp)を使用します。

> **Note**
>
> ElevenLabs CLIではまだMCPサーバーを管理できません。ダッシュボードまたはSDKを使用してください。

#### ダッシュボードから追加

#### MCPインテグレーションを開く

[MCPサーバーインテグレーションダッシュボード](https://elevenlabs.io/app/agents/integrations)に移動し、**カスタムMCPサーバーを追加**をクリックします。

![最初のMCPサーバーを作成](/docs/_fern-img/335d1d8fced3cd82eed4ed43ba0058d3a8dbc431f81cdb387bf3d5964e5ead80.webp)

#### MCPサーバーを設定する

次の詳細を入力します。

* **名前**：MCPサーバーの名前（例：「Zapier MCP Server」）
* **説明**：MCPサーバーで実行できる内容の説明
* **サーバーURL**：MCPサーバーのURL。シークレットキーが含まれている場合は、パスワードと同様に扱い、ワークスペースシークレットとして保存してください。
* **シークレットトークン**（任意）：認可ヘッダーの値
* **HTTPヘッダー**（任意）：サーバーが必要とする追加ヘッダー

#### 接続を保存してテストする

**インテグレーションを追加**をクリックしてインテグレーションを保存し、接続をテストして利用可能なツールを一覧表示します。

![Zapierのツール例](/docs/_fern-img/7c9d83baedd0e2dc74014d4a690159333bbef0eec37c36fa9ee0fd6cd455df0e.webp)

#### サーバーをエージェントに接続する

MCPサーバーをエージェントに追加できるようになりました。MCPサポートはパブリックエージェントとプライベートエージェントの両方で利用できます。

![MCPサーバーをエージェントに追加](/docs/_fern-img/b18756710b4466a5fa462080d6f3b237d84f76f898d5c94d4583f31d2fa0395b.webp)

#### APIから追加

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

server = elevenlabs.conversational_ai.mcp_servers.create(
    config={
        "url": "https://mcp.zapier.com/api/mcp/...",
        "name": "Zapier MCP Server",
        "description": "An MCP server with access to Zapier's tools and services",
        "approval_policy": "always_ask",
        "transport": "SSE",
    },
)

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "agent": {"prompt": {"mcp_server_ids": [server.id]}},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const server = await elevenlabs.conversationalAi.mcpServers.create({
  config: {
    url: "https://mcp.zapier.com/api/mcp/...",
    name: "Zapier MCP Server",
    description: "An MCP server with access to Zapier's tools and services",
    approvalPolicy: "always_ask",
    transport: "SSE",
  },
});

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    agent: { prompt: { mcpServerIds: [server.id] } },
  },
});
```

## ツールの承認モード

ElevenLabsは、エージェントがMCPサーバーのツールを使用する許可をリクエストする方法を管理できる、柔軟な承認コントロールを提供します。最大限のセキュリティ制御のため、MCPサーバーレベルと個々のツールレベルの両方で承認設定を構成できます。

![ツール承認モードの設定](/docs/_fern-img/9f4c208459131622478de5010e2234d3af8a03dc9bc5b7ec2fcab48a7be3bde3.webp)

### 利用可能な承認モード

* **常に確認（推奨）**：最大限のセキュリティ。ツールを使用するたびに、エージェントが許可を求めます。
* **詳細なツール承認**：自動実行できるツールと承認が必要なツールを無効化および事前選択します。
* **承認なし**：アシスタントは承認なしで任意のツールを使用できます。

### 詳細なツール制御

詳細なツール承認モードでは、個々のツールに異なる承認要件を設定できます。どのツールを自動実行し、どのツールに明示的な許可を必要とするかを細かく制御できます。

![詳細なツール承認
設定](/docs/_fern-img/041cad753319ed92189ee8d4f70a9d3ed07177303bf71777ce36a90270a5dd24.webp)

各ツールには、次の設定を指定できます。

* **自動承認**：許可を必要とせずにツールが自動実行されます
* **承認が必要**：ツールの実行前に明示的な許可が必要です
* **無効**：ツールは完全に無効になり、使用できません

> **Tip**
>
> 詳細なツール承認を使用すると、低リスクの読み取り専用ツールは自動実行を許可しつつ、
> データを変更するツールや機密性の高い操作を実行するツールには承認を求めるようにできます。

## ElevenLabs統合における主な考慮事項

* **外部サーバー**：統合する外部MCPサーバーの選択はユーザーの責任です。ElevenLabsは接続手段を提供します。
* **対応機能**：ElevenLabsは、リアルタイムのインタラクションに対応するSSE（Server-Sent Events）およびHTTPストリーミング可能トランスポートで通信するMCPサーバーをサポートしています。
* **動的ツール**：統合されたMCPサーバーから利用できるツールと機能は外部サーバーによって定義され、そのサーバー設定が更新されると変更される可能性があります。

## セキュリティと免責事項

外部MCPサーバーを統合すると、エージェントやデータがサードパーティサービスに公開される可能性があります。セキュリティ上の影響を理解することが非常に重要です。

> **重要な免責事項**
>
> MCPサーバーインテグレーションを有効にすることで、ElevenLabsが管理していないサードパーティサービスとのデータ共有が
> 発生する可能性があることを認識したものとします。これにより、追加のセキュリティリスクが生じる可能性があります。
> 影響を十分に理解し、統合するMCPサーバーのセキュリティを精査したうえで、続行する前に[MCPインテグレーションのセキュリティガイドライン](/docs/ja/eleven-agents/customization/tools/mcp/security)を
> 確認してください。

詳細なベストプラクティスについては、[MCPインテグレーションのセキュリティガイドライン](/docs/ja/eleven-agents/customization/tools/mcp/security)をご覧ください。

## MCPサーバーを探す、または構築する

* 信頼できるプロバイダーが公開しているMCPサーバーを利用する
* 独自データやツールを公開する独自のMCPサーバーを開発する
* モデルコンテキストプロトコルのコミュニティやリソースで、例やサーバー実装を探す

### リソース

* [AnthropicのMCPサーバー例](https://docs.anthropic.com/en/docs/agents-and-tools/remote-mcp-servers#remote-mcp-server-examples) - Anthropicによるサーバー例のリスト
* [Awesome Remote MCP Servers](https://github.com/jaw9c/awesome-remote-mcp-servers) - リモートMCPサーバーの厳選されたオープンソースリスト
* [Remote MCP Server Directory](https://remote-mcp.com/) - Remote MCPサーバーの検索可能なリスト