WordCraft MCP 设置：让 Claude 连接本地文档编辑器

WordCraft 提供本地 MCP 服务，让兼容的 AI 客户端通过命令行工具处理文档。本站的浏览器编辑器不会替你安装或运行 MCP 服务。 要完成接入，电脑上需要上游 WordCraft CLI，以及能够启动本地 MCP 进程的 AI 客户端。

本指南依据 2026 年 10 月 12 日查阅的上游 v0.5.0 MCP 文档编写。以下是官方资料支持的配置流程，不代表我们已经独立完成 Claude 全链路实测。不同版本的客户端设置和工具名称可能变化。

准备本地工具

通过下载指南进入官方发布页。桌面应用和命令行可执行程序承担不同角色：安装了图形编辑器，不代表终端已经能够找到 wordcraft-cli。

确认 WordCraft CLI 与所用 AI 客户端已安装。下面的 Claude Code 示例还需要终端能运行 claude。如果系统提示找不到命令，应先定位可执行文件；反复执行 MCP 注册不会自动安装缺失的程序。

准备一个专用目录，放入可丢弃的 mcp-test.docx，并预先约定输出为新文件 mcp-test-edited.docx。这样既容易明确助手该改什么，也容易核对结果。

方式一：不打开窗口处理文档

上游给出的 Claude Code 注册命令是：

claude mcp add wordcraft -- wordcraft-cli mcp

这种模式不需要打开 WordCraft 窗口。按上游说明，可以通过 --author 指定助手的修订署名：

wordcraft-cli mcp --author "Claude (copyedit)"

第二条命令是在启动服务进程，不是另一条注册命令。等待 MCP 消息的进程可能看起来没有输出。应让 AI 客户端启动已配置的服务，不要期待它在终端显示交互式文档编辑提示。

方式二：控制正在运行的桌面窗口

先带本地控制端口启动 WordCraft：

wordcraft --control 7981

保持该应用运行，在另一个终端注册连接桥接：

claude mcp add wordcraft-app -- wordcraft-cli mcp --connect 127.0.0.1:7981

需要操作桌面界面时使用这种模式。官方控制协议说明了每个窗口独立的密钥和本机回环连接。桥接程序从应用的本地密钥文件或指定环境变量读取密钥。这个流程与浏览器编辑器、远程托管 AI 服务是不同的部分。

先验证一次小范围修改

可以给助手一个边界清楚的任务：

打开 mcp-test.docx，读取文档并报告标题结构。只把“Draft for review”改成“Ready for review”。另存为 mcp-test-edited.docx，然后重新读取这个文件，说明发生了哪些变化。

关键是“读取、少量修改、保存、再次读取”的顺序。助手回复“完成”，并不能证明正确文件已经保存。自己打开输出，核对目标句子、周围文字与页面布局。

如果需要保留可审阅的修改，上游说明了 review.trackChanges 命令及显式 value: true 参数。显式设置能避免原本已启用修订时，误把它切换关闭。应让助手先发现当前可用命令，再执行，不要只依赖记忆中的命令名。

连接失败时先检查什么

| 现象 | 首先检查 | | ------------------ | ----------------------------------------------- | | 找不到程序 | 同一个终端能否定位 wordcraft-cli 和 AI 客户端 | | 桌面连接被拒绝 | 应用是否正在运行，控制端口是否与桥接命令一致 | | 控制请求未授权 | 桥接程序是否读取当前应用实例的密钥 | | 工具出现但文档不对 | 修改前先检查文件路径和文档结构 | | 没有找到输出 | 核对保存路径，并让助手重新读取那个确切文件 |

暴露给 AI 客户端的文档内容，可能按照该客户端的设置与提供商政策处理。WordCraft 在本地运行，并不能说明另外接入的 AI 服务如何处理文字。

手动编辑流程可阅读WordCraft 入门指南。工具名称或配置更新，以官方仓库文档为准。