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

# Claude、Cursor 和其他 AI 助手

## 概述

你可以在 ElevenLabs 控制台外通过 Claude、Claude Code、ChatGPT 和 Cursor 等助手管理智能体。它们都通过同一个连接方式：ElevenLabs [托管 MCP 服务器](/docs/zh/eleven-agents/operate/hosted-mcp)，即位于 `https://api.elevenlabs.io/v1/mcp` 的远程 [模型上下文协议](https://modelcontextprotocol.io/)服务器。该服务器提供智能体管理工具，并通过 OAuth 登录，因此无需将 API 密钥复制到客户端。

编程助手还可以安装 **ElevenLabs 插件**，其中包含 MCP 服务器和 ElevenAgents Architect 的专属技能：Architect 在控制台中用于探索智能体、编辑其配置、工作流和工具、编写测试以及处理分诊队列的工作流。

## 设置助手

#### Claude

ElevenLabs 连接器列在 Claude 连接器目录中。在 Claude 中，依次前往 **设置** > **连接器**，搜索 **ElevenLabs**，选择 **连接**，然后完成 OAuth 登录。

对于数据驻留环境，请改为使用所在区域的 URL 添加自定义连接器。参阅[托管 MCP 服务器](/docs/zh/eleven-agents/operate/hosted-mcp#data-residency-regions)。

#### Claude Code

安装 ElevenLabs 插件，其中包含 MCP 服务器和 Architect 技能：

```bash
/plugin marketplace add elevenlabs/plugin
/plugin install elevenlabs@elevenlabs
```

如仅需添加 MCP 服务器，不安装技能：

```bash
claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
```

然后在 Claude Code 中运行 `/mcp`，并完成 OAuth 登录。

#### Cursor

从 [Cursor 市场](https://cursor.com/marketplace)安装 ElevenLabs 插件。其中包含 MCP 服务器和 Architect 技能。

如仅需添加 MCP 服务器，请将其添加到 `mcp.json`：

```json
{
  "mcpServers": {
    "elevenlabs": {
      "url": "https://api.elevenlabs.io/v1/mcp"
    }
  }
}
```

Cursor 首次连接时会提示你通过 OAuth 登录。

#### ChatGPT

在 ChatGPT 中添加 ElevenLabs 作为自定义连接器，使用服务器 URL `https://api.elevenlabs.io/v1/mcp`，然后完成 OAuth 登录。可能需要由 ChatGPT 工作区管理员启用自定义连接器。

#### 其他客户端

任何支持通过 OAuth 连接远程服务器的 MCP 客户端都可以连接。将客户端指向 `https://api.elevenlabs.io/v1/mcp` 或所在区域的 URL，然后完成登录。支持托管客户端元数据（CIMD）的客户端无需单独注册客户端。

插件源代码（包括 Architect 技能）位于 [github.com/elevenlabs/plugin](https://github.com/elevenlabs/plugin/tree/main/architect)。

## 控制台与外部助手的区别

应用内 Architect 和 MCP 服务器都会以你的账户调用相同的 ElevenAgents API，因此两者都受权限限制，结果也会显示在相同位置。区别在于变更的暂存和审批方式。

|      | 控制台中的 Architect                                                                           | 通过 MCP 使用的外部助手                                                        |
| ---- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| 身份   | 通过浏览器会话登录的你                                                                               | 通过已批准 OAuth 授权登录的你                                                    |
| 配置变更 | 暂存在草稿中。始终由你发布。                                                                            | 直接应用。更新智能体会在目标分支上发布新版本；如果未指定分支，则发布到 `main`。对于需要审核的变更，请让助手在分支上操作或创建草稿。 |
| 审批   | Architect 的[审批模式](/docs/zh/eleven-agents/operate/architect/authentication#approval-modes) | 客户端的工具设置。服务器会将每个工具标记为只读或破坏性工具，Claude 等客户端可让你选择哪些工具自动运行、哪些工具先征求确认。     |
| 合并提案 | 可以创建提案并请求审核者，但无法审核或合并提案。                                                                  | 可以在权限范围内创建、审核、评论和合并提案。你仍不能批准自己的提案。                                    |
| 上下文  | 当前页面、智能体摘要、智能体上下文、偏好设置，以及入口传入的内容                                                          | 仅包含你告知助手的内容，以及它通过工具读取的内容。不会自动发送智能体上下文和偏好设置。                           |
| 其他功能 | 计划模式、聊天中的仪表板、代码执行、Spotlight 和分诊交接，以及在控制台中为你引导操作                                           | 客户端中的代码库和其他工具。还可执行 Architect 未提供的部分管理操作，例如管理 MCP 服务器和删除知识库文档。         |

通过外部助手创建的分支、版本、合并提案、测试和分诊工单，会与在 ElevenAgents 中创建的内容一样显示在控制台相应位置。例如，合并提案会显示在 **版本控制** > **提案** 下，作者为你。

> **Warning**
>
> 由于 MCP 更新会直接发布，从外部助手修改 `main` 可能会立即影响实时
> 调用。在客户端中将智能体更新和合并工具设为需要确认；如果每项变更都必须审核，
> 请保护 `main` 分支。

## 选择工作方式

* **在控制台中使用 Architect** 来改进线上智能体。它会从 Spotlight 发现的问题、失败的测试和分诊工单入手，将每项变更暂存到草稿中，并由你决定是否发布。
* **使用 Claude 或 ChatGPT 等聊天助手**，在已使用这些工具时快速询问或跨智能体进行变更，例如：“我的哪些智能体仍在使用默认的首条消息？”
* **使用安装插件的编程助手**，当智能体以代码形式与应用一起管理时。助手可在同一会话中修改智能体及调用它的代码。另请参阅 [ElevenLabs CLI](/docs/zh/eleven-agents/operate/cli)。