> 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 服务器。

## 概述

> **Note**
>
> 本指南介绍如何让 ElevenLabs 智能体访问外部 MCP 服务器。如需反向操作，即通过 Claude 或其他 MCP 客户端管理 ElevenLabs 智能体，请使用[托管 MCP 服务器](/docs/zh/eleven-agents/operate/hosted-mcp)。

[模型上下文协议（MCP）](https://modelcontextprotocol.io/)是一项开放标准，定义了应用如何向大语言模型（LLM）提供上下文。可将 MCP 视为通用连接器，让 AI 模型能与各类数据源和工具无缝交互。通过集成实现 MCP 的服务器，可以显著扩展 ElevenLabs 对话式智能体的能力。

> **Warning**
>
> 目前处于零留存模式或需要 HIPAA 合规的用户无法使用 MCP 支持。

ElevenLabs 允许你将对话式智能体连接到外部 MCP 服务器。这样，智能体可以：

* 通过 MCP 服务器访问和处理来自各种数据源的信息
* 使用 MCP 服务器提供的专用工具和功能
* 创建更动态、信息更丰富、交互性更强的对话体验

## 为工作区启用 MCP

所有工作区的 MCP 默认均处于禁用状态。任何人能够添加或使用 MCP 服务器前，工作区的一名成员必须代表工作区选择启用。

#### 控制台

首次有人尝试从 [MCP 服务器集成控制台](https://elevenlabs.io/app/agents/integrations)添加 MCP 服务器时，会自动进行选择启用。系统会显示一个对话框，要求其查看并接受《模型上下文协议服务器条款》——接受后将为整个工作区启用 MCP，因此每位可访问 ElevenAgents 的成员都能添加 MCP 服务器并将其附加到智能体。

#### API

你可以通过更新 `can_use_mcp_servers` 工作区设置，直接启用或禁用工作区的 MCP：

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.settings.update(can_use_mcp_servers=True)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.settings.update({ canUseMcpServers: true });
```

将 `can_use_mcp_servers` 重新设为 `false` 会禁用工作区的 MCP。现有 MCP 服务器集成将被保留，但智能体无法再使用它们，直到重新启用该设置。

> **Note**
>
> 启用 MCP 是工作区级设置，而非单个智能体设置。任何成员或拥有 `convai_write` 权限的任意 API 密钥
> 都可将其开启或关闭——不局限于工作区管理员。

为工作区启用 MCP 后，你添加的每个 MCP 服务器都是独立资源：创建它的成员可将其单独分享给其他工作区成员，类似于分享智能体或知识库文档。

> **Warning**
>
> 启用此设置不会覆盖上述零留存模式和 HIPAA 限制。
> 启用了零留存模式或 HIPAA 合规的工作区，无论 `can_use_mcp_servers` 设置如何，都无法使用 MCP 服务器。

## 快速开始

> **Note**
>
> ElevenLabs 同时支持 SSE（服务器发送事件）和 HTTP 流式传输 MCP 服务器。

本示例将使用 [Zapier MCP](https://zapier.com/mcp)，它可让你将 ElevenAgents 连接到数百种工具和服务。

> **Note**
>
> MCP 服务器目前尚无法通过 ElevenLabs CLI 管理，请使用控制台或 SDK。

#### 通过控制台添加

#### 打开 MCP 集成

前往 [MCP 服务器集成控制台](https://elevenlabs.io/app/agents/integrations)，然后点击 **添加自定义 MCP 服务器**。

![创建第一个 MCP 服务器](/docs/_fern-img/335d1d8fced3cd82eed4ed43ba0058d3a8dbc431f81cdb387bf3d5964e5ead80.webp)

#### 配置 MCP 服务器

输入以下信息：

* **名称**：MCP 服务器的名称（例如“Zapier MCP 服务器”）
* **描述**：MCP 服务器功能的说明
* **服务器 URL**：MCP 服务器的 URL。如果其中包含密钥，请像对待密码一样处理，并将其存储为工作区密钥。
* **密钥令牌**（可选）：Authorization 请求头值
* **HTTP 请求头**（可选）：服务器所需的任何其他请求头

#### 保存并测试连接

点击 **添加集成**，保存集成并测试连接以列出可用工具。

![Zapier 示例工具](/docs/_fern-img/7c9d83baedd0e2dc74014d4a690159333bbef0eec37c36fa9ee0fd6cd455df0e.webp)

#### 将服务器附加到智能体

MCP 服务器现已可添加到智能体。公共和私有智能体均支持 MCP。

![将 MCP 服务器添加到智能体](/docs/_fern-img/b18756710b4466a5fa462080d6f3b237d84f76f898d5c94d4583f31d2fa0395b.webp)

#### 通过 API 添加

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

server = elevenlabs.conversational_ai.mcp_servers.create(
    config={
        "url": "https://mcp.zapier.com/api/mcp/...",
        "name": "Zapier MCP Server",
        "description": "An MCP server with access to Zapier's tools and services",
        "approval_policy": "always_ask",
        "transport": "SSE",
    },
)

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "agent": {"prompt": {"mcp_server_ids": [server.id]}},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const server = await elevenlabs.conversationalAi.mcpServers.create({
  config: {
    url: "https://mcp.zapier.com/api/mcp/...",
    name: "Zapier MCP Server",
    description: "An MCP server with access to Zapier's tools and services",
    approvalPolicy: "always_ask",
    transport: "SSE",
  },
});

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    agent: { prompt: { mcpServerIds: [server.id] } },
  },
});
```

## 工具审批模式

ElevenLabs 提供灵活的审批控制，用于管理智能体如何请求使用 MCP 服务器工具的权限。你可以在 MCP 服务器级别和单个工具级别配置审批设置，实现最高级别的安全控制。

![工具审批模式设置](/docs/_fern-img/9f4c208459131622478de5010e2234d3af8a03dc9bc5b7ec2fcab48a7be3bde3.webp)

### 可用审批模式

* **始终询问（推荐）**：最高安全性。每次使用工具前，智能体都会请求你的许可。
* **精细化工具审批**：禁用工具，或预先选择可自动运行以及需要审批的工具。
* **无需审批**：助手无需审批即可使用任何工具。

### 精细化工具控制

精细化工具审批模式允许你为单个工具配置不同的审批要求，让你可精确控制哪些工具可自动运行，哪些需要明确许可。

![精细化工具审批
设置](/docs/_fern-img/041cad753319ed92189ee8d4f70a9d3ed07177303bf71777ce36a90270a5dd24.webp)

可为每个工具设置：

* **自动批准**：工具自动运行，无需许可
* **需要审批**：工具执行前需要明确许可
* **已禁用**：工具被完全禁用，无法使用

> **Tip**
>
> 使用精细化工具审批，让低风险的只读工具自动运行，同时要求对修改数据或执行敏感操作的工具进行审批。

## ElevenLabs 集成的关键注意事项

* **外部服务器**：你需负责选择希望集成的外部 MCP 服务器。ElevenLabs 提供连接这些服务器的方式。
* **支持的功能**：ElevenLabs 支持通过 SSE（服务器发送事件）和 HTTP 流式传输进行实时交互的 MCP 服务器。
* **动态工具**：集成 MCP 服务器提供的工具和功能由该外部服务器定义；如果服务器配置更新，它们可能会发生变化。

## 安全与免责声明

集成外部 MCP 服务器可能会将智能体和数据暴露给第三方服务。了解相关安全影响至关重要。

> **重要免责声明**
>
> 启用 MCP 服务器集成，即表示你确认这可能涉及与不受 ElevenLabs 控制的第三方服务共享数据。这可能带来额外的安全风险。
> 请确保你完全了解相关影响，审核所集成 MCP 服务器的安全性，并在继续前查阅我们的 [MCP 集成安全 指南](/docs/zh/eleven-agents/customization/tools/mcp/security)。

有关详细最佳实践，请参阅我们的 [MCP 集成安全指南](/docs/zh/eleven-agents/customization/tools/mcp/security)。

## 查找或构建 MCP 服务器

* 使用可信提供商公开提供的 MCP 服务器
* 开发自己的 MCP 服务器，以公开专有数据或工具
* 浏览模型上下文协议社区和资源，了解示例和服务器实现

### 资源

* [Anthropic 的 MCP 服务器示例](https://docs.anthropic.com/en/docs/agents-and-tools/remote-mcp-servers#remote-mcp-server-examples) - Anthropic 提供的示例服务器列表
* [Awesome Remote MCP Servers](https://github.com/jaw9c/awesome-remote-mcp-servers) - 精选的开源远程 MCP 服务器列表
* [Remote MCP Server Directory](https://remote-mcp.com/) - 可搜索的远程 MCP 服务器列表