功能介绍
MCP服务管理支持直接代理模式,适用于原生支持MCP协议的服务。该模式能够实现高效的流式通信和上下文保持,特别适合高并发、长连接的场景,例如 AI 推理、多模型协同等。
创建托管MCP服务
登录 云原生API网关控制台,在顶部菜单栏选择资源池。
在左侧导航栏,选择 "AI网关-实例" 菜单,进入实例列表页,选择目标实例进入详情页。
在左侧导航栏,选择"MCP管理-MCP服务"。
单击按钮 "创建MCP服务",AI网关目前提供了以下两种类型创建MCP服务:
如果后端为MCP服务,则选择MCP服务直接代理;
如果后端为Http服务,则选择HTTP转MCP。
MCP服务直接代理
| 配置项 | 描述 |
|---|---|
| 名称 | 自定义MCP服务名称 |
| 协议 | 选择MCP服务直接代理 |
| 描述 | MCP服务的描述信息 |
| 后端服务-服务名称 | 在服务列表的下拉框中选择目标MCP服务 |
| 后端服务-服务协议 | 当前为固定值MCP |
| 后端服务-MCP Transport | 支持SSE和Streamable HTTP两种传输协议,请根据目标服务的实际传输协议来选择 |
| 后端服务-路径 | 路径是实际的后端mcp服务的访问path。比如后端mcp server访问端点是xxx.com/sse,路径就填/sse;如果是xxx.com/test/sse,路径就填/test/sse |
| MCP接入点-域名 | 选择访问MCP服务使用的域名,支持多个域名 |
| MCP接入点-路径 | MCP接入点的路径是通过/mcp-servers、/MCP服务名称以及实际的后端MCP Server的访问path拼接成的。创建完成后,可以在MCP服务详情页查看完整的访问地址 |
HTTP转MCP
说明
当前仅支持转Streamable HTTP协议。
| 配置项 | 描述 |
|---|---|
| 名称 | 自定义MCP服务名称 |
| 协议 | 选择HTTP转MCP |
| 描述 | MCP服务的描述信息 |
| 后端服务-服务名称 | 在服务列表的下拉框中选择目标HTTP服务 |
| MCP接入点-域名 | 选择访问MCP服务使用的域名,支持多个域名 |
| MCP接入点-路径 (Streamable HTTP) | MCP接入点的路径是通过/mcp-servers、/MCP服务名称和/mcp 拼接成的。创建完成后,可以在MCP服务详情页查看完整的访问地址 |
HTTP转MCP协议的MCP服务添加工具
目前支持自定义YAML方式添加工具:
进入HTTP转MCP协议的MCP服务的详情页,点击"添加工具"。
单击"YAML示例",会填充一份配置示例。您可以针对生成的配置进行修改。详细配置详情,请参见 HTTP to MCP 配置字段参考。
(可选)开启后端服务认证:可以添加认证鉴权配置。认证方式配置说明如下:
参数
说明
Basic
将用户名和密码以username: password的形式进行Base64编码后,放在HTTP请求头的Authorization字段中发送。
Bearer
客户端先通过登录接口获取一个令牌,通常是JWT。以后每次请求都在Authorization头中带上该令牌。令牌通常是临时的,可以设置有效期。
API Key
由服务端分配给客户端一个唯一字符串作为访问凭据,客户端在每次请求时通过Header或Query参数提交。
单击"确定",可以在工具页签看到工具列表及工具描述信息。
编辑MCP服务
登录 云原生API网关控制台,在顶部菜单栏选择资源池。
在左侧导航栏,选择 "AI网关-实例" 菜单,进入实例列表页,选择目标实例进入详情页。
在左侧导航栏,选择"MCP管理-MCP服务",单击目标MCP服务操作列的"编辑"。或者进入MCP服务详情页,单击右上角的"编辑"。
在编辑MCP服务面板中修改描述、服务名称、域名等可修改字段,然后单击"确定"。
发布MCP服务
登录 云原生API网关控制台,在顶部菜单栏选择资源池。
在左侧导航栏,选择 "AI网关-实例" 菜单,进入实例列表页,选择目标实例进入详情页。
在左侧导航栏,选择"MCP管理-MCP服务",进入目标MCP服务详情页。
当MCP服务状态为未发布或已发布(有修改)时,可以单击右上角的"发布"。
下线MCP服务
登录 云原生API网关控制台,在顶部菜单栏选择资源池。
在左侧导航栏,选择 "AI网关-实例" 菜单,进入实例列表页,选择目标实例进入详情页。
在左侧导航栏,选择"MCP管理-MCP服务",进入目标MCP服务详情页。
当MCP服务状态为已发布或已发布(有修改),可以单击右上角的"下线"。
删除MCP服务
说明
MCP服务需先下线才能删除。
登录 云原生API网关控制台,在顶部菜单栏选择资源池。
在左侧导航栏,选择 "AI网关-实例" 菜单,进入实例列表页,选择目标实例进入详情页。
在左侧导航栏,选择"MCP管理-MCP服务",单击目标MCP服务操作列的"删除"。