MCP 服务

功能概述

MCP 服务位于 能力扩展 → MCP 服务，将外部工具暴露给模型。平台支持 HTTP Stream 与 STDIO 两种传输方式，服务连接与进程启动均发生在 AI 后端环境。

前置条件

准备支持 MCP 协议的工具服务，并确认传输方式、服务端点或启动命令，以及服务方要求的鉴权方式。使用 STDIO 时，启动命令所需的运行时与文件须已部署在 AI 后端环境中。

1. 新增服务

进入 能力扩展 → MCP 服务，点击 新增，填写名称与分类。名称用于在业务中选择服务，分类用于整理资源。服务启用后才参与工具装载。

服务列表及工具集入口。

2. 配置 HTTP Stream

1. 传输选择 HTTP Stream。
2. 填写完整 MCP 服务端点，例如 https://mcp.example.com/mcp。
3. 请求头按 JSON 对象填写；不需要额外请求头时可留空。
4. 点击 保存。

HTTP Stream 配置：填写服务端点与请求头。

鉴权请求头按服务方要求填写。端点须为 MCP 服务地址，普通网页地址无法建立 MCP 连接。

3. 配置 STDIO

传输选择 STDIO。启动命令可按逗号或空格分隔，环境变量填写 JSON 对象。

node,/opt/mcp/service.js

以上为命令格式示例。命令中的路径和参数按服务在后端环境中的部署情况填写。

STDIO 启动命令与环境变量配置。

4. 解析工具与试聊

保存后，在列表点击 工具集：

1. 检查左侧是否返回预期工具名称与描述。
2. 右侧选择支持工具调用的对话模型。
3. 输入一个需要该工具的问题。
4. 检查工具调用、返回数据和最终回答。

工具列表为空时，先检查服务是否提供工具以及协议连接情况；调用失败时，按页面反馈检查地址、请求头、进程命令和后端日志。

5. 关联业务

对话编排可直接选择 MCP 服务；技能可通过作用域 MCP 限定激活后的工具范围。开放接口按 MCP 服务调用 使用模型辅助调用协议。