操作场景
当您需要将已有的注册中心或域名服务中的服务批量接入 AI 网关时，可以通过配置服务来源，实现 服务的自动同步和统一管理。服务来源分为三种类型：
MCP 注册中心：对接注册中心（如 TSF Nacos），同步原生 MCP Server，实现 MCP Tool 自动发现。
普通注册中心：对接注册中心（如 TSF Nacos 2.x、TSF PolarisMesh），自动同步后端服务地址和元数据，适用于将后端服务批量接入 AI 网关。
私有 DNS：对接腾讯云 Private DNS 进行域名解析，适用于通过域名访问的服务场景。
前置条件
已开通 腾讯云 AI 网关服务
已创建 AI 网关实例
注册中心实例与网关实例在同一 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 网关将自动同步注册中心中已注册的后端服务（包含服务地址、端口等元数据）。
服务实例变更时，网关自动感知并更新，无需手动维护服务列表。
同步的服务可在“服务管理 > 服务”列表中查看，可直接用于创建模型服务的后端来源。
场景三：配置私有 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 网关日志获取详细错误信息。
