参数 | 是否必选 | 说明 |
MCP 服务名称 | 是 | 输入 MCP 服务的唯一标识,该名称将作为接入路径的一部分( /mcpservers/<MCP 服务名称>/mcp)。最长 60 个字符,支持英文大小写、数字及分隔符("-"、"_"),不能以数字和分隔符开头,不能以分隔符结尾。同网关实例下唯一,创建后不可修改。 |
服务展示名称 | 是 | 输入服务展示名称,用于在控制台列表与详情页展示。最长 60 个字符,支持中英文大小写、数字及分隔符("-"、"_"),不能以数字和分隔符开头,不能以分隔符结尾。 |
服务类型 | 是 | 选择 MCP 服务类型: 标准 MCP 服务:后端已实现 MCP 协议,网关透传代理。Tool 自动同步,只读。 HTTP 转 MCP 服务:存量 HTTP 服务,网关负责协议转换,包含虚拟 MCP Server 模式。Tool 由用户配置。 |
请求协议 | 是 | 客户端调用网关时使用的 MCP 传输协议,当前版本固定为 Streamable HTTP。 |
描述 | 否 | 该服务的描述信息,便于后续管理。最长 200 个字符。 |
Host 透传 | 否 | 开启后,网关转发时保留客户端原始请求的 Host 头至后端 MCP Server;关闭时改写为后端地址 |
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择后端 MCP Server 的协议,默认为 HTTP,可选 HTTPS。 |
服务来源 | 是 | 从下拉列表选择已创建的 MCP 注册中心 类型服务来源。如未创建,可单击 新建服务来源 快速跳转至创建流程。 |
命名空间 | 是 | 输入 Nacos 命名空间。最长 128 个字符,仅支持英文字母、数字、 _、-。 |
MCP 服务 | 是 | 输入目标 MCP Server 的服务标识。最长 128 个字符,仅支持英文字母、数字、 _、-。 |
MCP Endpoint | 是 | 输入 MCP 协议的 Endpoint 路径。最长 64 个字符,以 / 开头,仅支持英文字母、数字、/、_、-。 |
服务分组 | 是 | 输入 Nacos 服务分组。最长 128 个字符,仅支持英文字母、数字、 .、-。 |
服务名称 | 是 | 输入 Nacos 服务名称。最长 128 个字符,仅支持英文字母、数字、 .、-。 |
超时时间 | 是 | 网关请求后端的超时时间,默认 3000 毫秒,取值范围0 ~ 60000。 |
重试次数 | 是 | 请求失败时的重试次数,默认 3 次,取值范围0 ~ 10。 |
健康检查 | 否 | 是否开启 MCP Server 健康检查,如需进行健康检查则打开按钮并配置健康检查参数: 检查类型:HTTP/HTTPS 检查间隔:5秒以上(必填) 超时时间:1秒以上(必填) 失败阈值:1次以上(必填) 恢复阈值:1次以上(必填) 探测路径:请自行配置,默认:/health(必填) 探测方法:GET/POST |
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择 HTTP 或 HTTPS。 |
服务地址 | 是 | 输入后端 MCP Server 的 IP 或域名,例如 10.0.0.1 或 mcp-server.example.com。 |
服务端口 | 是 | 输入后端服务的端口,支持 1~65535 的任意端口。 |
MCP Endpoint | 是 | 输入 MCP 协议的 Endpoint 路径。最长 64 个字符,以 / 开头,仅支持英文字母、数字、/、_、-。 |
超时时间 | 是 | 默认 3000 毫秒,取值范围 0 ~ 60000。 |
重试次数 | 是 | 默认 3 次,取值范围 0 ~ 10。 |
健康检查 | 否 | 是否开启 MCP Server 健康检查,如需进行健康检查则打开按钮并配置健康检查参数 检查类型:HTTP/HTTPS 检查间隔:5秒以上(必填) 超时时间:1秒以上(必填) 失败阈值:1次以上(必填) 恢复阈值:1次以上(必填) 探测路径:请自行配置,默认:/health(必填) 探测方法:GET/POST |
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择 HTTP 或 HTTPS。 |
服务来源 | 是 | 选择 已配置的 TKE 容器服务来源 |
服务端口 | 是 | 输入目标 TKE 服务所在命名空间。 |
K8s Service | 是 | 目标 K8s 服务,多机多卡场景请选 master 节点 svc |
服务端口 | 是 | 后端服务的端口,支持 1~65535 的任意端口 |
MCP Endpoint | 是 | 输入 MCP 协议的 Endpoint 路径。最长 64 个字符,以 / 开头,仅支持英文字母、数字、/、_、-。 |
超时时间 | 是 | 默认 3000 毫秒,取值范围0 ~ 60000。 |
重试次数 | 是 | 默认 3 次,取值范围0 ~ 10。 |
健康检查 | 否 | 是否开启 MCP Server 健康检查,如需进行健康检查则打开按钮并配置健康检查参数 检查类型:HTTP/HTTPS 检查间隔:5秒以上(必填) 超时时间:1秒以上(必填) 失败阈值:1次以上(必填) 恢复阈值:1次以上(必填) 探测路径:请自行配置,默认:/health(必填) 探测方法:GET/POST |
参数 | 是否必选 | 说明 |
后端服务 | 是 | 从下拉列表选择已在 服务管理 > 服务 下创建的后端服务。如未创建,可单击 新建服务 快速跳转至创建流程,或单击 刷新 重新加载下拉数据。 |
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择后端 MCP Server 的协议,默认为 HTTP,可选 HTTPS。 |
注册中心类型 | 是 | TSF Nacos、TSF PolarisMesh |
服务来源 | 是 | 从下拉列表选择已创建的 普通注册中心 类型服务来源。如未创建,可单击 新建服务来源 快速跳转至创建流程。 |
命名空间 | 是 | 输入 Nacos/PolarisMesh 命名空间。最长 128 个字符,仅支持英文字母、数字、 _、-。 |
服务 | 是 | 输入目标 MCP Server 的服务标识。最长 128 个字符,仅支持英文字母、数字、 _、-。 |
服务分组 | 是 | 输入 Nacos 服务分组。最长 128 个字符,仅支持英文字母、数字、 .、-。 |
超时时间 | 是 | 网关请求后端的超时时间,默认 3000 毫秒,取值范围0 ~ 60000。 |
重试次数 | 是 | 请求失败时的重试次数,默认 3 次,取值范围0 ~ 10。 |
健康检查 | 否 | 是否开启 MCP Server 健康检查,如需进行健康检查则打开按钮并配置健康检查参数: 检查类型:HTTP/HTTPS 检查间隔:5秒以上(必填) 超时时间:1秒以上(必填) 失败阈值:1次以上(必填) 恢复阈值:1次以上(必填) 探测路径:请自行配置,默认:/health(必填) 探测方法:GET/POST |
mcpServers JSON 配置模板,支持一键复制后粘贴到 Cursor、CodeBuddy、Claude Desktop 等 MCP 客户端的配置文件中。内网调用地址格式如下:{"mcpServers": {"<MCP 服务名称>": {"url": "http://<网关 IP>/mcpservers/<MCP 服务名称>/mcp"}},"transportType": "streamable-http"}
/mcpservers/<MCP 服务名称>/mcp,由网关根据实例 IP 与服务名自动生成。如需通过公网访问,请在 AI 网关实例的 基础信息 > 网络配置 中开启公网负载均衡,开启后调用方式区会同步展示公网接入地址。-,表示无统一服务级后端协议,各 Tool 在创建时独立指定。文档反馈