操作场景
随着大模型应用的普及，越来越多的业务系统希望以 Model Context Protocol(MCP) 的方式将自身能力开放给 AI Agent 调用。AI 网关作为统一的 MCP 接入层，为您屏蔽底层差异，提供统一的接入点、协议转换、Tool 管理与多后端聚合能力，使您能够安全、便捷地把后端服务以标准 MCP 形态对外暴露。
AI 网关支持以下两种 MCP 服务类型，以适配不同的接入场景：
标准 MCP 服务：适用于后端已基于官方 MCP SDK 实现 MCP 协议、或已注册到 TSF Nacos MCP Registry 的场景。网关作为透传代理，将客户端的 MCP 请求原样转发到后端，Tool 元数据由后端自动同步，在控制台呈现为只读。
HTTP 转 MCP 服务：适用于将存量 REST/HTTP 接口快速升级为 MCP 能力的场景。网关负责 HTTP 与 MCP 协议之间的转换，Tool 由您按需定义，支持手动创建或基于 OpenAPI 规范文件批量导入。该类型同时包含 虚拟 MCP Server 模式，可将多个不同系统的接口聚合为同一个 MCP Server 对外暴露。
本文介绍如何在 AI 网关中配置服务来源、创建后端服务，以及如何添加、查看、编辑 MCP 服务。
操作步骤
配置服务来源
配置后端服务
若创建 HTTP 转 MCP 服务(域名/IP 模式) 或 标准 MCP 服务(域名/IP 模式)，需要先在 服务管理 > 服务 页签下创建服务，作为 MCP 服务关联的实例，请参考服务管理-服务章节完成服务配置。
创建 MCP 服务
1. 登录 微服务平台控制台 ，在左侧导航栏单击 云原生智能网关 > 实例列表。
2. 在实例列表页面，单击需要配置的网关实例的“ID”，进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 MCP 管理，在 MCP 服务列表上方单击 新建。
4. 在“新建 MCP 服务”窗口中，完成第一步“基本信息”的配置。
参数 | 是否必选 | 说明 |
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；关闭时改写为后端地址 |
5. 完成基本信息后，单击 下一步，进入“后端服务配置”步骤。系统将根据“基本信息”中所选的 服务类型 展示不同的后端配置项，共四种场景。
场景一：标准 MCP 服务 + MCP 注册中心
适用于后端 MCP Server 已注册到 TSF Nacos，由网关从注册中心自动同步服务地址与 Tool 元数据。在 后端类型 区选择 MCP 注册中心，参考下表完成配置。
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择后端 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 |
场景二：标准 MCP 服务 + 域名/IP
适用于后端 MCP Server 未使用注册中心，需要手动指定服务地址的场景。在 后端类型 区选择 域名/IP
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择 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 |
场景三：标准 MCP 服务 + 容器服务
从 TKE 集群自动发现 Service，Pod 漂移无感知
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择 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 |
场景四：HTTP 转 MCP 服务 + 域名/IP
适用于单一后端 HTTP 服务的接入，所有 Tool 共享同一个后端服务实例。在 后端类型 区选择 域名/IP，参考下表完成配置。
参数 | 是否必选 | 说明 |
后端服务 | 是 | 从下拉列表选择已在 服务管理 > 服务 下创建的后端服务。如未创建，可单击 新建服务 快速跳转至创建流程，或单击 刷新 重新加载下拉数据。 |
场景五：HTTP 转 MCP 服务 + 虚拟 MCP Server
适用于将多个不同的 HTTP 接口聚合为同一个 MCP Server 对外暴露的场景。网关自身充当 MCP Server，每个 Tool 独立配置完整后端 URL。
场景六：HTTP 转 MCP 服务 + 普通注册中心
适用于将注册中心服务，快速包装为 MCP 服务。
参数 | 是否必选 | 说明 |
服务协议 | 是 | 选择后端 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 |
场景七：HTTP 转 MCP 服务 + 容器服务
适用于从 TKE 集群自动发现 Service，Pod 漂移无感知。配置方式同场景三。
6. 配置完成后，单击 确定 即可创建 MCP 服务。创建成功后，服务列表中会出现新增的 MCP 服务，单击其 ID 可查看详细的服务信息。
对于 标准 MCP 服务，Tool 由后端 MCP Server 自动同步，可在服务详情页的 Tools 管理 页签查看。
对于 HTTP 转 MCP 服务，需进入服务详情页的 Tools 管理 页签手动创建 Tool 或通过 OpenAPI 批量导入，详见 MCP Tools 管理。
查看 MCP 服务详情
在 MCP 服务列表中，单击目标服务的 ID/名称，进入服务详情页。详情页包含 基本信息 与 Tools 管理 两个页签。
基本信息 页签展示以下三个区块：
基本信息区：展示 MCP 服务 ID、MCP 服务名称、服务展示名称、服务类型、请求协议、创建时间、修改时间、描述等元数据。单击右上角的 编辑 可修改服务展示名称与描述等可变字段。
调用方式区：展示供 AI Agent 使用的
mcpServers JSON 配置模板，支持一键复制后粘贴到 Cursor、CodeBuddy、Claude Desktop 等 MCP 客户端的配置文件中。内网调用地址格式如下：{"mcpServers": {"<MCP 服务名称>": {"url": "http://<网关 IP>/mcpservers/<MCP 服务名称>/mcp"}},"transportType": "streamable-http"}
网关接入路径固定为
/mcpservers/<MCP 服务名称>/mcp，由网关根据实例 IP 与服务名自动生成。如需通过公网访问，请在 AI 网关实例的 基础信息 > 网络配置 中开启公网负载均衡，开启后调用方式区会同步展示公网接入地址。后端服务配置区：展示后端类型与对应的各字段信息。虚拟 MCP Server 模式下，服务协议显示为
-，表示无统一服务级后端协议，各 Tool 在创建时独立指定。编辑 MCP 服务
在 MCP 服务列表中，找到目标服务，单击其操作列下的 编辑，进入“编辑 MCP 服务”窗口。
第一步“基本信息”中，MCP 服务 ID、MCP 服务名称、服务类型、请求协议 为只读，仅 服务展示名称 与 描述 可编辑。单击 下一步 后，可修改后端服务配置中的各字段(如服务地址、服务端口、超时时间、重试次数、后端服务等)。修改完成后，单击 确定 保存即可生效。
注意事项
标准 MCP 服务(MCP 注册中心模式) 依赖 TSF Nacos 3.x 的版本特性，请确认所选 Nacos 实例的版本。
HTTP 转 MCP 服务(域名/IP 模式) 必须先在 服务管理 > 服务 页签下创建服务，再在新建 MCP 服务时引用。虚拟 MCP Server 模式 下创建 MCP 服务时无需配置后端地址。
