1. 为什么 MCP 消息格式总在 Cline 里报错MCPModel Context Protocol模型上下文协议说白了就是让 AI 客户端和外部工具服务端用一套标准话术对话的约定。它规定了客户端能问什么、服务端能答什么、哪些消息不需要回答。适合谁适合正在用 Cline、Claude Code 这类工具接自定义 MCP 服务端却被Invalid request、id must not be null、method not found卡住的开发者。我见过太多人第一次写 MCP 服务端直接把普通 HTTP 接口那套{code:0,data:{}}搬过来结果 Cline 一连就断。原因很简单MCP 底层用的是 JSON-RPC 2.0消息结构有硬性约束字段名、id 规则、result 与 error 互斥一条不符合就整条会话失败。更隐蔽的是能力协商——如果服务端在initialize阶段没声明tools能力客户端根本不会去调tools/list你后面写的工具函数永远收不到请求。这篇是进阶篇 2聚焦两件事三类消息请求、响应、通知到底怎么构造和解析以及能力协商字段清单怎么填。场景落在 Cline MCP 上我会给出可复制的服务端配置片段并用 TaoToken 统一 Key 通道发起一次真实调用把预期返回结构贴出来。你跟着做能跑通一条完整的initialize → tools/list → tools/call链路。先明确一个检索词MCP JSON-RPC 消息格式与能力协商是这篇的核心。你如果搜的是「MCP 请求响应通知区别」「MCP initialize 能力字段」方向一致。三类消息的边界用一句话记请求有 id 且要回响应有 id 且只带 result 或 error 之一通知没有 id 也不回。听起来简单但实际写代码时最容易错的是把通知也塞了 id或者响应里 result 和 error 同时出现。Cline 对这两点零容忍。下面从消息结构逐层拆再进配置和验证。每一步都给完整字段不省略。2. TaoToken 统一 Key 通道前置准备在讲配置之前先把调用通道说清楚。MCP 服务端本身不负责模型推理它只暴露工具真正要跑通「模型决定调哪个工具」这一步需要一个能访问大模型的通道。TaoToken 在这里的角色是统一 Key 通道你用同一个 Key就能在 Cline、Claude Code、Codex 这些客户端里发起模型请求不用为每个客户端单独配一套凭证。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api你需要准备三样东西缺一不可第一一个可用的 API Key。到控制台创建路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面生成。生成后立刻复制页面刷新就看不到了。这一步对应 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。第二确认你要用的 Model ID。不同客户端对模型名的写法略有差异但统一通道下你填的是同一套标识。可以在模型对话页先试一次地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息看返回是否正常确认 Key 和模型都对。第三MCP 服务端的运行环境。这篇用 Node.js 写一个最小服务端通过 stdio 和 Cline 通信。你本地要有 Node 18 以上。Cline 的 MCP 配置走的是客户端配置文件不是环境变量这点和普通 CLI 不同。为什么强调「统一 Key」因为 MCP 场景下客户端既要连模型通道又要连 MCP 服务端两套配置容易混。TaoToken 把模型通道收敛成一个 Base URL 加一个 Key你只需要在客户端里填一次MCP 服务端那边专心处理 JSON-RPC 就行职责分离排障时能快速定位是模型侧还是协议侧的问题。如果你打算长期跑编码类 Agent可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 字段说明以文档为准。前置准备做完下面进真正的配置。记住三件套Base URL、Key、Model ID后面每一处配置都会围绕它们展开。3. 可复制的 MCP 服务端配置与消息构造这一节是全文技术核心给完整可复制的片段。先看 Cline 侧的 MCP 配置再看服务端消息构造。Cline 的 MCP 配置通常写在客户端的 settings 文件里结构是 JSON。下面这段可以直接改路径后用{ mcpServers: { taotoken-demo: { command: node, args: [/Users/yourname/mcp-demo/server.js], env: { TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_MODEL_ID: 你的ModelID } } } }注意三点command是启动命令args是脚本绝对路径env里放三件套。Cline 启动时会用 stdio 拉起这个进程然后开始 JSON-RPC 握手。服务端server.js的最小实现处理三类消息。先看请求解析// server.js const readline require(readline); const rl readline.createInterface({ input: process.stdin }); function send(msg) { process.stdout.write(JSON.stringify(msg) \n); } rl.on(line, (line) { let req; try { req JSON.parse(line); } catch (e) { // 解析失败也不能带 id因为不知道对应哪个请求 send({ jsonrpc: 2.0, error: { code: -32700, message: Parse error } }); return; } // 通知没有 id不回复 if (req.id undefined) { if (req.method notifications/initialized) { // 客户端告知初始化完成这里只记录不回 return; } return; } // 请求有 id必须回 if (req.method initialize) { send({ jsonrpc: 2.0, id: req.id, result: { protocolVersion: 2024-11-05, capabilities: { tools: { listChanged: true } }, serverInfo: { name: taotoken-demo, version: 1.0.0 } } }); return; } if (req.method tools/list) { send({ jsonrpc: 2.0, id: req.id, result: { tools: [ { name: echo_text, description: 回显输入文本, inputSchema: { type: object, properties: { text: { type: string } }, required: [text] } } ] } }); return; } if (req.method tools/call) { const text req.params?.arguments?.text ?? ; send({ jsonrpc: 2.0, id: req.id, result: { content: [{ type: text, text: echo: ${text} }] } }); return; } // 未知方法回 error且不能同时带 result send({ jsonrpc: 2.0, id: req.id, error: { code: -32601, message: Method not found } }); });这段代码把三类消息的规则全落实了通知直接 return 不回复请求按 method 分支回 result未知方法回 error。initialize的返回里capabilities.tools.listChanged就是能力协商字段声明了支持工具列表变更通知。能力协商字段清单对照填类别能力说明Clientroots提供文件系统根目录Clientsampling支持 LLM 采样请求Clientexperimental非标准实验功能Serverprompts提供提示模板Serverresources提供可读资源Servertools暴露可调用工具Serverlogging发送结构化日志Serverexperimental非标准实验功能子能力里listChanged适用于 prompts、resources、tools表示列表变化时发通知subscribe只适用于 resources表示支持订阅单项变更。你如果没实现变更通知就别声明listChanged: true否则客户端等通知等不到会超时。消息构造的硬规则再强调一遍请求 id 不能为 null同一会话不能重复响应必须带与请求相同的 idresult 和 error 二选一通知不能有 id。这三条是 JSON-RPC 2.0 在 MCP 里的落地约束写错一条Cline 直接断连。配置和代码都齐了下一节验证。4. 验证请求与成功返回结构验证分两步先确认 MCP 服务端能被 Cline 拉起并完成握手再确认通过 TaoToken 通道发起的模型调用能触发工具。第一步把server.js放到配置里的路径重启 Cline。打开 MCP 面板应该看到taotoken-demo状态变成已连接。如果没连上看 Cline 的 MCP 日志通常会打印 stderr。第二步手动模拟一次握手确认消息格式对。在终端里跑echo {jsonrpc:2.0,id:1,method:initialize,params:{protocolVersion:2024-11-05,capabilities:{},clientInfo:{name:test,version:1.0}}} | node server.js预期返回{jsonrpc:2.0,id:1,result:{protocolVersion:2024-11-05,capabilities:{tools:{listChanged:true}},serverInfo:{name:taotoken-demo,version:1.0.0}}}看到capabilities.tools就说明能力协商字段生效了。接着测tools/listecho {jsonrpc:2.0,id:2,method:tools/list,params:{}} | node server.js预期返回里result.tools是数组含echo_text。再测tools/callecho {jsonrpc:2.0,id:3,method:tools/call,params:{name:echo_text,arguments:{text:hello mcp}}} | node server.js预期返回{jsonrpc:2.0,id:3,result:{content:[{type:text,text:echo: hello mcp}]}}第三步走 TaoToken 通道做端到端验证。在 Cline 对话框里输入「用 echo_text 工具回显 hello」模型会先请求tools/list再发tools/call。你观察 MCP 日志应该看到两条请求依次进来id 递增返回结构正确。模型侧收到content后会把echo: hello mcp展示出来。这一步能跑通说明三件事同时成立JSON-RPC 消息格式正确、能力协商声明正确、TaoToken 通道的 Base URL 和 Key 配置正确。任何一环错都会在日志里留下痕迹。如果你在模型对话页单独测通道地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条普通消息确认返回正常再回 Cline 测工具调用能更快定位问题在通道还是在协议。验证通过后返回结构里的content数组是标准形态type: text是最常用的一种。你后面扩展工具时返回结构保持一致客户端就能统一解析。5. 本篇常见错误排查这一节对照真实报错逐个拆。报错一id must not be null或Invalid request。原因通常是请求里 id 写成了 null或者干脆没写 id 却当成请求发。JSON-RPC 2.0 基础规范允许 id 为 null但 MCP 明确禁止。检查你的请求构造id 用递增整数或字符串别用 null。通知才不带 id别混。报错二local proxy failed或连接被拒。这个多半出在通道配置。检查 Cline 的 MCP 配置里TAOTOKEN_BASE_URL是否写成https://taotoken.net/api注意结尾没有多余斜杠。Key 是否复制完整有没有前后空格。Model ID 是否和你在模型对话页验证过的一致。三件套任一错模型侧请求就发不出去表现为代理失败。报错三reading choices或返回结构解析失败。这是模型侧返回不符合预期。常见原因是 Model ID 填错或者通道返回的是错误对象而你按成功结构解析。先在模型对话页确认返回正常再回客户端。如果通道返回里带error字段先处理错误别硬读choices。报错四OAuth相关或鉴权失败。检查 Key 是否过期、是否在控制台被删除。重新生成一个更新到配置里重启 Cline。注意 Key 只在生成时可见别用旧截图里的。报错五Method not found。服务端没实现对应 method。对照你的server.js确认initialize、tools/list、tools/call都有分支。Cline 握手时会先发initialize再发notifications/initialized通知无 id然后才tools/list。少一个分支就报这个。报错六响应里 result 和 error 同时出现。这是格式违规。检查你的send调用确保每个分支只走 result 或只走 error。未知方法走 error正常走 result别在同一个响应里都塞。排查顺序建议先看 Cline MCP 日志确认握手到哪一步再用终端 echo 模拟请求确认服务端单独能跑最后查通道三件套。分层定位比一上来就改代码快。如果你用的是 Claude Code 接 Anthropic 风格配置参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 字段名和 Cline 略有差异但三件套逻辑一致。Claude Code 相关入口在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。6. 继续把 MCP 链路跑稳消息格式和能力协商这两块吃透后你扩展 MCP 服务端会顺很多。我的经验是先把initialize的返回字段写全尤其是capabilities客户端靠它决定后续发什么请求再保证三类消息的 id 规则不破最后才去加业务工具。顺序反了排障会很痛苦。下一步你可以试着自己加一个resources能力声明subscribe: true然后实现资源变更通知观察 Cline 是否响应。这一步能帮你彻底理解通知和请求的区别。需要长期跑编码 Agent 的Coding Plan 入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档和字段细节以 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 为准。Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。把server.js里的echo_text换成你真正要暴露的工具inputSchema 写清楚返回结构保持content数组链路就通了。
