MCP协议实战：30分钟给Claude接上你公司的内部API｜TaoToken统一Key通道

1. 为什么要把公司内部 API 接给 Claude大模型本身不知道你公司内部的业务数据也调不动你内部的订单、用户、工单系统。过去常见的做法是让业务同学把数据导出来再复制粘贴到对话框里数据量一大就崩还容易把敏感字段带出去。MCPModel Context Protocol解决的正是这件事它给模型和外部服务之间定了一套标准协议你只要写一个适配层把内部 API 包装成 MCP ServerClaude 就能在需要的时候自动调用不用你写一堆提示词去教它怎么调接口。这篇文章聚焦一个具体场景用 Node.js SDK 把公司内部 API 封装成 MCP Server让 Claude 通过 TaoToken 统一 Key 通道来调用。适合谁适合已经能用 Claude 写代码、但还没打通内部系统的后端或全栈同学。你不需要改内部 API 的任何代码只需要新增一个代理服务把工具函数注册进去再在 Claude 侧配置好连接地址即可。我试过把代理服务直接跑在本地开发机上Claude 侧通过公网地址访问结果因为内网隔离一直连不上后来把服务放到能同时访问公网和内网的机器上才通。所以下面会重点讲清楚网络位置和 Key 通道这两件事避免你重复踩坑。整条链路是这样的Claude 发起请求 → TaoToken 统一 Key 通道转发 → 你的 MCP Server → 公司内部 API → 结果原路返回。TaoToken 在这里承担的是统一入口和 Key 管理的角色你不需要在 Claude 侧硬编码多个厂商的 Key也不用为每个内部工具单独配一套鉴权。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 两个地址分工不同后面配置会用到。2. TaoToken 前置准备与 MCP Server 项目初始化在写代码之前先把 TaoToken 侧的 Key 准备好。打开 https://taotoken.net/api-keys 创建一个 API Key记下它的值。这个 Key 就是你后面在 MCP Server 里调用模型、以及在 Claude 侧做统一鉴权用的凭证。注意不要把它提交到 Git 仓库建议放在环境变量里。接着初始化 Node.js 项目。MCP 官方提供了 SDK我们直接用不用从零实现协议。命令如下mkdir claude-mcp-proxy cd claude-mcp-proxy npm init -y npm install modelcontextprotocol/sdk express cors zod这里装的是modelcontextprotocol/sdk它是官方维护的 MCP 服务端 SDK比早期社区包更稳定。zod用来做参数校验express和cors负责把 MCP 接口暴露成 HTTP 端点。装完之后在项目根目录建一个server.js再建一个.env文件放敏感配置TAOTOKEN_API_KEY你的TaoTokenKey INTERNAL_API_BASEhttps://internal-api.your-company.com INTERNAL_API_TOKEN你的内部API令牌 MCP_PORT3000.env不要提交.gitignore里加上它。这一步做完项目骨架就有了。接下来要做的就是把内部 API 包装成 MCP 工具函数注册到 Server 里。工具函数的本质是一个带 schema 的函数schema 告诉 Claude 这个工具叫什么、需要哪些参数handler 负责真正去调内部 API。这里有个关键点MCP Server 本身不负责模型调用它只负责暴露工具。模型调用是 Claude 侧通过 TaoToken 通道发起的。所以你的 MCP Server 只需要关心“工具怎么执行”不需要关心“模型怎么选”。这样职责清晰后面排查问题也容易定位是工具侧还是模型侧。3. 可复制的 MCP Server 配置与工具函数注册先写server.js的完整骨架。下面这段代码可以直接复制改掉内部 API 地址和令牌即可运行import { McpServer } from modelcontextprotocol/sdk/server/mcp.js; import { StreamableHTTPServerTransport } from modelcontextprotocol/sdk/server/streamableHttp.js; import express from express; import cors from cors; import { z } from zod; import dotenv/config; const app express(); app.use(cors()); app.use(express.json()); const server new McpServer({ name: internal-api-proxy, version: 1.0.0, }); // 工具一查询内部用户数据 server.tool( query_internal_user_data, 根据用户ID查询公司内部用户信息, { user_id: z.string().describe(要查询的用户ID) }, async ({ user_id }) { const res await fetch( ${process.env.INTERNAL_API_BASE}/users/${user_id}, { headers: { Authorization: Bearer ${process.env.INTERNAL_API_TOKEN}, }, } ); if (!res.ok) { return { content: [{ type: text, text: 内部API返回 ${res.status} }], isError: true, }; } const data await res.json(); return { content: [{ type: text, text: JSON.stringify(data) }] }; } ); // 工具二查询订单统计 server.tool( query_order_statistics, 按日期范围查询订单统计数据, { start_date: z.string().describe(开始日期格式YYYY-MM-DD), end_date: z.string().describe(结束日期格式YYYY-MM-DD), }, async ({ start_date, end_date }) { const res await fetch( ${process.env.INTERNAL_API_BASE}/orders/statistics?start${start_date}end${end_date}, { headers: { Authorization: Bearer ${process.env.INTERNAL_API_TOKEN}, }, } ); const data await res.json(); return { content: [{ type: text, text: JSON.stringify(data) }] }; } ); // 暴露 MCP 端点 app.post(/mcp, async (req, res) { const transport new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, }); res.on(close, () transport.close()); await server.connect(transport); await transport.handleRequest(req, res, req.body); }); const PORT process.env.MCP_PORT || 3000; app.listen(PORT, () { console.log(MCP Server 运行在 http://localhost:${PORT}/mcp); });这段代码里有两个工具分别对应内部用户查询和订单统计。server.tool的第一个参数是工具名第二个是描述第三个是 zod schema第四个是 handler。Claude 会根据描述和 schema 自动决定什么时候调、传什么参数你不需要写提示词去引导。启动服务node server.js看到MCP Server 运行在 http://localhost:3000/mcp就说明起来了。如果你要部署到服务器把MCP_PORT改成对外端口并确保这台机器能同时访问公网和内网。内网访问是必须的否则 Claude 的请求到了你的 handler 却调不通内部 API。接下来是 Claude 侧的连接配置。如果你用的是 Claude Code可以在项目根目录建.mcp.json{ mcpServers: { internal-api: { type: http, url: https://your-mcp-server.com/mcp, headers: { Authorization: Bearer 你的TaoTokenKey } } } }如果你用的是 Cline 或 Claude Desktop配置结构类似把url换成你的 MCP Server 公网地址headers里带上 TaoToken 的 Key。这里 Base URL、Key、Model ID 三件套要写全Base URL 用 https://taotoken.net/api Key 用你在 api-keys 页面创建的那个Model ID 按你实际使用的模型填。三件套缺一个都会导致连接失败。4. 验证请求与成功结果确认配置写完之后先别急着在 Claude 里问复杂问题用 curl 直接打 MCP 端点确认服务本身是通的curl -X POST https://your-mcp-server.com/mcp \ -H Content-Type: application/json \ -H Authorization: Bearer 你的TaoTokenKey \ -d { jsonrpc: 2.0, id: 1, method: tools/list, params: {} }如果返回里能看到query_internal_user_data和query_order_statistics两个工具说明 MCP Server 注册成功。这一步很关键很多人跳过它直接去 Claude 里问结果报错分不清是工具没注册还是模型没连上。接着在 Claude Code 里发一条测试消息帮我查一下用户ID为12345的用户信息以及2026年4月的订单统计。正常情况下Claude 会先调用query_internal_user_data参数user_id12345拿到结果后再调用query_order_statistics参数start_date2026-04-01、end_date2026-04-30最后把两个结果整合成一段自然语言回答。整个过程你不需要手动指定调哪个工具MCP 协议会自动完成参数提取和格式转换。如果你在 Claude Code 里看到工具调用日志类似Calling tool: query_internal_user_data就说明链路通了。实测下来从发起请求到拿到整合结果通常在两三秒内完成取决于内部 API 的响应速度。如果内部接口本身慢可以在 handler 里加超时控制和缓存后面排障部分会讲。验证模型通道是否走的是 TaoToken可以在 TaoToken 控制台 https://taotoken.net/console 看调用记录。如果记录里能看到对应的请求说明 Key 通道生效了。这一步能帮你确认问题出在模型侧还是工具侧。5. 本篇常见错误排查清单401 Unauthorized最常见的原因是 Key 没带对或过期。检查三处MCP Server 的.env里TAOTOKEN_API_KEY是否正确Claude 侧.mcp.json的headers.Authorization是否带了Bearer前缀TaoToken 控制台里这个 Key 是否被禁用。如果三处都对还报 401去 https://taotoken.net/api-keys 重新生成一个 Key 再试。local proxy failed这个报错通常出现在 Claude Code 或 Cline 侧意思是本地代理连不上你配置的 MCP 地址。先确认url是不是公网可访问的本地localhost在 Claude 侧是访问不到的。再确认 MCP Server 进程还在跑curl能通。如果用了反向代理检查代理有没有把/mcp路径转发到正确的端口。Error reading choices / 返回体解析失败多半是 MCP Server 返回的格式不对。MCP 要求返回content数组每项带type和text。如果你直接return data而不是包成{ content: [{ type: text, text: ... }] }Claude 侧就会解析失败。对照第 3 节的 handler 写法检查。OAuth 相关报错如果你在 Claude 侧配置时选了 OAuth 模式但 MCP Server 没实现 OAuth 流程就会卡住。简单做法是先用Authorizationheader 方式不要选 OAuth。等基础链路通了再考虑加 OAuth。工具调用超时内部 API 响应慢导致。在 handler 里加AbortController控制超时比如 30 秒超时后返回明确的错误信息而不是让请求一直挂着。同时可以在 MCP Server 前面加一层缓存相同参数的查询直接返回缓存结果。内网访问不通MCP Server 部署在公网机器上但内部 API 只在内网可达。解决办法是把 MCP Server 部署到能同时访问公网和内网的机器上或者通过内网穿透把内部 API 暴露给 MCP Server。注意不要为了图省事把内部 API 直接暴露到公网。参数校验失败zod schema 写得太松或太紧都会出问题。比如日期格式schema 里写了YYYY-MM-DD但 Claude 传了2026/04/01就会校验失败。可以在 handler 里再做一层业务校验把格式统一后再调内部 API。6. 把通道固定下来后续扩展更省事基础链路跑通之后建议把 TaoToken 的 Key 和 MCP Server 地址固定成团队内部的配置模板。新同学接入时只需要改.env里的内部 API 令牌其他都不用动。这样每次加新工具只是在server.js里多注册一个server.toolClaude 侧不用改任何配置。如果你后续要接更多内部系统比如知识库、工单、通知可以按同样的模式继续加工具函数。每个工具保持职责单一描述写清楚schema 写严谨Claude 的调用准确率会高很多。长期做编码和 Agent 场景的话可以考虑用 Coding Plan 把模型调用和工具调用统一管理起来入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要查模型对话和调试的走 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到配置问题先翻文档大部分报错都有对应说明。Claude Code 相关的接入细节可以看 https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句MCP Server 前面一定要加鉴权不要裸奔在公网上。哪怕只是内部工具也可能被扫描到。用 TaoToken 的 Key 做一层统一校验再在服务层加 IP 白名单基本就稳了。