操作场景
当您需要将已有的注册中心或域名服务中的服务批量接入 AI 网关时,可以通过配置服务来源,实现 服务的自动同步和统一管理。服务来源分为两种类型:
MCP 注册中心:对接注册中心(如 TSF Nacos),同步原生 MCP Server,实现 MCP Tool 自动发现。
私有 DNS:接腾讯云 Private DNS 进行域名解析,适用于通过域名访问的服务场景。
前置条件
已开通 腾讯云 AI 网关服务
已创建 AI 网关实例
注册中心实例与网关实例在同一 VPC 网络
操作步骤
步骤1:进入服务来源配置页面
1. 登录 腾讯云 AI 网关控制台;
2. 在左侧导航栏,选择 服务管理 > 服务来源;
3. 单击 新建 按钮。
步骤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 定义将自动发现并在控制台展示。
服务实例变更时,网关自动感知并更新。
场景二:配置私有 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。
同一个 Private DNS 解析多个不同的域名。
Q3: 服务来源配置错误导致同步失败,如何排查?
A: 请按以下步骤排查:
1. 进入服务来源详情页,查看错误信息;
2. MCP 注册中心:检查用户名/密码是否正确,Nacos 实例是否可访问;
3. 私有 DNS:检查域名解析记录是否正确配置;
4. 查看 AI 网关日志获取详细错误信息。