微信读书 MCP Server 配置 TaoToken：Claude Desktop 接入与 settings.json 骨架
1. 微信读书 MCP Server 为什么要走 TaoToken 通道微信读书 MCP Server 是一个把书架、笔记、划线数据暴露给大模型客户端的工具支持get_bookshelf、search_books、get_book_notes_and_highlights三个核心工具。Claude Desktop 通过 MCP 协议调用这些工具后你就能用自然语言问「帮我整理《思考快与慢》的笔记」模型会自动去拉取数据再组织答案。但实际用起来会遇到一个现实问题Claude Desktop 本身要连模型服务微信读书 MCP Server 又要连微信读书接口两边的 Key、地址、额度分散管理换一个客户端就得重新配一遍。如果你同时用 Claude Desktop、Cursor、Cline 这些支持 MCP 的客户端配置会越堆越乱。TaoToken 在这里的角色是统一 Key/API 通道把模型请求收敛到一个入口MCP Server 的环境变量里只保留一套凭证。这样你在 Claude Desktop 的settings.json里配置一次后续换客户端或加新 MCP Server 时通道层不用动。适合已经有 Node.js 环境、想让 MCP Server 走统一通道的开发者。这篇会交付一份可直接复制的settings.json骨架并逐步验证三件事MCP Server 能启动、Claude Desktop 能识别工具、请求确实经过 TaoToken 通道发出。2. 前置准备Node.js 环境与 TaoToken Key2.1 确认 Node.js 版本微信读书 MCP Server 要求 Node.js 16.x 或更高。先在终端确认node -v npm -v如果版本低于 16去 Node.js 官网下载 LTS 版本覆盖安装。装完后node -v应输出v18.x或v20.x。这一步不能跳过npx -y mcp-server-weread在低版本 Node 上会直接报语法错误。2.2 获取 TaoToken API Key打开 TaoToken 控制台在 API Keys 页面创建一个新 Key。建议按用途命名比如claude-desktop-mcp方便后续排查是哪个客户端在调用。创建后立即复制页面刷新后不再完整显示。TaoToken 的 API 入口是https://taotoken.net/api这个地址在配置里会作为base_url或环境变量出现。注意区分官网地址和 API 地址配置里填的是 API 地址。2.3 微信读书 Cookie 的两种来源MCP Server 需要微信读书的登录态才能拉数据。有两种方式方式一是直接提供WEREAD_COOKIE。用 Chrome 登录微信读书网页版按 F12 打开开发者工具切到 Network 标签刷新页面找到weread.qq.com的请求在 Headers 里复制完整的 Cookie 字段值。方式二是用 CookieCloud 自动同步。装好浏览器插件后服务器地址填默认的https://cc.chenge.ink或自建地址同步域名关键词填weread保存后手动同步一次。然后在配置里填CC_URL、CC_ID、CC_PASSWORD三个变量。配置了 CookieCloud 后系统会优先用它获取 Cookie失败才回退到WEREAD_COOKIE。注意Cookie 属于敏感凭证不要提交到 Git 仓库也不要在公开渠道粘贴。建议放在本地配置文件或系统环境变量里。3. 可复制的 settings.json 配置骨架3.1 Claude Desktop 配置文件位置Claude Desktop 的 MCP 配置不在应用界面里直接编辑而是读写本地文件macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.json你也可以从 Claude Desktop 菜单进入 Settings - Developer - Edit Config它会自动打开这个文件。下面统一称它为settings.json。3.2 完整配置骨架把下面这段 JSON 复制进去替换尖括号里的占位符{ mcpServers: { mcp-server-weread: { command: npx, args: [-y, mcp-server-weread], env: { CC_URL: https://cc.chenge.ink, CC_ID: 你的CookieCloud ID, CC_PASSWORD: 你的CookieCloud密码, TAOTOKEN_API_KEY: 你的TaoToken Key, TAOTOKEN_BASE_URL: https://taotoken.net/api } } } }如果你不用 CookieCloud把CC_*三行删掉换成WEREAD_COOKIE: 你的微信读书Cookie3.3 参数逐项说明字段作用是否必填command启动 MCP Server 的可执行命令是args传给命令的参数-y表示自动确认安装是CC_URLCookieCloud 服务器地址用 CookieCloud 时必填CC_IDCookieCloud 用户 UUID用 CookieCloud 时必填CC_PASSWORDCookieCloud 密码用 CookieCloud 时必填WEREAD_COOKIE微信读书登录态不用 CookieCloud 时必填TAOTOKEN_API_KEYTaoToken 统一通道凭证是TAOTOKEN_BASE_URLTaoToken API 入口是提示env里的变量会注入到 MCP Server 进程。如果你的 MCP Server 版本对变量名有特定要求以项目文档为准这里给的是通用骨架。3.4 全局安装的替代写法如果你不想每次用npx拉取可以先全局安装npm install -g mcp-server-weread然后把配置里的command和args换成command: mcp-server-wereadenv部分保持不变。全局安装的好处是启动更快坏处是版本更新要手动执行npm update -g mcp-server-weread。4. 启动 MCP Server 并验证请求经过 TaoToken4.1 先单独跑一次 MCP Server在改 Claude Desktop 配置之前先在终端手动启动一次确认 Server 本身没问题npx -y mcp-server-weread如果终端没有立刻报错退出而是停在等待输入的状态说明 Server 启动成功。按 CtrlC 结束。如果报Cannot find module或SyntaxError回到第 2.1 节检查 Node.js 版本。4.2 重启 Claude Desktop 并确认工具识别保存settings.json后完全退出 Claude Desktop不是关窗口是退出进程再重新打开。进入 Settings - Developer查看 MCP Servers 列表应该能看到mcp-server-weread状态为 connected。如果状态是 failed 或列表里没有先看 Claude Desktop 的日志。macOS 在~/Library/Logs/Claude/Windows 在%APPDATA%\Claude\logs\。日志里会写明是 JSON 解析失败、命令找不到还是环境变量缺失。4.3 用对话触发工具调用在 Claude Desktop 新建对话输入帮我查看我的微信读书书架正常情况下Claude 会调用get_bookshelf工具返回书架书籍列表。你会看到类似「我从您的微信读书书架获取到了 N 本书籍」的回复。这一步验证的是 MCP 链路通了。4.4 确认请求经过 TaoToken 通道MCP 链路通了不代表走了 TaoToken。要确认请求确实经过统一通道有两个办法办法一是看 TaoToken 控制台的用量面板。在对话触发工具调用后刷新控制台的请求记录应该能看到对应时间点的调用条目来源标记为你的 Key 名称。办法二是临时把TAOTOKEN_API_KEY改成一个错误值重启 Claude Desktop 后再触发一次工具调用。如果请求确实走 TaoToken这次调用会失败并报鉴权错误如果还能成功说明请求没走 TaoToken需要检查 MCP Server 是否真的读取了TAOTOKEN_BASE_URL。验证完记得把 Key 改回正确值。5. 本篇常见错排查5.1 Claude Desktop 识别不到 MCP Server最常见的原因是 JSON 格式错误。settings.json不允许注释也不允许尾随逗号。用编辑器的 JSON 校验功能检查一遍。另一个原因是路径写错Windows 下反斜杠要转义成\\或者直接用正斜杠。如果 JSON 没问题但还是识别不到检查command指向的可执行文件是否在 PATH 里。npx在部分 Windows 环境下需要写全路径可以用where npx找到实际位置再填进去。5.2 工具调用返回空数据书架为空或笔记为空通常是 Cookie 失效。微信读书的 Cookie 有效期不长用 CookieCloud 的话去插件里点一次「手动同步」然后重启 Claude Desktop。直接填WEREAD_COOKIE的话重新按 2.3 节的步骤复制一次。还有一种情况是 Cookie 复制时带了多余空格或换行。粘贴到 JSON 里之前先在一个纯文本编辑器里过一遍确保是连续的一行。5.3 请求没走 TaoToken 通道如果 4.4 节的验证方法二显示请求仍然成功说明 MCP Server 没有读取TAOTOKEN_BASE_URL。可能的原因有三个变量名拼写错误、env层级放错应该在mcp-server-weread下面不是mcpServers下面、或者 MCP Server 版本不支持自定义 base_url。先检查变量名和层级再确认 MCP Server 版本。如果版本不支持升级到最新版npm view mcp-server-weread version npm install -g mcp-server-wereadlatest5.4 npx 首次启动超时npx -y mcp-server-weread首次执行会从 npm 拉包网络慢的时候可能超过 Claude Desktop 的启动等待时间表现为 MCP Server 状态一直 connecting。解决办法是先手动在终端跑一次npx -y mcp-server-weread把包缓存下来再重启 Claude Desktop。或者改用全局安装方式跳过 npx 拉取环节。6. 统一通道后的下一步配置跑通后你的 Claude Desktop 里就有了一个能读微信读书数据的 MCP Server而且模型请求和工具请求都收敛到了 TaoToken 通道。后续要加新的 MCP Server比如文件系统或数据库工具只需要在settings.json的mcpServers里追加一个条目TAOTOKEN_API_KEY和TAOTOKEN_BASE_URL复用同一套不用再单独申请凭证。如果你打算长期在编码场景里用这套通道可以了解 Coding Plan它针对高频编码和 Agent 调用做了额度优化。需要管理多个 Key 或查看各客户端的调用分布去控制台操作。接入文档里有不同客户端的配置示例遇到变量名不确定时可以直接对照。最后留一个实用习惯每次改完settings.json先在终端手动跑一次 MCP Server 确认能启动再重启 Claude Desktop。这样能把配置错误和 Server 错误分开定位省掉不少来回试的时间。