☰
微信读书 MCP 在 Cursor 和 Claude 中的配置教程:TaoToken 统一 Key 接入与 settings.json 骨架
2026/9/27 19:50:15 网站建设 项目流程

1. 微信读书 MCP 到底解决什么问题

微信读书 MCP Server 是一个把微信读书书架、笔记、划线、热门书评暴露给支持 MCP 协议客户端的工具。简单说,它让 Cursor 和 Claude 这类 AI 客户端能直接读取你的微信读书数据,而不是你手动复制粘贴。适合谁?适合同时用 Cursor 写代码、用 Claude Desktop 做资料整理,又想把两边的模型调用统一到一个 Key 上管理的开发者。

我自己的场景是这样的:平时在 Cursor 里写项目,遇到需要查资料的时候希望 AI 能直接翻我微信读书里的划线;在 Claude Desktop 里做读书笔记整理时,又希望它能把某本书的笔记按章节拉出来。两个客户端如果各自配一套 Key 和 Cookie,维护起来很烦。所以这篇的核心思路是:微信读书 MCP 负责数据源,TaoToken 负责统一模型通道,Cursor 和 Claude 各自只做一次配置。

MCP 的全称是 Model Context Protocol,你可以把它理解成 AI 客户端和外部工具之间的“插头标准”。微信读书 MCP Server 就是那个插头,它提供get_bookshelf、search_books、get_book_notes_and_highlights、get_book_best_reviews这几个工具方法。客户端通过 stdio 方式启动这个 Server,然后模型就能在对话中调用这些方法。

需要提前说清楚的是:MCP Server 本身不负责模型推理,它只负责取数据。模型通道走的是 TaoToken 的统一 API,这样你在 Cursor 和 Claude 里用的是同一个 Key,额度、模型、计费都在一处看。下面从环境准备开始,一步步把两侧配置都跑通。

2. TaoToken 前置:统一 Key 与 API 通道

在配置 MCP 之前,先把模型通道准备好。TaoToken 的作用是提供一个统一的 API 入口,Cursor 和 Claude 都指向它,这样你不需要在两个客户端里分别填不同的厂商 Key。

第一步,打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册并登录。登录后进入控制台,找到 API Keys 管理页面,新建一个 Key。这个 Key 就是后面 Cursor 和 Claude 共用的凭证。

第二步,记下 API 地址:https://taotoken.net/api 。注意这个地址不带任何查询参数,配置时直接填这个 base URL。如果你用的是 OpenAI 兼容格式的客户端,通常还需要在末尾补/v1,具体看客户端要求,Cursor 的 OpenAI 兼容配置里一般填到/v1这一层。

第三步,确认你要用的模型。TaoToken 控制台里能看到可用模型列表,选一个你常用的,比如 Claude 系列或者 GPT 系列。Cursor 里做代码补全和对话可以用一个模型,Claude Desktop 里做长文整理可以用另一个,但 Key 是同一个。

注意:API Key 只在创建时完整显示一次,复制后妥善保存。如果泄露了,在控制台里删掉重建即可,不需要改其他配置。

到这里前置就完成了。你手里应该有三样东西:一个 TaoToken API Key、API 地址https://taotoken.net/api、以及你要用的模型名称。接下来进入实际配置。

3. 可复制配置:settings.json 与 config.toml 骨架

这一节是全文的核心,给出 Cursor 和 Claude 两侧可以直接复制的配置骨架。先装 MCP Server,再分别配两个客户端。

3.1 安装 mcp-server-weread

确保系统有 Node.js 16.x 或更高版本。终端里执行:

node -v npm install -g mcp-server-weread

如果你不想全局安装,后面配置里用npx -y mcp-server-weread也行。全局装的好处是启动快,npx 的好处是不污染全局环境。我两种都试过,日常用全局更省事。

3.2 获取微信读书 Cookie

有两种方式。推荐用 CookieCloud 自动同步,省得 Cookie 过期后反复手动换。

CookieCloud 方式:注册 CookieCloud 账户,拿到CC_ID和CC_PASSWORD;安装对应浏览器插件;在插件里把同步域名关键词填weread,保存后手动同步一次。这样 MCP Server 会通过CC_URL、CC_ID、CC_PASSWORD自动拉取 Cookie。

手动方式:Chrome 登录微信读书网页版,F12 打开开发者工具,Network 标签页刷新,找到weread.qq.com的请求,复制 Headers 里的完整 Cookie 字段。手动方式的问题是 Cookie 有效期短,过几天就得重来。

3.3 Cursor 侧 settings.json 骨架

Cursor 的 MCP 配置在设置里找到 MCP 配置入口,添加以下 JSON。这是 CookieCloud 方式:

{ "mcpServers": { "mcp-server-weread": { "command": "mcp-server-weread", "env": { "CC_URL": "https://cc.chenge.ink", "CC_ID": "你的CC_ID", "CC_PASSWORD": "你的CC_PASSWORD" } } } }

如果用手动 Cookie,把 env 换成:

{ "mcpServers": { "mcp-server-weread": { "command": "mcp-server-weread", "env": { "WEREAD_COOKIE": "你的微信读书Cookie" } } } }

Cursor 里模型通道的配置在 Settings 的 Models 部分,选择 OpenAI 兼容,Base URL 填https://taotoken.net/api/v1,API Key 填 TaoToken 的 Key,模型名填你在控制台选的模型。这样 Cursor 的对话和补全走 TaoToken,MCP 走微信读书 Server,两条线互不干扰。

3.4 Claude Desktop 侧 config.toml 骨架

Claude Desktop 的 MCP 配置在设置里,添加工具时填入 JSON。内容和 Cursor 侧基本一致:

{ "mcpServers": { "mcp-server-weread": { "command": "npx", "args": ["-y", "mcp-server-weread"], "env": { "CC_URL": "https://cc.chenge.ink", "CC_ID": "你的CC_ID", "CC_PASSWORD": "你的CC_PASSWORD" } } } }

Claude Desktop 的模型通道如果也要走 TaoToken,需要在配置文件里改 API 端点。Claude Desktop 原生走 Anthropic 通道,如果你用的是 TaoToken 的 Anthropic 兼容入口,把 base URL 指向对应地址即可。具体路径可以在控制台的接入文档里确认。

提示:两个客户端的 MCP 配置是独立的,但 env 里的 CC_ID、CC_PASSWORD 可以填同一套。这样 CookieCloud 同步一次,两边都能用。

4. 验证请求与成功结果

配置写完不代表通了,得实际验证。分两步:先验证 MCP Server 能独立启动,再验证客户端里模型能调用工具。

4.1 终端直接跑 MCP Server

在终端里直接执行:

mcp-server-weread

如果配置正确,它会启动并等待 stdio 输入,不会报错退出。如果报command not found,说明全局安装没成功,检查 npm 全局路径是否在 PATH 里。如果报 Cookie 相关错误,说明 CC_ID 或 Cookie 有问题。

你也可以用环境变量方式临时测试:

CC_URL=https://cc.chenge.ink CC_ID=你的ID CC_PASSWORD=你的密码 mcp-server-weread

能正常挂起等待输入,就说明 Server 本身没问题。

4.2 Cursor 里验证

重启 Cursor,在对话里输入:

帮我查看我的微信读书书架

模型应该会调用get_bookshelf,然后返回你的书架书籍列表。如果返回了书名和数量,说明 MCP 通了。如果模型说没有可用工具,检查 MCP 配置是否保存、Cursor 是否重启、Server 名称是否拼写一致。

再试一个搜索:

帮我找关于心理学的书

模型会调用search_books,参数keyword="心理学",返回匹配的书籍和阅读进度。

4.3 Claude Desktop 里验证

Claude Desktop 重启后,同样输入查看书架的指令。Claude 会显示工具调用过程,然后返回书架数据。再试笔记整理:

帮我整理《思考,快与慢》这本书的笔记

Claude 会先调search_books找到书籍 ID,再调get_book_notes_and_highlights,按章节返回划线和笔记。如果这一步成功,说明整条链路——TaoToken 模型通道加微信读书 MCP——都通了。

注意:首次调用可能稍慢,因为 Server 要拉取 CookieCloud 数据。后续调用会快很多。

5. 本篇常见错排查

配置过程中容易踩的坑集中在几个地方,逐个说。

Cookie 过期:手动 Cookie 方式最常见。表现是调用工具返回空数据或报鉴权失败。解决办法是换 CookieCloud 方式,或者重新复制 Cookie。CookieCloud 方式如果也失败,检查插件是否真的同步了weread域名,以及CC_ID、CC_PASSWORD是否填对。

连接失败:先确认 Node.js 版本,node -v低于 16 就升级。再确认mcp-server-weread能独立启动。如果终端能跑但客户端里不行,多半是客户端配置的路径或命令不对。全局安装用mcp-server-weread,npx 方式用npx加args。

权限问题:全局安装时如果报 EACCES,说明 npm 全局目录没权限。可以改用 npx 方式绕过,或者修正 npm 全局路径权限。防火墙一般不影响 stdio 方式的 MCP,因为它是本地进程通信。

模型通道报错:如果 Cursor 里模型对话报 401 或 404,检查 TaoToken 的 Base URL 是否填到了/v1,API Key 是否复制完整。Claude Desktop 如果走 Anthropic 兼容入口,确认端点路径和控制台文档一致。

工具不出现:客户端重启后仍看不到 MCP 工具,检查 JSON 是否有语法错误,比如多余的逗号、引号不匹配。JSON 对格式很敏感,建议用编辑器格式化一下再粘贴。

调试时最直接的办法是在终端里带环境变量跑 Server,看它输出的错误信息。客户端的日志文件也能看到 MCP 启动失败的原因,Cursor 和 Claude 各自有日志目录,具体位置在设置里能找到。

6. 统一 Key 接入后的调用建议

两侧都配好之后,日常使用有几个点值得注意。Cursor 里适合做“边写代码边查书”的场景,比如写到一个概念时让 AI 去你书架里找相关划线;Claude Desktop 适合做整本书的笔记整理和书评汇总,因为它的长上下文更适合处理大量文本。

TaoToken 的统一 Key 在这里的价值是:你不需要在 Cursor 和 Claude 里分别维护两套模型凭证,额度消耗、模型切换、Key 轮换都在一个控制台完成。如果后面要加第三个客户端,也是同样的接入方式。

如果你还没建 Key,可以从 API Keys 页面开始:https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。接入细节看文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。想先验证模型通不通,用模型对话页面试一句:https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。长期在 Cursor 里做编码和 Agent 任务的话,Coding Plan 更划算:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后留一个实用技巧:CookieCloud 的保活功能里填上https://weread.qq.com,插件会定期自动同步,基本不用再管 Cookie 过期的事。配置一次,两边稳定调用,这才是统一 Key 加 MCP 该有的体验。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询