自定义 MCP 服务

本文为您介绍如何创建并配置自定义 MCP 服务，并在智能体中完成其调试。

创建自定义 MCP 服务

1. 登录 涂鸦开发者平台。

2. 进入 MCP 管理 > 自定义 MCP 服务 页面，单击 添加自定义 MCP。

   

3. 在 注册 MCP Server 弹窗中，填写服务名称和服务描述，上传图片作为 Icon，并单击 确定 保存。

   

配置自定义 MCP 服务

涂鸦自定义 MCP 服务支持 Websocket、StreamableHTTP 和 SSE 三种协议。您可以根据自身需求选择不同的协议接入。

websocket 协议接入

接入配置

1. 创建完成 MCP 服务后，会自动进入其 服务详情 页面。

2. 在 服务接入配置管理 > 数据中心 下，单击右侧的 添加数据中心，并根据实际需求选择数据中心。

   

3. 在所选数据中心下，查看 接入地址、Access ID 和 Access secret 并将信息复制粘贴到本地。请注意这些参数会在之后运行 MCP 的 SDK 时用到（具体请参考 Github 源码中的 README 说明）。

   

基于 SDK 访问 MCP 服务

请前往 Github 下载 MCP 的 SDK 并阅读相关资料。目前仅支持 SSE 模式。

运行并调试 MCP 服务

接下来，为确保您的自定义 MCP 服务可以正常运行，需要在智能体中运行并调试 MCP 服务。

1. 首先，在所选数据中心下，检查 MCP 服务的服务状态。

   

2. 然后，在 工具 页面，查看您的 MCP 服务的可用工具。

   

3. 接下来，在要测试的工具下，单击 试运行。

   

4. 在 试运行 窗口，单击 运行，当左下角显示为 调试通过 时，则为 MCP 工具调试成功。

   

HTTP 协议接入

StreamableHTTP 和 SSE 两种协议设置步骤相同，以下以 StreamableHTTP 为例进行说明。

接入配置

1. 进入 服务详情 页面后，接入方式选择 StreamableHTTP，页面显示 StreamableHTTP 协议配置项。

2. 选择 MCP 部署的数据中心。设置后，在智能体编排绑定该 MCP 服务时，只能在已部署的数据中心下可见并访问。
   例如：MCP A 服务选择数据中心为美西数据中心，则智能体编排时，只有美西数据中心的智能体可见 MCP A 服务并将 A 绑定至智能体，其他数据区智能体不可见 MCP A 服务。

   

3. 添加 MCP 服务配置。输入 MCP 配置代码，注意格式正确，避免解析失败。

4. 单击 确认，保存服务配置成功。保存成功后，API Key 前台不明文展示，如需修改，重新输入 JSON 配置并提交即可。

调试 MCP Tools

HTTP 协议接入远程 MCP 服务后，平台会自动读取 MCP Tools。您可以在服务详情页切换为 工具 Tab 页，来查看和调试每个工具。

在智能体中添加 MCP 服务

1. 前往 我的智能体 页面，单击 开发版本 进入智能体的开发页面。

2. 在 01 模型能力配置 > 技能配置 下，选择 工具集，并单击右侧的添加（+）按钮。

   

3. 在 添加工具 页面，选择 MCP 页签，单击 自定义 MCP 服务 并按需将自定义的 MCP 服务添加到智能体中。