1. 为什么 MCP 的底层值得单独聊一次MCPModel Context Protocol模型上下文协议这两年被讨论得很多但大多数文章停在“它能接工具、能读文件”这一层。真正动手写一个 MCP Server或者想搞清楚 Cline、Claude Code 这类客户端到底怎么和外部能力对话时绕不开一个更底层的东西JSON-RPC 2.0。MCP 的所有传输机制无论是 stdio 还是 HTTP 流式交换的消息都是 JSON-RPC 2.0 格式。也就是说你看到的“工具调用”“资源读取”“提示模板”在协议层都是一条条methodparamsid的 JSON 消息。理解了这个骨架你排查 MCP 连接失败、工具不显示、initialize 超时这些问题时就不会只盯着客户端界面发呆。这篇是番外篇不讲 MCP 的宏大叙事只做三件事拆开 JSON-RPC 2.0 的消息结构给出在 Cline 里配置settings.json的可复制骨架然后用一次真实的initialize请求验证整条链路是否通。适合已经在用 Cline、想自己接 MCP Server、或者被 JSON-RPC 报错卡住的人。如果你还没配过统一 Key 通道下面会顺带把 TaoToken 的接入方式串进去让请求真正发得出去。2. JSON-RPC 2.0 消息骨架拆解JSON-RPC 2.0 的设计目标就四个字简单、无状态。它用 JSON 当数据格式几乎任何语言都能解析所以 MCP 选它做消息层并不意外。一条请求消息的核心字段只有四个。jsonrpc固定是字符串2.0写错版本号服务器会直接判无效请求。method是要调用的方法名MCP 里常见的有initialize、tools/list、tools/call、resources/list。params是参数可以是数组也可以是对象MCP 基本都用对象。id是请求标识字符串或数字都行服务器响应时会原样带回用来配对请求和响应。请求长这样{ jsonrpc: 2.0, method: initialize, params: { protocolVersion: 2024-11-05, capabilities: {}, clientInfo: { name: cline, version: 1.0.0 } }, id: 1 }成功响应只多一个result字段id保持一致{ jsonrpc: 2.0, result: { protocolVersion: 2024-11-05, capabilities: { tools: {} }, serverInfo: { name: demo-server, version: 0.1.0 } }, id: 1 }出错时result换成error里面带code和message{ jsonrpc: 2.0, error: { code: -32601, message: Method not found }, id: 1 }标准错误码记住几个就够用-32700解析错误、-32600无效请求、-32601方法未找到、-32602参数无效、-32603内部错误。MCP 场景里最常见的是-32601通常意味着你调的方法名拼错了或者 Server 根本没注册这个方法。注意JSON-RPC 2.0 是无状态的每条消息独立。MCP 的会话状态是靠initialize握手后在双方内存里维护的不是靠协议本身。3. TaoToken 前置把统一 Key 通道准备好MCP Server 本身不负责模型推理但很多 MCP 工作流最终要调用大模型。为了让请求有统一的出口我习惯先把 TaoToken 的 Key 通道配好这样 Cline 里的模型调用和 MCP 工具调用走同一套凭证排查问题时变量更少。先去控制台创建一个 API Key。地址是https://taotoken.net/console登录后在 API Keys 页面新建复制出来的 Key 形如sk-开头的一串字符只显示一次记得存好。TaoToken 的 API 入口是https://taotoken.net/api兼容 OpenAI 风格的调用方式。也就是说任何支持自定义 base_url 的客户端把地址填成这个Key 填刚生成的就能通。Cline 里配置模型时也是这个逻辑。如果你更想先验证模型通道是否正常可以打开模型对话页面直接发一句话测试https://taotoken.net/model-chat。这一步不是必须的但能帮你区分“是模型通道不通”还是“是 MCP 配置有问题”排障时非常省时间。长期跑编码任务或者 Agent 工作流的话Coding Plan 会更划算入口在https://taotoken.net/coding-plan。这篇的重点是 MCP 配置所以 Key 准备好就够下面直接进 Cline。4. Cline settings.json 可复制配置骨架Cline 的 MCP 配置写在settings.json里不同系统路径不一样。macOS 一般在~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonWindows 在%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json。文件名可能因版本略有差异认准cline_mcp_settings.json这个关键词。一个最小可用的骨架长这样{ mcpServers: { demo-stdio: { command: node, args: [/absolute/path/to/demo-server/index.js], env: { TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api }, disabled: false, autoApprove: [] } } }几个字段说明一下。command是启动 Server 的可执行程序Node 写的 Server 就填nodePython 的填python3。args是参数数组第一个通常是 Server 入口文件的绝对路径相对路径容易踩坑建议一律用绝对路径。env是注入给 Server 进程的环境变量把 TaoToken 的 Key 和 base_url 放这里Server 内部调用模型时直接读环境变量不用硬编码。disabled设为false表示启用。autoApprove是自动批准的工具列表初期建议留空等确认工具行为安全后再加避免误操作。如果你用的是 HTTP 类型的 MCP Server配置换成url字段{ mcpServers: { demo-http: { url: http://127.0.0.1:3000/mcp, env: { TAOTOKEN_API_KEY: sk-你的Key }, disabled: false } } }改完保存Cline 会自动重载 MCP 配置。如果没重载重启一下 VS Code 窗口。这时候在 Cline 的 MCP 面板里应该能看到demo-stdio这个 Server状态是连接中或已连接。5. 发送 initialize 请求验证连通性配置好之后最关键的一步是确认握手成功。MCP 规定客户端连接后第一条消息必须是initializeServer 返回能力清单双方才算建立会话。如果你有 Server 的源码可以在处理initialize的地方打一行日志把收到的 params 打印出来。然后回到 Cline触发一次 MCP 连接。观察日志应该能看到类似这样的请求进来{ jsonrpc: 2.0, method: initialize, params: { protocolVersion: 2024-11-05, capabilities: { roots: { listChanged: true } }, clientInfo: { name: cline, version: 3.x } }, id: 0 }Server 要回一条结构完整的响应id必须和请求一致{ jsonrpc: 2.0, result: { protocolVersion: 2024-11-05, capabilities: { tools: { listChanged: true } }, serverInfo: { name: demo-server, version: 0.1.0 } }, id: 0 }如果 Cline 面板里 Server 状态变成已连接并且能看到工具列表说明整条链路通了。想更直接一点可以手动用 curl 对 HTTP 类型的 Server 发一条 initializecurl -X POST http://127.0.0.1:3000/mcp \ -H Content-Type: application/json \ -d { jsonrpc: 2.0, method: initialize, params: { protocolVersion: 2024-11-05, capabilities: {}, clientInfo: {name: curl, version: 1.0} }, id: 1 }返回里能看到result.serverInfo就说明 Server 活着且协议实现正确。这一步能过后面tools/list、tools/call基本不会有大问题。6. 本篇常见错误排查连接一直转圈或超时。先看command和args路径对不对绝对路径写错是最常见的原因。Node Server 还要确认node在系统 PATH 里Cline 启动子进程时环境变量可能和终端不一样。可以在终端手动跑一遍node /path/to/index.js看能不能正常启动。报 -32601 Method not found。方法名拼错了或者 Server 没实现initialize。MCP 要求 Server 必须实现initialize如果连这个都返回 -32601说明 Server 的协议层没写对检查路由分发逻辑。报 -32700 Parse error。发出去的 JSON 格式有问题常见于手动 curl 时引号转义错误或者 Server 读 stdin 时没按行分割。stdio 传输要求每条消息一行换行符处理不当就会解析失败。工具列表为空。initialize成功了但tools/list返回空数组检查 Server 是否在capabilities里声明了tools以及工具注册代码是否在握手之后才执行。环境变量读不到。env里配的TAOTOKEN_API_KEY在 Server 里读出来是 undefined多半是 Cline 版本对env字段的支持差异可以改成在args里传参或者用 Server 自己的配置文件。实测下来把 Key 放在env里在多数版本是有效的但值得用一行日志确认。改了配置不生效。Cline 有时不会自动重载手动重启 VS Code 窗口最稳。另外确认改的是cline_mcp_settings.json不是 VS Code 自己的settings.json两个文件容易混。7. 继续往下走把initialize跑通之后下一步就是发tools/list看 Server 暴露了哪些工具再发tools/call实际调一次。这时候如果模型调用也要走统一通道记得 Key 和 base_url 已经在env里配好了Server 内部直接读环境变量即可。需要新建或轮换 Key 的时候去https://taotoken.net/api-keys操作。接入细节和字段说明在文档里https://taotoken.net/doc。如果你更想先确认模型通道本身没问题模型对话页面https://taotoken.net/model-chat发一句话最快。长期跑编码和 Agent 任务Coding Plan 入口在https://taotoken.net/coding-plan按需选就行。JSON-RPC 2.0 这套骨架不复杂难的是把每一层都验证到位。我自己的习惯是每加一个 MCP Server先手动 curl 一条 initialize确认协议层通了再交给 Cline这样出问题时能立刻定位是配置层还是协议层。