1. MCP 是什么为什么你的 JSON-RPC 请求总报 401如果你最近在折腾 Claude Code、Codex 或者自己写的 AI IDE大概率听过 MCPModel Context Protocol这个词。简单说MCP 是一套让大模型和外部工具、数据源对话的开放标准你可以把它理解成「AI 世界的 USB-C 接口」——不管对面是本地文件、数据库还是远程 API只要按 MCP 协议封装成 Server任何支持 MCP 的 Host比如 Claude Desktop、各类 IDE都能即插即用。它适合谁三类人最该关注一是想把公司内部系统接进 AI 工作流的后端同学二是用 Claude Code 做长期编码、想让模型直接读项目文件的开发者三是自己写 Agent、被 tool.invoke 的鉴权问题卡住的玩家。我实测下来90% 的「JSON-RPC 请求报错」根本不是协议写错了而是模型 API 通道没配通——Host 拿不到合法的模型凭证Sampling 弹窗自然报 401。这篇就按「先讲清 MCP 核心概念 → 再用 TaoToken 把模型通道配通 → 最后跑通一次 tool.invoke」的顺序来每一步都能直接复制。你不需要先成为协议专家跟着配完再回头看概念会顺很多。2. 先把 MCP 的三个核心概念捋直2.1 Host、Client、Server 到底谁管谁MCP 用的是经典客户端-服务器架构但多了一层 Host。用一句话区分MCP Host你实际在用的那个应用比如 Claude Desktop、VS Code 插件、你自研的 AI 工具。它负责发起整个会话。MCP ClientHost 内部的一对一连接器每个 Client 只连一个 Server负责把请求翻译成 JSON-RPC 发出去。MCP Server轻量服务程序把本地文件、数据库、远程 API 包装成标准能力暴露出来。所以链路是Host → Client → Server。你遇到的 401通常发生在 Host 调用模型这一步而不是 Client 和 Server 之间——这点很关键后面排障会反复用到。2.2 Roots 和 Sampling一个管边界一个管确认Roots是权限边界。Client 通过 Roots 告诉 Server「你只能看这个项目目录别碰我的私人文档。」典型写法就是限定一个仓库路径或 API 端点。Sampling是交互触发机制。当 Server 要执行敏感操作改数据、调高权限工具时会反向请求 Client 确认。Client 可以弹窗让用户点「允许」也可以自动调模型判断合理性。很多人以为 Sampling 报错是 Server 的问题其实它依赖 Host 侧的模型通道——通道不通确认流程直接 401。2.3 Transport 和 JSON-RPC消息长什么样Transport 定义连接方式主流三种通信方式特点典型场景STDIO基于命令行简单本地工具集成、shell 脚本调用SSE服务器单向推流实时日志同步、轻量通信Streamable HTTP双向流式将替代 SSE分布式部署、高并发交互数据格式统一用 JSON-RPC 2.0。一次工具调用请求长这样{ jsonrpc: 2.0, method: tool.invoke, params: { toolName: weatherAPI, city: Beijing }, id: 12345 }Server 侧则通过 Resources资源、Prompts提示词模板、Tools工具调用三大能力对外服务。Tools 最有扩展性让模型从「被动回答」升级成「主动执行」。3. TaoToken 前置把模型通道先配通概念清楚了回到最痛的问题Host 调模型报 401。原因是 Host 需要一个合法的模型 API 端点而很多人直接填了官方地址却没配好鉴权或者用了不稳定的通道。我的做法是统一走 TaoToken 的 API 通道它兼容主流协议配置简单。先拿 Key。打开控制台进入 API Keys 页面创建一个新 Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpcAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpc创建后复制那串sk-开头的 Key只显示一次先存到环境变量里别硬编码进代码export TAOTOKEN_API_KEYsk-你的KeyAPI 基础地址统一用https://taotoken.net/api注意这个地址不带任何查询参数干净接入。如果你要长期跑编码 Agent建议直接看 Coding Plan额度更划算Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpc4. 可复制配置让 MCP Host 走通模型通道4.1 环境变量与基础配置不同 Host 配置位置不一样但核心就三样API 地址、Key、模型名。以常见的 OpenAI 兼容配置为例export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY$TAOTOKEN_API_KEY如果你用的是 Claude Code 这类工具配置里填 Anthropic 兼容端点即可文档里有对应说明接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpcClaude Code 接入https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpc4.2 一个最小 MCP Server 配置示例假设你有一个本地 MCP Server用 STDIO 方式启动Host 配置大致如下{ mcpServers: { local-tools: { command: python, args: [-m, my_mcp_server], env: { OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的Key } } } }关键点把模型通道的环境变量透传给 Server 进程。很多 401 就是因为 Server 子进程读不到 KeySampling 时拿不到凭证。4.3 验证模型通道是否通配完先别急着跑 MCP单独验证模型通道。用 curl 打一次对话接口curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里有choices字段就说明通道通了。这一步过了再去跑 MCP 的 tool.invoke成功率会高很多。想先在网页上试模型效果可以直接用模型对话模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpc5. 验证请求跑通一次 tool.invoke通道通了现在验证 MCP 链路。启动你的 Host触发一次工具调用。以天气工具为例期望的 JSON-RPC 请求和响应如下。请求{ jsonrpc: 2.0, method: tool.invoke, params: { toolName: weatherAPI, city: Beijing }, id: 12345 }成功响应{ jsonrpc: 2.0, id: 12345, result: { city: Beijing, temperature: 18C, condition: clear } }如果 Sampling 环节弹出了确认框点允许后能正常返回说明整条链路——Host 鉴权、Client 转发、Server 执行——全部打通。实测下来这一步能过后面接数据库、接内部 API 都是同样的套路。6. 本篇常见错排查6.1 401 Unauthorized最常见。三个检查点Key 是否复制完整有没有多余空格环境变量是否透传到 Server 子进程Base URL 是否写成了带路径的地址。注意 API 地址就是https://taotoken.net/api不要自己拼/v1之外的路径。6.2 Sampling 弹窗不出现或直接失败Sampling 依赖 Host 侧的模型通道。如果 Host 没配模型凭证确认流程会静默失败。回到第 4 步先确保模型通道单独能通。6.3 tool.invoke 返回 method not found说明 Server 没注册这个工具或者工具名拼错。检查 Server 的 Tools 定义name字段要和请求里的toolName完全一致大小写敏感。6.4 STDIO 模式下进程启动即退出多半是command或args写错或者 Python 模块路径不对。先在终端手动执行一遍python -m my_mcp_server确认能起来再填进配置。6.5 Streamable HTTP 连接超时如果你用的是 HTTP 类 Transport检查 Server 是否真的监听了对应端口以及防火墙是否放行。本地调试优先用 STDIO排障成本最低。7. 下一步把通道固定下来再深入协议MCP 的细节远不止这些连接生命周期、消息校验、Roots 动态更新都值得深挖。但对大多数开发者来说第一步永远是「让模型通道稳定可用」。通道不稳再漂亮的协议设计也跑不起来。建议你现在就做两件事一是把 Key 和 Base URL 固化到项目配置里别再手动填二是如果打算长期跑编码 Agent直接上 Coding Plan省得频繁换 Key。通道配通之后回头再看 Roots 和 Sampling你会发现它们的设计逻辑其实非常清晰——一个管「能碰什么」一个管「碰之前问不问」。接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpcAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpcCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmcp_jsonrpc