1. 存量接口接入 MCP 的真实痛点与 Nacos Registry 的定位很多团队手里已经跑着一堆稳定的 HTTP 接口比如天气查询、地址解析、订单状态、库存查询。这些接口在业务系统里活得好好的但一旦想让 AI Agent 去调用问题就来了Agent 不认识你的 REST 接口它只认 MCP 协议。于是摆在面前的路只有两条要么把每个接口重写成 MCP Server要么找一个中间层做协议转换。重写这件事听起来简单做起来很磨人。一个中等规模的业务系统对外暴露的接口动辄几十上百个每个接口都要写 Tool 描述、参数 Schema、调用逻辑、错误处理还要考虑鉴权怎么透传。人力成本先不说改完之后原来的业务代码还得回归测试风险不小。更麻烦的是MCP 协议本身还在快速演进今天写完的 Server 明天可能就要跟着协议版本调整。Nacos 这次发布的 MCP Registry 就是冲着这个场景来的。它把自己定位成控制面负责管理 Tool 的元信息把存量 API 的描述信息存起来然后配合 Higress AI 网关在数据面做协议转换。存量服务本身不需要改一行代码只需要在 Nacos 里补上接口描述Higress 就能把这些 HTTP 接口以 MCP 协议暴露出去。这个思路的核心在于Nacos 本来就已经存了服务的调用地址对于已经用 Nacos 做注册配置中心的团队来说服务发现这一层是现成的。缺的只是接口的语义描述——这个接口叫什么、干什么用、需要什么参数。把这些信息补进 NacosMCP 协议需要的上下文就齐了。我试过在本地把一条高德天气接口通过这套方案暴露成 MCP Tool整个过程没有动高德那边的任何代码也没有写新的服务只是在 Nacos 里加了两条配置Higress 就把它转成了 MCP 协议。Agent 调用的时候先拿出口 IP再查 adcode最后查天气三步串起来跑通了。适合谁看这篇手里有存量 HTTP 接口、想让 AI Agent 调起来、又不想大改代码的后端和平台同学。下面我会把 Nacos 注册服务、写 Tool 描述、配 Higress、接 TaoToken 统一 Key 这条链路完整走一遍每一步都给可复制的配置。2. TaoToken 统一 Key 通道的前置准备与 MCP 鉴权思路存量接口转成 MCP 之后紧接着要解决的是鉴权问题。原来的 HTTP 接口可能有自己的 API Key、Token 或者签名机制Agent 调用 MCP Tool 的时候这些凭证怎么传、怎么管是个绕不开的环节。一种做法是把每个上游服务的 Key 都硬编码在 Higress 的配置里但这样 Key 散落在各处轮换和审计都麻烦。另一种做法是引入一个统一的 Key 通道让 MCP 调用链路上的鉴权收敛到一个地方。TaoToken 在这里扮演的就是统一 Key/API 通道的角色它提供兼容 OpenAI 风格的接口入口MCP 工具调用时可以通过它来统一管理凭证和请求转发。先明确几个地址后面配置会用到官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基地址https://taotoken.net/api模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Plan 页https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 接入https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite前置准备分三步。第一步在 TaoToken 控制台创建一个 API Key这个 Key 后面会作为 MCP 调用链路上的统一凭证。第二步确认本地已经能跑 Nacos 和 Higress如果还没装下面会给 Docker 和 Kind 的命令。第三步想清楚你要暴露哪几个存量接口把它们的路径、方法、参数整理出来后面写 Tool 描述的时候直接填。鉴权思路是这样的Higress 在把 MCP 的 tool/call 转成后端 HTTP 请求时会从 Nacos 的配置里读取凭证引用credentialRef把对应的 Key 注入到请求里。对于走 TaoToken 通道的调用凭证就是 TaoToken 的 API KeyBase URL 指向 https://taotoken.net/api。这样上游服务的真实 Key 不需要暴露给 AgentAgent 侧只需要拿到 MCP Server 的地址就能调用。有一点要注意TaoToken 在这里是作为统一的 API 通道和 Key 管理入口不是替代 Nacos 或 Higress 的角色。Nacos 管 Tool 元信息Higress 做协议转换TaoToken 管凭证和请求转发三者各司其职。3. 可复制的 Nacos Registry 配置与 MCP 服务注册片段这一节是整篇的核心所有配置都可以直接复制。我按顺序来先起 Nacos再起 Higress然后注册服务、写 Tool 描述、配鉴权。3.1 启动 Nacos 并设置鉴权变量用 Docker 起一个单机版 Nacos注意鉴权相关的环境变量要设好export NACOS_AUTH_TOKEN你的token的base64编码 export NACOS_AUTH_IDENTITY_VALUE你的IDENTITY_VALUE docker run -td \ -e PREFER_HOST_MODEhostname \ -e MODEstandalone \ -e NACOS_AUTH_IDENTITY_KEYserverIdentity \ -e NACOS_AUTH_IDENTITY_VALUE${NACOS_AUTH_IDENTITY_VALUE} \ -e NACOS_AUTH_TOKEN${NACOS_AUTH_TOKEN} \ -p 8848:8848 -p 9848:9848 \ nacos/nacos-serverNACOS_AUTH_TOKEN 需要是原始内容的 base64 编码结果IDENTITY_VALUE 用任意英文数字组合即可。启动后访问 8848 端口能看到控制台就说明 OK。3.2 用 Kind 部署 Higress 并连接 Nacos本地用 Kind 起一个 K8s 集群然后装 Higress# 安装 kind [ $(uname -m) x86_64 ] curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.27.0/kind-linux-amd64 [ $(uname -m) aarch64 ] curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.27.0/kind-linux-arm64 chmod x ./kind sudo mv ./kind /usr/local/bin/kind # 创建集群 kind create cluster # 获取 hgctl 并安装 Higress curl -Ls https://raw.githubusercontent.com/alibaba/higress/main/tools/hack/get-hgctl.sh | bash hgctl install --set profilelocal-k8s # 安装 kubectl curl -LO https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl chmod x ./kubectl sudo mv ./kubectl /usr/bin/kubectl # 起一个 redis 给 Higress 用 docker run --name higress-redis -d redis然后改 Higress 的 ConfigMap让它连上 Nacoskubectl -n higress-system edit cm higress-config在 data.higress 里增加 mcpServer 段完整片段如下apiVersion: v1 data: higress: |- mcpServer: sse_path_suffix: /sse enable: true redis: address: {local_ip}:6379 match_list: - match_rule_domain: * match_rule_path: /registry match_rule_type: prefix servers: - name: nacos-registry type: nacos-mcp-registry path: /registry config: serverAddr: {local_ip} namespace: serviceMatcher: amap: .* ip: .* downstream: connectionBufferLimits: 32768 http2: initialConnectionWindowSize: 1048576 initialStreamWindowSize: 65535 maxConcurrentStreams: 100 idleTimeout: 180 maxRequestHeadersKb: 60 routeTimeout: 0 upstream: connectionBufferLimits: 10485760 idleTimeout: 10把 {local_ip} 替换成本机地址用ifconfig eth0 | grep inet | grep -v 127.0.0.1 | awk {print $2}可以拿到。保存后 Higress 会重新加载配置。3.3 注册存量服务到 Nacos以高德开放接口为例先把域名注册进 Nacoscurl -X POST http://127.0.0.1:8848/nacos/v1/ns/instance?serviceNameamapgroupNameamapiprestapi.amap.comport80ephemeralfalse再注册一个获取出口 IP 的服务curl -X POST http://127.0.0.1:8848/nacos/v1/ns/instance?serviceNameipgroupNameipipipinfo.ioport80ephemeralfalse注册完在 Nacos 控制台的服务列表里能看到实例数为 1。3.4 写 Tool 描述配置在 Nacos 配置中心新建 DataId 为 amap-mcp-tools.json、分组为 amap 的配置{ protocol: http, tools: [ { name: get_weather, description: get weather, inputSchema: { type: object, properties: { city: { type: string, description: city adcode } } } }, { name: get_adcode, description: get adcode via address, inputSchema: { type: object, properties: { address: { type: string, description: address } } } }, { name: get_address_via_ip, description: get address via ip, inputSchema: { type: object, properties: { ip: { type: string, description: ip address } } } } ], toolsMeta: { get_weather: { credentialRef: amap-key.json, InvokeContext: { path: /v3/weather/weatherInfo, method: GET } }, get_adcode: { credentialRef: amap-key.json, InvokeContext: { path: /v3/geocode/geo, method: GET } }, get_address_via_ip: { credentialRef: amap-key.json, InvokeContext: { path: /v3/ip, method: GET } } } }再建一个 DataId 为 amap-key.json、分组为 amap 的配置放高德的 Key{ type: fixed-query-token, credentialsMap: { key: key, value: 你的高德API Key } }IP 服务的 Tool 描述类似DataId 为 ip-mcp-tools.json、分组为 ip{ protocol: http, tools: [ { name: get_current_ip_address, description: get current callers ip address, inputSchema: { type: object, properties: { empty_args: { type: string, description: should be empty } } } } ], toolsMeta: { get_current_ip_address: { InvokeContext: { path: /, method: GET } } } }3.5 接入 TaoToken 统一 Key 通道如果希望 MCP 调用链路上的凭证统一走 TaoToken可以在 Higress 的凭证配置里把 Base URL 指向 TaoToken 的 API 地址Key 用 TaoToken 控制台创建的 API Key。以 OpenAI 兼容的调用方式为例配置片段如下{ type: fixed-header-token, credentialsMap: { Authorization: Bearer 你的TaoToken API Key }, baseUrl: https://taotoken.net/api }这样 Agent 侧调用 MCP Tool 时请求会经过 TaoToken 通道转发上游服务的真实 Key 不需要暴露。TaoToken 的 API Key 在控制台的 API Keys 页面创建接入细节可以参考接入文档。4. 端到端验证从 MCP Client 调用到成功返回配置写完接下来验证整条链路能不能跑通。我用 Cursor 作为 MCP Client 来演示其他支持 MCP 的客户端配置方式类似。4.1 配置 MCP Client在 Cursor 的设置里找到 MCP Server 配置填入 Higress 暴露的 SSE 地址{ mcpServers: { nacos-registry: { url: http://localhost/registry/sse } } }保存后Cursor 会去拉取 Tool 列表。如果配置正确你能在 MCP 面板里看到 get_weather、get_adcode、get_address_via_ip、get_current_ip_address 这几个 Tool。4.2 发起一次完整调用在 Agent 模式里问一句「今天天气怎么样」。Agent 的调用链是这样的第一步调用 get_current_ip_address拿到当前主机的出口 IP。这个请求经过 Higress 转成对 ipinfo.io 的 HTTP 调用返回 IP 地址。第二步用这个 IP 调用 get_address_via_ip拿到省市信息。第三步用省市信息调用 get_adcode拿到城市的 adcode。第四步用 adcode 调用 get_weather拿到天气数据。整个过程 Agent 不需要知道高德的接口长什么样它只看到 MCP Tool 的描述和参数。Higress 在背后把每次 tool/call 的 JSON-RPC 请求解析出来根据 Nacos 里配的 InvokeContext 生成对应的 HTTP 请求转发到 restapi.amap.com再把结果包装成 MCP 的返回格式。4.3 验证成功的结果如果一切正常Agent 会返回类似「当前城市天气晴温度 25 度」这样的结果。你可以在 Higress 的日志里看到每次协议转换的记录确认请求确实经过了 Nacos 的 Tool 描述和 Higress 的转发。如果走的是 TaoToken 统一 Key 通道可以在 TaoToken 控制台的调用记录里看到对应的请求确认鉴权链路是通的。这一步跑通说明存量 HTTP 接口到 MCP 协议的完整链路已经打通而且没有改任何存量代码。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中容易踩的坑集中在几个报错上我按实际遇到的顺序列一下。401 Unauthorized最常见的是 Nacos 的鉴权变量没设对。NACOS_AUTH_TOKEN 必须是 base64 编码后的结果直接填原始字符串会报错。另外 Higress 连 Nacos 时如果 serverAddr 填错也会出现鉴权失败。检查 ConfigMap 里的 serverAddr 是不是本机 IPnamespace 是不是空字符串。local proxy failed这个报错通常出现在 MCP Client 连 Higress 的时候。先确认 Higress 的 mcpServer.enable 是不是 truesse_path_suffix 是不是 /sse。然后检查 match_list 里的 match_rule_path 和 servers 里的 path 是否一致我这里都配的是 /registry。如果 Redis 没起Higress 的 MCP Server 也会起不来确认 higress-redis 容器在跑。reading choices 相关报错如果 MCP Client 在拉取 Tool 列表时报这个多半是 Tool 描述配置的 JSON 格式有问题。检查 amap-mcp-tools.json 里的 tools 数组和 toolsMeta 对象是否对应每个 Tool 的 name 在 toolsMeta 里都要有对应的 InvokeContext。JSON 里多一个逗号或者少一个括号都会导致解析失败。OAuth 相关报错如果 MCP Client 要求 OAuth 认证而你的 Higress 没配会出现认证失败。本地验证阶段可以先在 Client 侧关掉 OAuth 要求或者确认 Higress 的 MCP Server 配置里没有强制认证。如果走 TaoToken 通道确认 API Key 是有效的Authorization 头的格式是 Bearer 加空格加 Key。还有一个容易忽略的点Nacos 里注册的服务实例如果是临时实例ephemeraltrueNacos 重启后实例会丢。我这里用的是 ephemeralfalse持久化实例重启后还在。排查的时候建议按链路顺序来先确认 Nacos 里服务实例在不在再确认 Tool 描述配置有没有生效然后看 Higress 的日志有没有协议转换记录最后看 MCP Client 侧能不能拉到 Tool 列表。哪一步断了就查哪一步。6. 长期编码与 Agent 场景下的通道选择把存量接口通过 Nacos MCP Registry 暴露出去之后日常使用会分成两类场景。一类是临时验证比如想快速试一下某个接口能不能被 Agent 调起来这种用模型对话页就够了配好 MCP Server 地址直接问。另一类是长期跑编码和 Agent 任务比如让 Agent 持续调用一批内部接口做自动化这种对通道的稳定性和 Key 管理要求更高。如果只是验证模型和 Tool 的配合效果可以直接在模型对话页里试地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite。想快速拿到 Key 开始接去 API Keys 页面创建地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。接入过程中遇到配置问题接入文档里有各语言的示例地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。如果是长期跑编码和 Agent 任务Coding Plan 更适合地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。Claude Code 的接入方式单独有一页地址是 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite。控制台里可以统一管理 Key 和查看调用记录地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite。最后说一个实际用下来的经验Nacos 里 Tool 描述写得好不好直接决定 Agent 能不能正确调用。description 字段别写太泛参数说明要具体到格式和取值范围。我一开始把 get_weather 的 city 参数描述写成「城市」Agent 经常传城市名而不是 adcode后来改成「city adcode例如 110000」就稳定了。Tool 描述是给模型看的写得越清楚调用成功率越高。