Gateway 连接模式
连接 Gateway 前,请先完成 快速开通,自行创建 API Key 并确认所需 MCP Server 和工具权限。
主路由和子路由是两种 URL 路由。“主路由 + 精细化 API Key 权限”使用相同的主路由 URL,通过精细化授权范围限制可发现和调用的服务与工具,仍作为可选择的第三种模式说明。
| 模式 | Gateway URL | 适用场景 |
|---|---|---|
| 主路由 | http://mcpgw.dingtone.xyz/mcp |
聚合全部已授权 MCP Server。 |
| 子路由 | http://mcpgw.dingtone.xyz/mcp/{namespace}/{mcp-server-name} |
固定连接一个 MCP Server。 |
| 主路由 + 精细化 API Key 权限 | http://mcpgw.dingtone.xyz/mcp |
通过精细化 API Key 授权范围限制可发现和调用的服务与工具。 |
三种模式都必须携带 API Key。API Key 权限与其 IP 白名单均适用于主路由和子路由。API Key 只能发现和调用已授权的 MCP Server 和工具。为 API Key 启用 IP 白名单后,只有白名单中的 IP 可访问。
权限规模较大时
Section titled “权限规模较大时”单个 API Key 可访问的 MCP Server 过多时,应按使用场景拆分多个 API Key,并分别授予最小必要权限;固定使用单一服务时,建议子路由。具体接入步骤请参见 配置 Codex。