通过 MCP（模型上下文协议），您可以将外部服务（如知识库、联网搜索、业务 API 等）作为标准化工具接入，让 AI 能够处理更复杂的任务，从而生成更准确、专业的回复。 > 更多 MCP 介绍，可以参见 [MCP 官方文档](https://modelcontextprotocol.io/docs/getting-started/intro)。

## 适用场景 |场景 |核心价值 | |---|---| |接入知识库（RAG） |让 AI 能够基于您内部非公开的文档或数据库进行精准问答 | |实时联网搜索 |让 AI 能够同时获取不同类型的信息（如天气、新闻、股票）并进行智能汇总。 | |执行复杂业务流程 |让 AI 能够调用外部 API，完成如预订、下单、查询账户等实际业务操作。 | ## 使用限制 * 火山方舟模型或第三方大模型，且需具备 Function Calling 能力。具体支持的模型，请参见[模型列表](https://www.volcengine.com/docs/82379/1330310)。

Tip

不建议使用 doubao-seed-1.6-thinking，该模型会强制开启思考模式且不可关闭，可能因高延时影响用户体验。

* MCP Server 必须支持流式 SSE（Server\-Sent Events）协议返回。 ## 接入方式 ### 1. 准备 MCP Server 准备一个符合 MCP 协议且可公网访问的 MCP Server： * **方式一**：**使用 MCP MarketPlace** 火山引擎的 [MCP MarketPlace](https://www.volcengine.com/mcp-marketplace) 提供了丰富的能力，例如知识库、联网搜索等，且支持一键部署，快速获得一个可用的 MCP Server URL。 * **方式二**：**自行开发** 如需接入私有工具，您需要自行开发并部署一个 MCP Server。该服务必须遵循 MCP 协议。具体操作，可参见 [MCP 官方文档](https://modelcontextprotocol.io/docs/getting-started/intro)。 ### 2. （可选）验证 MCP Server 可用性在正式配置前，建议先验证 MCP Server 是否可被公网正常访问。 ``：替换为您实际的 MCP Server 地址。 ```sh curl -i ``` ### 3. 在 StartVoiceChat 中注册 MCP 工具调用 `StartVoiceChat` 接口时，需要在 `LLMConfig` 中配置以下字段： > 完整参数参见对应接口文档：[AI 音视频互动方案- StartVoiceChat（2025-06-01）](https://www.volcengine.com/docs/6348/1558163)、[实时对话式 AI-StartVoiceChat（2024-12-01）](https://www.volcengine.com/docs/6348/1558163)。 |字段 |说明 | |---|---| |`LLMConfig.MCP` |注册您的 MCP 工具集。 | |`LLMConfig.SystemMessages` |大模型对 MCP 工具无先验认知，您必须在系统提示词中明确告知 LLM 需要使用的工具的名称、功能、使用场景、所需参数及格式，LLM 才能在对话中根据用户意图准确调用 MCP 工具。

注意

请确保 SystemMessages 中描述的所有工具参数均已在您的后端 MCP Server 的工具中实现。SystemMessages 的作用是指导模型如何使用您已实现的能力，而非定义新功能。

| **核心配置示例** ```JSON "LLMConfig": { // ... 其他 LLM 配置 "MCP": [{ "URL": "填入获取的 MCP Server 地址", "Name": "Web_Search", "ComfortWords": "正在为您搜索，请稍等。", "InterestedTools": ["web_search"] }], "SystemMessages": [ // ... 此处可包含其他角色设定或行为准则 "## 工具调用规则\n `Web_Search`（查询互联网的热点信息）：仅当用户表达了需要查询互联网热点信息的时候调用，你可以通过工具 `web_search` 查询热点信息，且你必须从用户的问题中提取 `query`（用户原始问题，必填）作为参数" ] } ``` ## 应用示例 ### 通过 MCP 接入火山联网搜索 API 本示例将指导您如何通过 MCP，将火山引擎联网搜索 API 能力接入到实时对话流中。

Warning

通过 MCP 接入联网搜索 API，会产生以下额外费用：

部署服务费：费用按实际调用时长和次数收取，更多计费详情可查函数服务和 API 网关计费说明。

联网搜索 API 费：具体请参见联网搜索 API 计费。

1. 开通联网搜索 API 服务。 1. 前往[联网搜索 API 控制台](https://console.volcengine.com/ask-echo/web-search)，开通所需搜索服务。 2. 在左侧导航栏中，选择 \*\* API Key 管理\*\*，创建并获取 API Key。 2. 生成联网搜索 API 的 MCP Server 地址。 1. 访问 [MCP MarketPlace](https://www.volcengine.com/mcp-marketplace)，搜索`融合信息搜索 MCP`。 2. 单击联网搜索 API MCP 卡片，进入部署页面，单击**云部署**。 3. 在**环境变量**栏，填入以下信息： * `VOLCENGINE_ACCESS_KEY`：您登录账号的 Access Key。 * `VOLCENGINE_SECRET_KEY`：您登录账号的 Secret Key。 * `ASK_ECHO_SEARCH_INFINITY_API_KEY`：在步骤 1 获取的 API Key。 4. 定位到**访问配置**区域： 1. 若**网关实例**下方页面显示为如下时，单击**创建**。系统会自动创建一个 API 网关实例。

说明

请确保您的账户余额大于 100元，否则无法创建。若提示 resource serverless-gateway already exists，确保余额大于 100元后，前往 API 网关实例列表页面，删除实例后，回到 MCP 部署页面，重新单击创建。

![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/d1ff9a8a46d44447951b94b8ebe64b03) 2. 网关创建需要一定时间，**网关实例**下方页面显示为如下时，单击**开始部署**，等待部署完成。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/4317513050844b468e28f85157056952) 5. 部署成功后，系统会为您生成一个唯一的 MCP Server 地址，复制并保存该地址。 3. 调用 `StartVoiceChat` 接口时，参照以下结构配置 `LLMConfig`。

说明

为准确触发查询，您必须通过 SystemMessages 明确告知 LLM 所需要使用的工具的名称、功能、所需参数及格式。

联网搜索 API 提供了丰富的参数（如 SearchType、Filter）来实现更精确的搜索。您可以通过在 SystemMessages 中编写更详细的规则来使用它们。详情请参见联网搜索 API。

```JSON "LLMConfig": { // ... 其他 LLM 配置 "MCP": [{ "URL": "填入获取的 MCP Server 地址", "Name": "Web_Search", "ComfortWords": "正在为您搜索，请稍等。", "InterestedTools": ["web_search"] }], "SystemMessages": [ // ...此处可包含其他角色设定或行为准则 "## 工具调用规则\n 当用户需要查询具有时效性的信息（如新闻、股价）时，调用 `web_search` 函数，该函数有一个 string 格式的参数 `Query`，你需要将用户的问题作为该参数的取值。" ] } ``` ### 通过 MCP 接入 Viking 知识库本示例将以接入一个关于“视频编码技术”的知识库为例。

注意

通过 MCP 接入 Viking 知识库，会产生以下额外费用：

部署服务费：费用按实际调用时长和次数收取，更多计费详情可查函数服务和 API 网关计费说明。

知识库费用：具体请参见知识库计费。

1. 创建 Viking 知识库并导入文档。具体操作，请参见[创建知识库](https://www.volcengine.com/docs/84313/1254457)。 2. 部署知识库 MCP Server。 1. 访问 [MCP MarketPlace](https://www.volcengine.com/mcp-marketplace)，搜索 **知识库 MCP**。 2. 单击知识库 MCP 卡片，然后单击**云部署**。 3. 在**环境变量**栏，填入以下关键信息： * `VOLCENGINE_ACCESS_KEY`：您登录账号的 Access Key。 * `VOLCENGINE_SECRET_KEY`：您登录账号的 Secret Key。 * `KNOWLEDGE_BASE_PROJECT`：您创建 Viking 知识库时，浏览器 URL 中 `projectName=` 后面的部分。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/e5d08751f2054e60bb4669bfd04501f7) * `KNOWLEDGE_BASE_REGION`：固定为 `cn-north-1`。 4. 定位到**访问配置**区域： 1. 若**网关实例**下方页面显示为如下时，单击**创建**。系统会自动创建一个 API 网关实例。

说明

请确保您的账户余额大于 100元，否则无法创建。若提示 resource serverless\-gateway already exists，确保余额大于 100元后，前往API 网关实例列表页面，删除实例后，回到 MCP 部署页面，重新单击创建。

说明

为准确触发知识库查询，必须通过 SystemMessages 明确告知 LLM 需要使用的知识库工具的名称、功能、所需参数及格式。

Viking 知识库还支持检索过滤、结果重排等高级功能。您可以通过编写更详细的 SystemMessages 来使用这些能力。详情请参见 search_knowledge（新）。

```JSON "LLMConfig": { // ... 其他LLM 配置 "MCP": [{ "URL": "填入获取的 MCP Server 地址", "Name": "search_video_codec_knowledge", "ComfortWords": "正在处理中", "InterestedTools": ["search_knowledge"] }], "SystemMessages": [ // ... 此处可包含其他角色设定或行为准则 "## 工具调用规则\n 当用户咨询视频编码相关信息时，调用 `search_knowledge` 函数，该函数有一个 string 格式的参数 `query`，你需要将用户的问题作为该参数的取值。" ] } ```

实时音视频