> 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 服务器是一个远程 [模型上下文协议（MCP）](https://modelcontextprotocol.io/)服务器，可让 AI 助手访问 ElevenLabs 工作区。连接后，Claude、ChatGPT 或 Cursor 等助手可通过自然语言生成语音、图像、视频和音频，设计音色，构建 [Flows](/docs/zh/eleven-creative/products/flows)，以及管理智能体，无需在本地安装或运行任何内容。

服务器地址：

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

身份验证使用 OAuth。连接时，需登录 ElevenLabs 账户，选择工作区并批准助手请求的权限。无需将 API 密钥复制到客户端，生成内容将使用所登录工作区的额度。

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

## 用途

如果想通过已在使用的助手来使用 ElevenLabs，而非切换到 ElevenLabs 应用或针对 API 编写代码，可使用 MCP 服务器。它适用于两类工作：

* **创意工作**：在对话中生成旁白配音、图像、视频、音效和音乐，并通过多轮对话进行优化。
* **智能体工作**：创建、配置、测试和审查 [ElevenAgents](/docs/zh/eleven-agents/overview) 智能体。

如需将 ElevenLabs 集成到自己的应用中，请改用 [API](/docs/zh/api-reference/introduction) 和 [SDK](/docs/zh/eleven-api/resources/libraries)。

## 通过 Claude 连接

将服务器添加为自定义连接器，即可让 Claude 使用服务器提供的所有工具。

#### 打开连接器菜单

在 Claude 中，前往 **设置** > **连接器**，然后选择 **添加自定义连接器**。也可以在新聊天中
选择 **+** 按钮，然后依次选择 **添加连接器** > **添加自定义连接器**。

#### 输入服务器 URL

将连接器命名为“ElevenLabs”，并输入 `https://api.elevenlabs.io/v1/mcp`。选择 **添加**。

#### 登录并授权

使用 ElevenLabs 账户完成 OAuth 流程。选择工作区，查看所请求的
权限，然后选择 **授权**。

> **Warning**
>
> Claude 连接器目录中列出的 ElevenLabs 连接器为受限版本。它
> 支持语音、音色、转录和智能体，但无法生成图像、视频或音乐。如需使用完整工具集，请添加
> 上述自定义连接器。

其他 MCP 客户端的使用方式相同：将客户端指向服务器 URL，然后完成 OAuth 流程。支持托管客户端元数据（CIMD）的客户端无需注册。如果工作区位于隔离的数据驻留环境中，请使用所在区域的 URL，详见 [数据驻留区域](/docs/zh/eleven-agents/operate/hosted-mcp#data-residency-regions)。

## 创意工具

每次创意生成都会保存到一个 [Flow](/docs/zh/eleven-creative/products/flows)：这是一个可编辑画布，用于保存提示词、参考资料和结果。助手会返回该 Flow 的链接，以便在 ElevenLabs 应用中打开它，查看结果、调整节点或再次运行。支持 MCP Apps 的客户端（例如 Claude）还会在聊天中内联显示 Flow 及其结果。

通过创意工具，助手可以：

* 生成图像和视频，并编辑现有图像
* 使用工作区中的任意音色从文本生成语音，并转录音频
* 通过 Flow 节点生成音效、音乐和其他音频
* 根据描述设计新音色，并保存选中的音色
* 在同一 Flow 中串联多次生成，例如为视频添加旁白配音，或根据生成的语音制作口型同步
* 将电脑上传的文件或从 URL 获取的文件用作参考资料
* 管理品牌套件，让生成内容遵循品牌的颜色、字体和徽标
* 查询可用模型、其参数和提示词指南

图像和视频生成默认会返回多个变体，语音则返回 2 个版本。告诉助手要使用哪个变体，它会将其用于下一步。

> **Note**
>
> 生成内容的额度消耗方式与在 ElevenLabs 应用中生成相同。请避免让助手重试仍在运行的
> 生成任务，因为每次重试都会启动并计费一次新的生成任务。

### 提示词示例

* “生成一张产品图：大理石台面上的陶瓷咖啡杯，晨光，16:9。”
* “将第 2 张图像转换成一段 5 秒视频，缓慢推进镜头。”
* “为这段视频写一段 20 秒的温暖英式旁白配音，并添加到同一个 Flow。”
* “为一位粗犷的老船长设计音色，让我试听 3 个预览。”
* “转录附上的采访并列出发言者。”

## 智能体工具

智能体工具可创建、配置和管理工作区中的智能体。涵盖智能体设置、对话和转录文本、流程、工具、知识库文档、测试、分支、部署和问题。完整工具列表、提示词示例及智能体更新行为，请参阅 [ElevenAgents 托管 MCP](/docs/zh/eleven-agents/operate/hosted-mcp)。

## 生成的文件

服务器会将生成的文件以 `elevenlabsusercontent.com` 链接形式返回，该域名是 ElevenLabs 的用户内容域名。ElevenLabs 通过独立域名提供用户内容，因此工作区中的文件无法读取或设置 `elevenlabs.io` 的 Cookie。

这些链接已签名，会在助手收到后约 2 小时过期。要获取新链接，可让助手再次获取生成内容，或在 ElevenLabs 应用中打开 Flow。如果网络或 MCP 客户端限制可加载媒体的域名，请允许 `elevenlabsusercontent.com`。

## 权限

OAuth 同意页面会列出助手请求的权限，例如 ElevenAgents、文本转语音、Flows 以及图像和视频生成。助手只能执行你批准的权限范围内，以及工作区角色允许的操作。可随时通过 MCP 客户端或 ElevenLabs 账户设置撤销连接。

Claude 等 MCP 客户端还允许选择助手可使用的连接器工具，以及每次调用前需要你批准的工具。工作区管理员可为整个组织配置这些控制项。

## 相关资源

#### [ElevenAgents 托管 MCP](/docs/zh/eleven-agents/operate/hosted-mcp)

智能体工具、数据驻留 URL 和智能体权限。

#### [Flows](/docs/zh/eleven-creative/products/flows)

每次创意生成都会保存到这个画布。

#### [智能体工具](/docs/zh/eleven-api/resources/agent-tooling)

面向编程助手的智能体技能和其他工具。

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

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