> 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 服务器是一台远程 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器，可向 AI 助手提供智能体管理工具。连接后，Claude 等助手可通过自然语言创建、配置和管理工作区中的智能体，无需在本地安装或运行任何内容。

服务器地址：

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

身份验证使用 OAuth。连接时，使用 ElevenLabs 账户登录，并授予助手工作区的指定范围访问权限。无需将 API 密钥复制到客户端。

> **Note**
>
> 想让 ElevenLabs 智能体访问外部 MCP 服务器？请参阅 [MCP 集成指南](/docs/zh/eleven-agents/customization/tools/mcp)。

## 从 Claude Desktop 连接

托管 MCP 服务器已发布到 Claude Desktop 目录中。

#### 打开目录

在 Claude Desktop 中，前往 **Settings** > **Connectors**，然后浏览目录。

#### 添加 ElevenLabs 连接器

搜索 **ElevenLabs**，然后选择 **Connect**。

#### 登录

使用 ElevenLabs 账户完成 OAuth 流程。之后 Claude 就能代表你列出、创建和更新工作区中的
智能体。

## 数据驻留区域

Claude 目录中的连接器和默认服务器 URL 会连接到全球环境。如果工作区位于隔离的 [数据驻留](/docs/zh/overview/administration/data-residency) 环境，请添加一个指向所在区域 URL 的自定义连接器：

| 区域  | MCP 服务器 URL                                     |
| --- | ----------------------------------------------- |
| 欧盟  | `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** 中添加连接器。

![Claude 聊天输入菜单，其中突出显示了 Add connector 和 Add custom connector](/docs/_fern-img/1c3f441dcc1e77404715e95da3f290f61f913b65b8e3636e404b71b1f4da3797.webp)

#### 输入名称和区域 URL

为连接器命名以便明确区域，例如“ElevenLabs EU”，然后输入所在区域的
MCP 服务器 URL。选择 **Continue**。

![Add custom connector 对话框，已填入名称 ElevenLabs EU 和欧盟服务器 URL](/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/zh/eleven-agents/operate/architect/external-assistants) 更改那样暂存在草稿中。

## 示例提示词

连接后，可以尝试以下提示词：

* “为我的文档网站创建一个支持智能体。它应友好、简洁，并将账单问题升级处理。”
* “与 GPT-4o 相比，使用 Gemini 2.5 Flash 时，我的结账智能体每次对话的成本是多少？”
* “复制我的生产智能体，然后更改音色，并将首条消息设为西班牙语。”
* “列出我的智能体，并告诉我哪些仍在使用默认首条消息。”
* “生成一段我的智能体音色说出我们新问候语的示例。”

## 权限

连接的助手可执行哪些操作由两层机制控制：连接时授予 ElevenLabs 的权限，以及 MCP 客户端中的工具控制设置。

### ElevenLabs 权限

连接时，OAuth 同意授权页面会列出助手请求的权限，例如读取和写入智能体。助手只能执行你批准权限涵盖的操作，且访问范围仅限于登录时选择的工作区。可随时在 MCP 客户端或 ElevenLabs 账户设置中撤销连接。

### MCP 客户端中的工具控制

Claude 等 MCP 客户端允许选择助手可使用哪些连接器工具，以及哪些工具每次调用前需要批准。在 Claude 中，打开 ElevenLabs 连接器的设置，即可启用或禁用单个工具，并设置工具是自动运行还是先请求确认。

这些控制在两个层级生效。工作区管理员可为组织中的所有人配置连接器及其工具，个人用户则可为自己应用更严格的设置。管理员禁用的工具无法由个人用户重新启用。

## 安全

* 访问权限由 OAuth 控制，涵盖 ElevenAgents 的读取和写入操作以及文本转语音。
* 删除智能体是破坏性操作。批准前请在 MCP 客户端中检查工具调用，并仅向需要此权限的工作区成员授予写入权限。

## 相关资源

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

使用版本控制和 CI/CD，以代码方式管理智能体。

#### [智能体技能](https://github.com/elevenlabs/skills/tree/main/agents)

通过 skills 仓库为编程智能体提供更深入的 ElevenLabs 工作流程。

#### [API 参考文档](/docs/zh/api-reference/introduction)

用于以编程方式控制平台的完整 REST API。