一句话结论
代码仓库里能看到"实现",项目沟通里才能找到"为什么这样做":客户提出的限制、临时调整的范围、以及暂时没有达成一致的问题。
通过 claude mcp add 把本机的微信归档接入 Claude Code 之后,可以在动手之前查询这些上下文。要注意两件事:Claude Code 和 Claude Desktop 的配置方式不同,不要直接套用 JSON 示例;另外,配置写入、服务连接、能读到数据,是三个需要分别确认的环节。
先解决一个具体问题
比如你准备调整某个接口,但需要先确认客户讨论过的字段、部署条件和验收要求。可以先从相关会话找出这些线索,再结合已有需求文档和仓库资料形成候选清单。
有一条原则要先立住:聊天中的讨论不能自动成为新的需求版本。发现冲突时,保留各条说法,回到相关人员那里确认。尤其是"先试试""后面再定"这类表达,不能被整理成"已经批准"。
微信助手 MCP 提供什么
微信助手 MCP 在个人电脑上把本机已有的微信记录整理成可检索的归档,并提供名为 wxarchive 的 MCP 服务。现有的查询能力包括:
- 查看归档范围
- 列出会话
- 搜索消息
- 读取指定时段
- 获取某条消息的前后文
这些工具只读已归档数据,不通过此服务发送微信消息,也不会在每次提问时自动同步所有新记录。
Claude Code 与 Claude Desktop 的配置要区分
这是最容易踩的坑:如果软件接入页显示的是 Claude Desktop 的 JSON 示例,不要直接把它当成 Claude Code 的配置文件说明。
Claude Code 有自己的 MCP 管理方式,官方文档支持添加本地 stdio 服务。从归档工具的"agent 对接"页面取得实际的 command 和 args,再按 Claude Code 的方式注册:
claude mcp add --transport stdio --scope local wxarchive -- "<从软件接入页复制的启动程序绝对路径>" mcp
几个要点:
- 示例中的路径必须替换成真实的可执行文件路径
- 末尾的
mcp是打包后程序的参数;如果接入页给出的参数不同,应完整保留实际 args,不能只复制其中一部分 --scope local适合先在当前项目里验证。需要跨项目使用时,再按官方文档选择合适的范围- 不要把含本机信息的配置直接提交到公共仓库
配置之后怎样判断是否可用
保持归档工具运行,并确认本地界面当前选中的账号。然后检查服务状态:
claude mcp list
claude mcp get wxarchive
也可以在 Claude Code 会话内使用 /mcp 检查。
配置已写入、服务已连接、能够读到目标归档,是三个需要分别确认的环节。 跳过任何一个,后面的排查都会很困难。
第一次查询先调用 get_coverage,再选一段自己熟悉的文字记录做比对:
- 如果服务工具不可见:检查启动路径、完整参数及客户端状态
- 如果工具可用但数据为空:检查账号、归档覆盖和同步情况
给 Claude Code 一条边界明确的任务
先检查当前微信归档的数据覆盖范围。找到我指定的项目群,仅查询本周与接口字段和部署条件相关的文字消息。输出明确要求、待确认问题和相互矛盾的说法,尽量保留消息时间、发送人和消息标识。先给我开发前的上下文摘要,不修改代码、不执行部署、不发送消息。
最后一句的三个禁令值得保留。核对这份摘要之后,再单独决定是否进入实现阶段。
要特别说明的是:微信归档服务是只读的,不代表整个助手只能读取。Claude Code 还具备文件读写和命令执行能力,后续动作仍按你的授权范围执行。整理微信信息和执行代码变更,是两个可以分别授权的环节。
哪些内容需要额外检查
模型查不到的消息,可能有几种情况:
- 没有下载或归档
- 位于其他会话
- 是尚未处理的图片或附件(语音会自动转写成文字)
查询结果有限时,应按工具返回的翻页信息继续读取,不能把一页结果当作全部历史。
本地服务运行在自己的电脑上,但接入云端模型后,被读取的聊天内容仍会发送给对应服务。涉及客户信息时,应先确认可用范围,只查询必要的项目和日期。
需求本身怎么从群聊里梳理,见微信群里的需求改来改去怎么整理。
常见问题
Claude Code 怎么接入微信聊天记录?
在本机运行微信助手 MCP 并完成归档,从软件的"agent 对接"页复制实际的启动路径和参数,然后用 claude mcp add --transport stdio --scope local wxarchive -- "<路径>" mcp 注册。注册后用 claude mcp list 或会话内 /mcp 确认服务已连接。
Claude Desktop 的配置能直接用在 Claude Code 上吗?
不能。Claude Desktop 使用 JSON 配置文件,Claude Code 有自己的 MCP 管理命令。两者的 command 和 args 内容可以相同,但注册方式不同,要按各自的官方方式配置。
为什么 claude mcp list 显示已连接,却查不到聊天内容?
连接成功只说明 Claude Code 能启动这个服务。查不到数据通常是另外三个原因:归档工具当前选中的微信账号不对、归档没有覆盖你问的时间范围、或者相关消息本机微信还没下载。先在本地界面核对这三项。
接入后 Claude Code 能修改代码吗?
微信归档这个服务是只读的,不提供任何写入或发送能力。但 Claude Code 本身具备文件读写和命令执行能力,这部分权限与微信归档无关,仍按你对 Claude Code 的授权范围执行。
能力边界
- 只处理已下载到本机、且你有权使用的记录。
- 微信归档接入只读,不发送微信消息,不自动同步新记录。
- 接入云端模型后,被读取的内容会发送给对应的模型服务商。
- macOS(12.0 及以上,仅 Apple Silicon 机型)与 Windows(10 及以上,64 位)均已发布;Windows 版以 .exe 安装程序提供,下载后直接运行即可。
对经常从微信接需求、再回到代码仓库推进工作的个人开发者,这条流程值得从一个小范围、可核对的问题开始验证。
产品介绍与下载:微信助手 MCP
配置参考:Claude Code 官方 MCP 文档 https://code.claude.com/docs/en/mcp