操作场景
随着大模型应用的普及，越来越多的业务系统希望以 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 服务。
操作步骤
配置服务来源
服务来源用于批量接入已有的注册中心或私有域名解析服务。完成配置后，在创建 MCP 服务或后端服务时即可直接引用，避免重复填写接入参数。AI 网关支持 MCP 注册中心 与 私有 DNS 两种类型的服务来源：
MCP 注册中心：对接 TSF Nacos 3.x，自动同步注册中心中的原生 MCP Server，实现 MCP Tool 的自动发现。适用于标准 MCP 服务接入。
私有 DNS：对接腾讯云 Private DNS 进行内网域名解析。适用于通过私有域名访问的后端 HTTP 服务。
添加服务来源
1. 登录 微服务平台控制台 ，在左侧导航栏单击 云原生智能网关 > 实例列表。
2. 在实例列表页面，单击需要配置的网关实例的"ID"，进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 服务管理，然后单击 服务来源 页签，在列表上方单击 新建。
4. 在"新建服务来源"抽屉中，根据您的接入场景选择 来源类型，并参考下表完成配置。
来源类型 1：MCP 注册中心
参数 | 是否必选 | 说明 |
来源类型 | 是 | 选择 MCP 注册中心，用于同步原生 MCP Server，实现 Tool 自动发现。 |
来源产品 | 是 | 默认为 TSF Nacos，用于对接注册在 TSF Nacos 3.x 上的服务。 |
服务来源名称 | 是 | 输入服务来源名称。最长 60 个字符，支持中英文大小写、数字及分隔符("-"、"_")，不能以数字和分隔符开头，不能以分隔符结尾。同网关实例下唯一。 |
选择实例 | 是 | 从下拉列表中选择已有的 Nacos 实例。仅展示与当前网关实例位于同一 VPC 内的实例，确保网关可正常访问注册中心。 |
用户名 | 是 | 输入 Nacos 访问用户名，用于网关连接注册中心时的身份认证。 |
密码 | 是 | 输入 Nacos 访问密码，以加密方式存储。 |
描述 | 否 | 输入该服务来源的描述信息，便于后续管理。最长 200 个字符。 |
来源类型 2：私有 DNS
参数 | 是否必选 | 说明 |
来源类型 | 是 | 选择 私有 DNS，用于通过腾讯云 Private DNS 进行内网域名解析。 |
来源产品 | 是 | 固定为 腾讯云私有解析。 |
描述 | 否 | 输入该服务来源的描述信息，便于后续管理。最长 200 个字符。 |
5. 单击 确定 完成创建。创建成功后，服务来源将出现在 服务来源 列表中，后续在新建 MCP 服务或后端服务时可直接选择。
配置后端服务
若创建 HTTP 转 MCP 服务(域名/IP 模式) 或 标准 MCP 服务(域名/IP 模式)，需要先在 服务管理 > 服务 页签下创建服务，作为 MCP 服务关联的实例。
添加服务
1. 在网关实例详情页的左侧导航栏单击 服务管理，切换到 服务 页签，在列表上方单击 新建。
2. 在"新建服务"抽屉中，参考下表完成配置。其中部分字段会根据 服务类型 的选择动态展示。
参数 | 是否必选 | 说明 |
服务名称 | 是 | 输入服务名称，用于在 MCP 服务的"后端服务"下拉中标识此实例。最长 60 个字符，支持中英文大小写、数字及分隔符("-"、"_")，不能以数字和分隔符开头，不能以分隔符结尾。 |
服务类型 | 是 | 选择后端的接入方式： • 私有 DNS(默认)：通过已创建的私有 DNS 服务来源解析私有域名，适用于内网访问的后端服务。 • 域名/IP：直接填写 IP 或公网域名，适用于公网或固定地址的后端服务。 |
服务来源 | 是(私有 DNS) | 当 服务类型 选择 私有 DNS 时必填，从下拉列表中选择已创建的 私有 DNS 类型服务来源。 |
私有域名 | 是(私有 DNS) | 当 服务类型 选择 私有 DNS 时必填，输入需要解析的私有域名，例如 order.internal.example.com。 |
服务地址 | 是(域名/IP) | 当 服务类型 选择 域名/IP 时必填，输入后端服务的 IP 或公网域名，例如 10.0.0.1 或 www.tencent.com。 |
服务协议 | 是 | 选择后端服务的协议，默认为 HTTP，可选 HTTPS。 |
服务端口 | 是 | 输入后端服务的端口，支持 1~65535 的任意端口。如 SRV 记录已填写端口，控制台输入端口会覆盖 SRV 记录的端口内容。 |
服务路径 | 是 | 输入后端服务的基础路径(如 /api/v1)，后续 Tool 的相对路径将拼接在此路径之后。 |
超时时间 | 是 | 网关请求后端的超时时间，默认 60000 毫秒，取值范围 0-60000。 |
重试次数 | 是 | 请求失败时的重试次数，默认 5 次，取值范围 0-10。 |
3. 单击 确定 完成创建。创建后的后端服务将出现在服务列表中，供后续新建 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 个字符。 |
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 服务 + 域名/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。 |
场景三：HTTP 转 MCP 服务 + 域名/IP
适用于单一后端 HTTP 服务的接入，所有 Tool 共享同一个后端服务实例。在 后端类型 区选择 域名/IP，参考下表完成配置。
参数 | 是否必选 | 说明 |
后端服务 | 是 | 从下拉列表选择已在 服务管理 > 服务 下创建的后端服务。如未创建，可单击 新建服务 快速跳转至创建流程，或单击 刷新 重新加载下拉数据。 |
场景四：HTTP 转 MCP 服务 + 虚拟 MCP Server
适用于将多个不同的 HTTP 接口聚合为同一个 MCP Server 对外暴露的场景。网关自身充当 MCP Server，每个 Tool 独立配置完整后端 URL。
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 服务时无需配置后端地址。
