> 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.

# ホスト型MCPサーバー

## 概要

ElevenLabsホスト型MCPサーバーは、AIアシスタントにエージェント管理ツールを提供するリモート[Model Context Protocol（MCP）](https://modelcontextprotocol.io/)サーバーです。接続すると、Claudeなどのアシスタントが自然言語を通じてワークスペース内のエージェントを作成、設定、管理できます。ローカルでインストールや実行を行う必要はありません。

サーバーは次のURLで利用できます。

```
https://api.elevenlabs.io/v1/mcp
```

認証にはOAuthを使用します。接続時にElevenLabsアカウントでサインインし、アシスタントにワークスペースへのスコープ付きアクセスを許可します。APIキーをクライアントにコピーする必要はありません。

> **Note**
>
> 代わりにElevenLabsエージェントから外部MCPサーバーへアクセスさせたい場合は、[MCP インテグレーションガイド](/docs/ja/eleven-agents/customization/tools/mcp)をご覧ください。

## Claude Desktopから接続する

ホスト型MCPサーバーはClaude Desktopのディレクトリに公開されています。

#### ディレクトリを開く

Claude Desktopで、**Settings** > **Connectors** に移動し、ディレクトリを参照します。

#### ElevenLabsコネクターを追加する

**ElevenLabs** を検索し、**Connect** を選択します。

#### サインインする

ElevenLabsアカウントでOAuthフローを完了します。その後、Claudeは代理でワークスペース内の
エージェントを一覧表示、作成、更新できるようになります。

## データレジデンシーリージョン

ClaudeディレクトリのコネクターとデフォルトのサーバーURLはグローバル環境に接続します。ワークスペースが分離された[データレジデンシー](/docs/ja/overview/administration/data-residency)環境にある場合は、リージョンのURLを指定するカスタムコネクターを追加してください。

| リージョン  | MCPサーバーURL                                      |
| ------ | ----------------------------------------------- |
| EU     | `https://api.eu.residency.elevenlabs.io/v1/mcp` |
| インド    | `https://api.in.residency.elevenlabs.io/v1/mcp` |
| シンガポール | `https://api.sg.residency.elevenlabs.io/v1/mcp` |

> **Warning**
>
> 分離環境は、それぞれ別のアカウントを持つ独立したワークスペースです。OAuthフローが開始したら、
> elevenlabs.ioアカウントではなく、その環境用のアカウントでサインインしてください。

### Claudeでカスタムコネクターを追加する

#### コネクターメニューを開く

新しいチャットで **+** ボタンを選択し、**Add connector** > **Add custom connector** を選択します。
**Settings** > **Connectors** からコネクターを追加することもできます。

![Add connectorとAdd custom connectorが強調表示されたClaudeのチャット入力メニュー](/docs/_fern-img/1c3f441dcc1e77404715e95da3f290f61f913b65b8e3636e404b71b1f4da3797.webp)

#### 名前とリージョンのURLを入力する

「ElevenLabs EU」のようにリージョンが分かる名前をコネクターに付け、リージョンのMCPサーバーURLを入力します。
**Continue** を選択します。

![名前にElevenLabs EU、URLにEUサーバーURLが入力されたAdd custom connectorダイアログ](/docs/_fern-img/a1f5f6c459eafc68ce220f1e4d6dd1402e5e78f0d7abb87a41d1800ba6e4c355.webp)

#### 検出された設定をそのまま使用する

Claudeがサーバー設定を自動検出します。認証は **Always
required** に設定され、OAuthクライアントには **Anthropic's hosted client metadata** が使用されます。
両方とも検出された設定のままにして、**Add** を選択します。

![Always requiredとホスト型クライアントメタデータが検出されたコネクター認証設定](/docs/_fern-img/5f5b5941ec2d311769570cb194bbd70dc347db5bde46c812f94bae7da1c25c47.webp)

#### サインインして認可する

その環境用のアカウントでOAuthフローを完了します。ワークスペースを選択し、要求された権限を確認して、
**Authorize** を選択します。

![ワークスペース選択と要求された権限が表示されたElevenLabsの同意画面](/docs/_fern-img/550401ee663f8b123ad61feffcc8cd6767f3f8f665419bf0a0b5cf999a6688ec.webp)

> **Note**
>
> 他のMCPクライアントでも手順は同じです。クライアントにリージョンのサーバーURLを指定し、OAuthフローを完了します。
> ホスト型クライアントメタデータ（CIMD）をサポートするクライアントでは、クライアント登録は不要です。

## できること

接続後、アシスタントで次のことができます。

* 必要な内容を説明して新しいエージェントを作成する
* システムプロンプト、音声、言語、最初のメッセージを含む、あらゆるエージェント設定を更新する
* エージェントを一覧表示し、設定を確認または比較する
* エージェントの最近の会話を確認し、完全な文字起こしを読み、それらを横断して検索する
* エージェントの会話で扱われているトピックを調べる
* 手順、ツール、MCPサーバー、ナレッジベースのドキュメントを管理する
* テストを作成、実行、確認する
* ブランチ、下書き、トラフィックデプロイメント、マージ提案を操作する
* トリアージチケットを読み取り、更新する
* エージェントを複製、削除する
* 変更前にエージェントで想定されるLLM使用量とコストを見積もる
* エージェントのウィジェット設定と共有可能なリンクを取得する
* テキストから音声オーディオを生成し、短期間有効なダウンロードリンクとして受け取る

> **Warning**
>
> MCPサーバー経由でエージェントを更新すると、変更はアシスタントが対象にしたブランチ、またはデフォルトでは
> `main` に直接公開されます。アプリ内の[ElevenAgents Architect](/docs/ja/eleven-agents/operate/architect/external-assistants)による変更のように、
> 下書きとしてステージングされることはありません。

## プロンプト例

接続後、次のようなプロンプトを試してください。

* 「ドキュメントサイト用のサポートエージェントを作成して。親しみやすく簡潔にし、請求に関する質問はエスカレーションするようにして。」
* 「チェックアウトエージェントでGPT-4oの代わりにGemini 2.5 Flashを使うと、会話あたりのコストはいくらになりそう？」
* 「本番エージェントを複製してから、音声を変更し、最初のメッセージをスペイン語に設定して。」
* 「エージェントを一覧表示して、デフォルトの最初のメッセージをまだ使っているものを教えて。」
* 「新しい挨拶を話すエージェントの音声サンプルを生成して。」

## 権限

接続されたアシスタントにできることは、接続時にElevenLabsへ付与する権限と、MCPクライアントのツールコントロールという2つのレイヤーで制御されます。

### ElevenLabsの権限

接続時に、OAuth同意画面にエージェントの読み取りや書き込みなど、アシスタントが要求している権限が表示されます。アシスタントが実行できるのは承認した権限で許可された操作のみで、アクセスはサインインしたワークスペースに限定されます。接続はいつでもMCPクライアントまたはElevenLabsアカウント設定から取り消せます。

### MCPクライアントのツールコントロール

ClaudeなどのMCPクライアントでは、アシスタントが使用できるコネクターのツールと、呼び出しごとに承認を必要とするツールを選択できます。Claudeでは、ElevenLabsコネクターの設定を開くと、個々のツールを有効または無効にしたり、ツールを自動実行するか先に確認を求めるかを設定したりできます。

これらのコントロールは2つのレベルで機能します。ワークスペース管理者は組織内の全員に対してコネクターとそのツールを設定でき、個々のユーザーは自身に対してより厳格な設定を適用できます。管理者が無効にしたツールを個々のユーザーが再度有効にすることはできません。

## セキュリティ

* アクセスは、ElevenAgentsの読み取り・書き込み操作とテキスト読み上げを対象とするOAuth権限でスコープされます。
* エージェントの削除は元に戻せません。承認前にMCPクライアントでツール呼び出しを確認し、書き込みアクセスは必要なワークスペースメンバーだけに制限してください。

## 関連リソース

#### [ElevenLabs CLI](/docs/ja/eleven-agents/operate/cli)

バージョン管理とCI/CDを使用して、エージェントをコードとして管理します。

#### [Agentsスキル](https://github.com/elevenlabs/skills/tree/main/agents)

スキルリポジトリを通じて、コーディングエージェントにより高度なElevenLabsワークフローを提供します。

#### [APIリファレンス](/docs/ja/api-reference/introduction)

プラットフォームをプログラムで制御するための完全なREST APIです。