3行でいうと
- 公式のホスト版MCPサーバーの接続先は
https://api.elevenlabs.io/v1/mcpで、OAuthで許可します。公式は、APIキーをクライアントにコピーする必要はないと書いています。範囲はElevenAgentsの読み書きとText to Speechです。 - Claudeでは、公式のdocsが「Settings → Connectors」のディレクトリから「Connect」を押す方法と、「Add custom connector」でURLを入れる方法を書いています。公式の
elevenlabs.io/mcpのページは、「Customize → Connectors」で、名前「ElevenLabs」のカスタムコネクタを足す方法と「Add to Claude」ボタンを書いています。表記の違いは併記します。 - Claude Codeは、
claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcpを実行し、セッションの中で/mcpを実行してサインインします(公式のelevenlabs.io/mcpのページの記載)。 - ホスト版MCPの更新は、下書きを経ずに、対象のブランチ(初期は
main)へ直接公開されます。エージェントの削除は破壊的、と公式が書いています。 - 古いローカルMCPは、公式が非推奨と書き、リポジトリは2026年8月20日にアーカイブされています。設定には
ELEVENLABS_API_KEYを書く形でした。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。
手順は「公式の手順を順に並べたもの」です。コマンドと設定のうち、公式のページに書かれていたものは「公式の例の写し」と書きます。システムへ権限やキーを登録する操作は、原文を公式ページで見て写してください。公式に書かれていない画面の経路やボタンの表記は、書かずに「公式で確認できていない」と書きます。画面の表記は変わるので、手元の画面と照らして読んでください。
先に結論
- まず、どの経路を使うかを決める。 OAuthでつなぐホスト版MCP(公式の現行の方法)、ターミナルのCLIとskills(AIコーディングツール向け)、古いローカルMCP(非推奨)の3つがあります。
- ホスト版MCPは、書き込みができる。 公式は、ツールの呼び出しを承認の前に確かめること、書き込み権限は必要な人だけにすることを書いています。
- 権限は、同意画面と、Claude側のツールごとの設定の2段で絞れる。 同意画面に要求される権限が出る、と公式に書かれています。Claudeでは、ツールごとに有効・無効と、自動実行か確認を求めるかを決められます。
- 外し方は、2か所に書かれている。 公式は、アクセスはMCPクライアント、またはElevenLabsのアカウント設定から取り消せると書いています。アカウント設定のどの画面かは、読んだページには書かれていませんでした。
- ElevenLabsの中での注意。 「MCPは、Zero Retention ModeやHIPAAを必要とするワークスペースでは使えない」という記述は、エージェントが外のMCPサーバーを使う側の公式のMCPの資料(08で扱うページ)にあります。ホスト版MCPのページには、この件の記載がありません。ホスト版に当てはまるかどうかは、公式で確認できていません(08、04)。
前提:用語をそろえる
- MCP:AIアシスタントが外のツールを使うための共通の取り決め。遠隔のサーバーにつなぐ型と、手元で動かす型があります。
- ホスト版MCPサーバー:ElevenLabsが運営する、遠隔のMCPサーバー。手元にインストールするものはありません。
- コネクタ/カスタムコネクタ:Claudeなどが外のサービスにつながる入口。ディレクトリにあるものを選ぶ方法と、URLを自分で入れる「カスタム」の方法があります。
- OAuth:パスワードやAPIキーを渡さずに、ブラウザで「この範囲を許可します」と承認する方式。
- CIMD:公式のページが「hosted client metadata」と書く、クライアントの登録を省ける仕組みです。対応するクライアントは、登録の手続きが要らない、と書かれています。
- ブランチ(branch)/下書き(draft)/デプロイ:ElevenAgentsで、エージェントの変更を分けて管理する仕組み。公式の説明では、MCP経由の更新は、下書きにならず、対象のブランチに直接出ます。
- skills:AIコーディングツールに、ElevenLabsの使い方の手順書を足す仕組み。公式のページは、
npx skills add elevenlabs/skillsと書いています。 - データレジデンシー:データを置く地域を決めること。公式のMCPの資料は、EU、インド、シンガポールの専用URLを挙げています。
たとえ話:事務所の鍵と、鍵の種類
ElevenLabsのワークスペースを事務所だと考えてみます。ホスト版MCPは、本人が受付で「この部屋だけ」と許可を出して、AIにカードキーを渡す方式で、いつでも取り消せます。古いローカルMCPは、事務所の合鍵(APIキー)そのものを、AIの設定ファイルにしまう方式です。どちらも、渡した範囲のことはAIが実行できます。これは僕らのたとえで、公式の表現ではありません。
経路の一覧
| 経路 | 公式の位置づけ | 認証 | この記事の節 |
|---|---|---|---|
| ホスト版MCP × Claude(Desktop、Web) | 現行 | OAuth | 連携1 |
| ホスト版MCP × Claude Code | 現行 | OAuth(/mcpでサインイン) |
連携2 |
| ホスト版MCP × ChatGPT、Cursor、GrokBot、Hermes | 現行(elevenlabs.io/mcp の記載) |
OAuth | 連携3 |
| CLI+skills × AIコーディングツール | 現行(elevenlabs.io/mcp、CLIのページの記載) |
OAuth(auth login)またはAPIキー |
連携4 |
| ローカルMCP × Claude Desktop | 非推奨(2026-08-20にアーカイブ) | APIキー | 連携5 |
連携1:ホスト版MCP × Claude(Desktop、Web)
渡るもの・できること
公式のdocs(Hosted MCP server)の記載です。
- 接続先:
https://api.elevenlabs.io/v1/mcp(グローバル)。 - 範囲:ElevenAgentsの読み書きと、Text to Speech。サインインしたワークスペースの範囲に限られる、と書かれています。
- できること:エージェントの作成、複製、更新、一覧、削除、設定の比較。システムプロンプト、声、言語、最初のメッセージの更新。会話、書き起こし、トピックの確認と検索。手順(procedures)、ツール、MCPサーバー、Knowledge Baseの管理。テストの作成と実行。ブランチ、下書き、トラフィックのデプロイ、マージの提案。トリアージのチケットの閲覧と更新。変更の前のLLMの使用量と費用の見積もり。ウィジェットの設定と共有リンクの取得。テキストからの音声の生成(短時間だけ有効なダウンロードリンクで返る)。
elevenlabs.io/mcpのページは、ElevenCreative(音声、音楽、効果音、画像、動画の生成。「50以上のモデル」)も同じコネクタで使える、と書いています。一方でページの説明文には「creative tools coming soon」とあり、この食い違いは、ページに説明がありませんでした。docsが挙げる範囲は、上のとおりElevenAgentsの読み書きとText to Speechです。
手順A:Claude Desktopのディレクトリから(公式のdocsの記載)
- 「Settings」→「Connectors」を開き、ディレクトリを見る。
- 「ElevenLabs」を検索して、「Connect」を選ぶ。
- ElevenLabsのアカウントで、OAuthのサインインを済ませる。
手順B:カスタムコネクタで(公式のdocsの記載。リージョンごとのURL向けの手順)
- 新しいチャットで「+」→「Add connector」→「Add custom connector」。または「Settings」→「Connectors」。
- 名前をつける(地域がわかる名前、例「ElevenLabs EU」)。URLを入れて「Continue」。
- 検出された設定をそのままにする(認証は「Always required」、Anthropicのhosted client metadata)。「Add」を押す。
- サインインし、ワークスペースを選び、権限を確かめて「Authorize」を押す。
手順C:公式の elevenlabs.io/mcp のページの記載
- 「Customize → Connectors」で、名前を「ElevenLabs」としてカスタムコネクタを足し、
https://api.elevenlabs.io/v1/mcpを貼る。 - ページの「Add to Claude」ボタンで、この値が入った状態から始められる、と書かれています。
- 手順A・Bと、画面の呼び方(「Settings」と「Customize」)が違います。どちらかに決めつけず、手元のClaudeの画面で確かめてください。
地域ごとのURL(公式のdocsの表)
| 地域 | URL |
|---|---|
| グローバル(初期、ディレクトリのコネクタ) | https://api.elevenlabs.io/v1/mcp |
| 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 |
隔離された環境(isolated environment)のワークスペースは、別のアカウントで、その地域のURLのカスタムコネクタが必要、と書かれています。elevenlabs.ioのアカウントではサインインできません。
権限と制御
- 同意画面に、要求される権限(たとえばエージェントの読み書き)が並ぶ、と書かれています。
- Claudeの、コネクタの設定で、ツールを1つずつ有効・無効にでき、それぞれを「自動実行」か「確認を求める」かに決められる、と書かれています。
- ワークスペースの管理者は、組織全体のコネクタを設定できます。個人は、より厳しい設定にできますが、管理者が無効にしたツールを、個人が有効にすることはできない、と書かれています。
外し方
- 公式は「MCPクライアントか、ElevenLabsのアカウント設定から、アクセスを取り消せる」と書いています。
- Claude側の削除の画面は、公式のページに書かれていませんでした。ElevenLabs側のアカウント設定の、どの画面かも、読んだページには書かれていません(「記載が見つからない」)。
うまくいかないときの確認点
| 症状 | 確認すること |
|---|---|
| EUなどの地域で入れない | 隔離された環境は、専用のURLと、その環境のアカウントが要る(公式のdocs) |
| 一覧に出てくる機能が、自分のアシスタントで足りない | 公式の elevenlabs.io/mcp は、ElevenCreativeが「Claude、ChatGPT、Cursorで使える」と書き、ロゴの列に載るほかのアシスタント(Claude Code、GrokBot、Hermes、Codex、OpenClaw)ごとの対応は書いていない。手元の画面の一覧で確かめる |
| ワークスペースで使えない | 「MCPはZero Retention ModeとHIPAAでは使えない」という記述は、外のMCPサーバーを使う側の資料(08)にある。ホスト版のページには記載がなく、当てはまるかは公式で確認できていない |
| ツールが使えない | 管理者が無効にしたツールは、個人が有効にできない(公式のdocs) |
変更が直接公開される点
公式のdocsは、MCP経由の更新は、対象のブランチ(初期は main)へ直接公開され、下書きにはならない、と書いています。ElevenAgents Architectで行う変更とは違う、とも書かれています。AIに「エージェントを直して」と頼む前に、どのブランチを対象にするかを決めておく、というのは、この記事の見立てです。
渡るデータ
AIアシスタントの要求は、許可した範囲で、ElevenLabsのAPIに送られます。会話の書き起こしを、アシスタントが読めます(公式の機能の列挙に「会話、書き起こしの確認と検索」がある)。つまり、書き起こしの内容が、Claudeなどのアシスタント側にも渡ります。そこでの扱いは、アシスタント側の規約に関わります(03)。
連携2:ホスト版MCP × Claude Code
公式の elevenlabs.io/mcp のページの記載です(公式の例の写し)。
claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
- ターミナルで、上のコマンドを実行する。
- Claude Codeのセッションの中で
/mcpを実行し、ElevenLabsにサインインする(ブラウザでOAuth)。
公式のdocs(Hosted MCP server)のほうには、Claude Code、ChatGPT、Cursor、Codexの設定の手順、コマンド、設定ファイルは書かれていませんでした。上のコマンドは elevenlabs.io/mcp のページの記載です。
外し方は、Claude Code側の mcp のコマンドの記載が、読んだページにはありません(「記載が見つからない」)。ElevenLabs側は、連携1と同じく、アカウント設定から取り消せる、と書かれています。
連携3:ChatGPT、Cursor、GrokBot、Hermes、Codex、OpenClaw
公式の elevenlabs.io/mcp のページの記載です。
| アシスタント | 公式の記載 |
|---|---|
| ChatGPT | ChatGPTのプラグインのディレクトリから、1クリックで入れて、ElevenLabsのアカウントでサインインする(ページにディレクトリへのリンクあり) |
| Cursor | Cursorのプラグインのディレクトリから、1クリックで入れる(リンクあり) |
| GrokBot | GrokBotのプラグインのディレクトリから入れる(リンクあり) |
| Hermes | hermes mcp add elevenlabs --url https://api.us.elevenlabs.io/v1/mcp --auth oauth を実行。ブラウザが開き、ワークスペースを許可する(公式の例の写し) |
| Codex、OpenClaw | 対応として挙がっているが、設定の手順は書かれていない |
- Hermesの例のURLは
api.us.elevenlabs.ioで、連携1のapi.elevenlabs.ioとホスト名が違います。ページの説明はありません。原文を見て、そのまま写してください。 - ChatGPTとCursorの、画面の操作の細かい順序は、読んだページには書かれていません。
- 外し方は、これらのアシスタント側の記載が、読んだページにはありません。
連携4:CLI+skills × AIコーディングツール
公式の elevenlabs.io/mcp のページと、CLIのページの記載です。
4-1 AIに渡す手順(公式のページが示す例)
npm i -g @elevenlabs/cli
elevenlabs auth login
npx skills add elevenlabs/skills
公式のページは、自分のエージェント(AIコーディングツール)にこの手順を送る、と案内しています。
4-2 onboard init(APIのクイックスタートの記載)
APIのクイックスタートは、コーディングエージェントに、次のように頼む方法を書いています(公式の例の写し)。
Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.
- ブラウザが1度開き、サインインか登録のあと、「Authorize」を押す、と書かれています。
- キーは
.env.local(Pythonのプロジェクトでは.env)に保存され、gitには入れない形になる、と書かれています。 - エージェントが、SDKを入れ、アプリにコードを足し、テストのリクエストを送るか尋ねる、と書かれています。
- ブラウザに届かない環境では、自分でキーを作って、環境のファイルに貼る、と書かれています。
4-3 generate-skills
elevenlabs generate-skills [--output-dir <dir>] は、コマンドのグループごとに SKILL.md を、初期は skills/ に書き出します。APIキーは要らず、オフラインで動き、入れているCLIの版に合う、と書かれています。
4-4 CLIの認証
05の手順6-1のとおりです。OSのキーリング、auth status、auth logout、CIでの ELEVENLABS_API_KEY が書かれています。
4-5 エージェントをファイルで管理する
CLIのページは、elevenlabs agents init で作るプロジェクトの構造を、agents.json、tools.json、tests.json、agent_configs/、tool_configs/、test_configs/ と書いています。エージェントの設定のJSONは、name、conversation_config(agent、tts、asr、conversationの節)、platform_settings、tags を含む、と書かれています。agents push --dry-run で先に確かめ、agents push で反映し、agents status で状態を見る流れが、GitHub Actionsの例として書かれています。
ホスト版MCPは会話での管理に向き、CLIはバージョン管理されたエージェントに向く、という趣旨の記述は、CLIのページの要約では確認できていません(公式で確認できていない点です)。
渡るデータ・外し方・確認点
- 渡るデータ:CLIの操作は、ElevenLabsのAPIに送られます。AIコーディングツールに渡した手順や、
skills/の内容は、そのツール側の扱いになります。 - 外し方:
elevenlabs auth logoutで、保存した資格情報を消せる、と書かれています。ツール側のskillsの削除は、読んだページには書かれていません。 - 確認点:CLIの要件(Node.js)は、ページによって書かれ方が違います(05)。
npxが動かなければ、HomebrewかScoopで入れます。
連携5:旧ローカルMCP × Claude Desktop(非推奨)
公式のGitHub、elevenlabs/elevenlabs-mcp のREADMEの記載です。READMEは、「このローカルMCPサーバーは、ElevenLabsのホスト版に置き換えられて、非推奨」と書き、リポジトリは2026年8月20日にアーカイブされて読み取り専用で、もう保守されていない、と書かれています。使うかどうかは、読む人の判断です。
設定(READMEの記載)
- ElevenLabsのAPIキーを用意する。
uv(Pythonのパッケージ管理)を入れる。READMEのコマンドは、curl -LsSf https://astral.sh/uv/install.sh | shです。- Claudeの「Settings」→「Developer」→「Edit Config」から
claude_desktop_config.jsonを開き、設定を書く。Windowsでは、先に「Help」→「Enable Developer Mode」。
READMEの設定例(公式の例の写し):
{
"mcpServers": {
"ElevenLabs": {
"command": "uvx",
"args": ["elevenlabs-mcp"],
"env": {
"ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
}
}
}
}
環境変数(READMEの記載)
| 変数 | 内容 |
|---|---|
ELEVENLABS_API_KEY |
APIキー |
ELEVENLABS_MCP_BASE_PATH |
ファイル操作の基点。初期は ~/Desktop。入力ファイルもこの範囲だけ読める。範囲外のパスは拒否される |
ELEVENLABS_MCP_OUTPUT_MODE |
files(初期、ディスクに保存)、resources(MCPのリソースで返す。バイナリはbase64)、both |
ELEVENLABS_API_RESIDENCY |
データの地域。初期は us。Enterpriseだけの機能 |
渡るデータ・権限・外し方
- 渡るデータ:手元のPCで動き、APIキーでElevenLabsに送ります。入力ファイルは、基点のフォルダの中だけ読めます。
- 権限:APIキーが持つ権限です。キーに制限(スコープ、クレジットの上限、IPの許可リスト)をかけられることは、05に書きました。ローカルMCPにそのキーを使うときの扱いは、READMEには書かれていません。
- 外し方:READMEには、設定の外し方の記載がありません。設定ファイルから
ElevenLabsの項目を消す、というのは、設定の形から推測した、この記事の見立てです。APIキー自体の削除は、ElevenLabs側のAPIキーの画面で行う形になります(05の更新と削除の記載)。
確認点(READMEの記載)
| 症状 | READMEの記載 |
|---|---|
MCP ElevenLabs: spawn uvx ENOENT |
which uvx で絶対のパスを調べ(例 /usr/local/bin/uvx)、設定の "command" にそのパスを入れる |
| 声の設計や音声の分離でタイムアウト | MCPインスペクタ(開発用)で出ることがある。ClaudeなどのクライアントではおきないはずとREADMEに書かれている |
| ログの場所 | macOS:~/Library/Logs/Claude/mcp-server-elevenlabs.log。Windows:%APPDATA%\Claude\logs\mcp-server-elevenlabs.log |
READMEには、ツールの一覧は書かれていませんでした(例の指示文の記載のみ)。
渡るデータの比較
| 経路 | データの流れ(公式の記載) |
|---|---|
| ホスト版MCP | アシスタントの要求が、許可した権限の範囲でElevenLabsに届く。書き起こしを読める。音声は、短時間のリンクで返る |
| CLI+skills | CLIの操作はElevenLabsのAPIへ。AIコーディングツールには、手順書とコマンドの出力が渡る |
| ローカルMCP(非推奨) | 手元のPCから、APIキーでElevenLabsへ。入力ファイルは、基点のフォルダの中だけ |
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式のdocs、
elevenlabs.io/mcp、GitHubのREADMEを、要約の形で読んだ範囲です。要約で読んだため、JSONや引数の記号が崩れていないか、公式ページの原文で確かめてから設定してください。 - 読めなかった、または書かれていなかった所:Claude Code、ChatGPT、Cursor、Codexのdocs側の設定手順、アカウント設定のどの画面でアクセスを取り消すか、skillsの外し方、
elevenlabs.io/mcpのページの「Is it secure?」の答え。 - ホスト版MCPは、書き込みができて、更新が直接公開されます。公式が勧める、承認の前に呼び出しを確かめること、書き込み権限を必要な人に限ることは、公式の記載です。
- 公式の資料の中で、対応するアシスタントの一覧、Claudeの画面の呼び名(「Settings」と「Customize」)、Creative機能の提供状況が、ページによって違います。手元の画面と、公式のページの両方で確かめてください。
- 読み込んだ書き起こしに指示のような文が混ざっていても、AIがそれに従ってしまう問題(プロンプトインジェクション)は、外の内容を読むAIの全般の注意です。ElevenLabsのMCPの資料に、この件の記載があるかは、読んだ範囲では確認できていません。
- ElevenLabsの音声エージェントから、外のMCPサーバーやほかのLLMを呼ぶ設定は、その2(08)です。
出典
- Hosted MCP server(ElevenLabs Docs、ElevenLabs、確認日 2026-10-25)
- ElevenLabs Agents & Creative MCP(ElevenLabs、確認日 2026-10-25)
- ElevenLabs CLI(ElevenLabs Docs、ElevenLabs、確認日 2026-10-25)
- ElevenAPI quickstart(ElevenLabs Docs、ElevenLabs、確認日 2026-10-25)
- elevenlabs-mcp(GitHub、ElevenLabs、確認日 2026-10-25)
- Model Context Protocol(ElevenLabs Docs、ElevenLabs、確認日 2026-10-25)
- API Keys(ElevenLabs Docs、ElevenLabs、確認日 2026-10-25)