一、操作场景
·MCP 注册中心:对接注册中心(如 TSF Nacos),同步原生 MCP Server,实现 MCP Tool 自动发现。
·普通注册中心:对接注册中心(如 TSF Nacos 2.x、TSF PolarisMesh),自动同步后端服务地址和元数据,适用于将后端服务批量接入 AI 网关。
·私有 DNS:对接腾讯云 Private DNS 进行域名解析,适用于通过域名访问的服务场景。
二、前置条件
·已开通 腾讯云 AI 网关服务
·已创建 AI 网关实例
·注册中心/TKE 实例与网关实例在同一 VPC 网络
三、步骤1:进入服务来源配置页面
1. 登录微服务平台控制台 ,在左侧导航栏选择 AI 网关进入实例列表。
2. 单击目标实例 ID/名称进入实例详情页,进入目标网关实例。
3. 在左侧导航栏,选择服务管理 > 服务来源;
4. 单击新建按钮。
四、步骤2:选择服务来源类型
系统提供三种服务来源类型,请根据你的实际场景选择。
五、场景一:配置 MCP 注册中心(同步原生 MCP Server)
适用场景:你的 MCP Server 已注册到 TSF Nacos,需要 AI 网关自动发现和同步 Tool。
参数配置:
| 参数名称 | 是否必选 | 说明 |
| 来源类型 | 是 | 选择 MCP 注册中心 |
| 来源产品 | 是 | TSF Nacos(推荐)直接对接注册在 TSF Nacos 3.x 上的服务 |
| 服务来源名称 | 是 | 自定义名称,最长60个字符,支持中英文、数字及 -、_ 符号,不能以隔符开头和结尾,同网关实例下唯一 |
| 选择实例 | 是 | 选择已有的 Nacos 实例(仅显示与网关实例同 VPC 的实例) |
| 用户名 | 是 | Nacos 鉴权用户名 |
| 密码 | 是 | Nacos 鉴权密码,支持英文字母、数字、空格及常见符号 |
| 描述 | 否 | 服务来源描述信息,最长200个字符 |
操作步骤:
1. 在新建服务来源弹窗中,选择来源类型为 MCP 注册中心;
2. 选择来源产品为 TSF Nacos;
3. 填写服务来源名称(如:mcp-nacos-prod);
4. 从下拉列表中选择 Nacos 实例;
5. 填写鉴权用户名和密码;
6. (可选)填写描述信息;
7. 单击 确定 完成创建。
同步效果:
·AI 网关将自动同步 Nacos 中注册的 MCP Server 服务。
·MCP Server 的 Tool 定义将自动发现并在控制台展示。
·服务实例变更时,网关自动感知并更新。
六、场景二:配置普通注册中心(批量接入后端服务)
适用场景:你的后端服务已注册到 TSF Nacos 2.x 或 TSF PolarisMesh,需要 AI 网关自动发现并接入这些服务。
参数配置:
| 参数名称 | 是否必选 | 说明 |
| 来源类型 | 是 | 选择 普通注册中心 |
| 来源产品 | 是 | TSF Nacos(推荐):直接对接注册在 TSF Nacos 2.x 上的服务;TSF PolarisMesh:直接对接注册在 TSF PolarisMesh 上的服务 |
| 服务来源名称 | 是 | 自定义名称,最长60个字符,支持中英文、数字及 -、_ 符号,不能以分隔符开头和结尾,同网关实例下唯一 |
| 选择实例 | 是 | 选择已有的 Nacos / PolarisMesh 实例(仅显示与网关实例同 VPC 的实例) |
| 用户名 | 是 | 注册中心鉴权用户名。支持英文字母、数字、空格及常见符号 |
| 密码 | 是 | 注册中心鉴权密码。支持英文字母、数字、空格及常见符号 |
| 描述 | 否 | 服务来源描述信息,最长200个字符 |
操作步骤:
1. 在新建服务来源弹窗中,选择来源类型为普通注册中心;
2. 选择来源产品为 TSF Nacos(推荐)或 TSF PolarisMesh;
3. 填写服务来源名称(如:nacos-prod、polaris-prod);
4. 从下拉列表中选择对应的注册中心实例;
5. 填写鉴权用户名和密码;
6. (可选)填写描述信息;
7. 单击确定完成创建。
同步效果:
·AI 网关将自动同步注册中心中已注册的后端服务(包含服务地址、端口等元数据)。
·服务实例变更时,网关自动感知并更新,无需手动维护服务列表。
·同步的服务可在“服务管理 > 服务”列表中查看,可直接用于创建模型服务的后端来源。
七、场景三:配置容器服务(批量接入 TKE 服务)
使用场景:对接腾讯云 TKE 集群,自动发现 Service
参数配置:
| 参数名称 | 是否必选 | 说明 |
| 来源产品 | 是 | TKE 标准集群使直接对接部署在 TKE 标准集群上的服务 |
| 服务来源名称 | 是 | 2 ~ 60个字符,支持中英文大小写、数字及分隔符("-"、"_"),不能以数字和分隔符开头,不能以分隔符结尾 |
| 选择集群 | 是 | 仅支持选择和当前 AI 网关有相同 VPC 的可用集群 |
| 描述 | 否 | 服务来源描述信息,最长200个字符 |
八、场景四:配置私有 DNS(通过域名解析访问服务)
适用场景:你的后端服务通过域名访问,需要使用腾讯云 Private DNS 进行域名解析。
参数配置:
| 参数名称 | 是否必选 | 说明 |
| 来源类型 | 是 | 选择 私有 DNS |
| 来源产品 | 是 | 腾讯云私有解析使用 Private DNS 进行域名解析 |
| 描述 | 否 | 服务来源描述信息,最长200个字符 |
操作步骤:
1. 在新建服务来源弹窗中,选择来源类型为私有 DNS;
2. 选择来源产品为腾讯云私有解析;
3. (可选)填写描述信息;
4. 单击确定完成创建。
配置说明:
·配置完成后,在创建服务时可选择该来源。
·后端地址支持填写域名(如:server.internal.example.com)。
·网关将通过 Private DNS 解析域名并转发请求。
九、步骤3:保存配置
1. 确认所有参数填写正确;
2. 单击确定按钮完成创建;
3. 系统自动跳转到服务来源列表页。
十、结果验证
配置完成后,可通过以下方式验证:
·在服务来源列表页,查看新建的来源记录。
·MCP 注册中心类型:在新建 MCP 服务时,可在服务来源下拉列表中选择该来源。
·普通注册中心类型:在新建服务时,可在服务来源下拉列表中选择该来源,同步的注册中心服务将作为可选后端。
·私有 DNS 类型:在新建服务时,选择该来源,后端地址可填写域名。
·在 MCP 管理 > MCP 服务 页面,新建服务时可在服务来源下拉列表中选择该来源。
十一、Q1: 为什么选择实例时看不到我的 Nacos 实例?
A: 请检查以下几点:
1. Nacos 实例与 AI 网关实例是否在同一 VPC 网络;
2. 你的账号是否有 Nacos 实例的查看权限;
3. Nacos 实例是否处于运行中状态。
十二、Q2: 一个服务来源可以关联多个 MCP 服务吗?
A: 可以。单个服务来源可以关联多个 MCP 服务,适用于以下场景:
·同一个 Nacos 实例中注册了多个 MCP Server。
·同一个 Nacos / PolarisMesh 实例中注册了多个后端服务。
·同一个 Private DNS 解析多个不同的域名。
十三、Q3: 服务来源配置错误导致同步失败,如何排查?
A: 请按以下步骤排查:
1. 进入服务来源详情页,查看错误信息;
2. MCP 注册中心:检查用户名/密码是否正确,Nacos 实例是否可访问;
3. 私有 DNS:检查域名解析记录是否正确配置;
4. 查看 AI 网关日志获取详细错误信息。