让编辑器里的 agent 改协作文档(MCP)
Cursor、Windsurf、VS Code、Claude Code、Codex 等支持 MCP 的客户端,可以通过 wickrunAI 的协作文档工具直接改你在 wickrunAI 里的协作文档。你不用换编辑器:别人在网页、手机和桌面上实时看到改动,改动署名是「你的 Cursor」这样的名字,每一步都留在版本历史里,可以对比和恢复。
开始之前
- 装了桌面版(推荐):wickrunAI 桌面版 6.1 或更新,开着并已登录。加密空间里的文档也能改。
- 没装桌面版:用云端连接器,在网页版里生成一个连接器地址。加密空间里的文档不能用这种方式改。
用桌面版连接
- 在桌面版打开 设置 → 工具 → 协作文档,点「复制编辑器 MCP 配置」。复制出来的是一段完整的
mcpServers配置,里面是这台电脑上的路径,不含账号密码。 - 把它粘贴到你的客户端里:
Cursor:项目里的 .cursor/mcp.json,或对所有项目生效的 ~/.cursor/mcp.json。
{
"mcpServers": {
"wickrun-docs": {
"command": "从 wickrunAI 复制的 command",
"args": ["从 wickrunAI 复制的参数"]
}
}
}
Claude Code:项目根目录的 .mcp.json(格式同上),或者用命令加到你自己的用户配置里:
claude mcp add --scope user wickrun-docs -- <从 wickrunAI 复制的 command 和参数>
Codex:~/.codex/config.toml
[mcp_servers.wickrun-docs]
command = "从 wickrunAI 复制的 command"
args = ["从 wickrunAI 复制的参数"]
Windsurf、VS Code 和其他 MCP 客户端:在它们的 MCP 设置里添加同一段 mcpServers 配置。
- 重启或刷新客户端的 MCP 列表,看到
wickrun-docs即可。
配置里的路径因电脑而异。团队共用的仓库里,建议放进各自的用户配置,不要提交到仓库。
用云端连接器连接
在 wickrunAI 网页版生成连接器地址(形如 https://wickrunai.com/mcp/<你的连接器令牌>),在客户端里按「远程 MCP」添加:
{ "mcpServers": { "wickrun-docs": { "url": "https://wickrunai.com/mcp/<你的连接器令牌>" } } }
Claude Code 可以直接用命令添加:
claude mcp add --scope user --transport http wickrun-docs https://wickrunai.com/mcp/<你的连接器令牌>
这个地址等于你账号的连接器凭据:只放进自己的用户配置,不要提交到仓库,也不要发给别人。重新生成地址后,旧地址立即失效。
agent 能做什么
| 工具 | 作用 |
|---|---|
wickrun_doc_list |
列出你能打开的协作文档;不指定位置时,列出你最近改过的 |
wickrun_doc_open |
打开一份文档,agent 以「你的 Cursor」这样的成员出现在文档里 |
wickrun_doc_apply |
修改文档:替换整段,或者找到一处文字替换 |
wickrun_doc_versions |
查看版本历史 |
wickrun_doc_version_text |
读某个版本的内容 |
wickrun_doc_mark_version |
改完一段后落一个 Work 版本 |
wickrun_doc_presence |
看看现在谁在这份文档里 |
改动看起来是什么样
- 文档的在线成员条里出现「R 的 Cursor」(R 是你的名字),带机器人角标,和你本人分开显示。
- agent 只改它改了的字。别人同时在写的内容会合并在一起,不会被覆盖。
- 版本历史里能看到哪些改动来自 agent;不满意可以对比,或者恢复到之前的版本。
你可能会遇到的限制
- agent 用你的账号和权限进入,没有自己的账号。你只能查看的文档,agent 也只能读,不能改。
- 用桌面版连接时,wickrunAI 要开着并已登录。agent 闲置一段时间后会自动离开文档,再打开即可。
- 加密空间里的文档只能用桌面版连接来改;云端连接器会回答「需在本机打开」。
- 一个文件如果从没有人「协作编辑」过,协作文档是空的。先在 wickrunAI 里打开一次(网盘里的「协作编辑」)。
- 文档在 agent 读过之后又被别人改了,agent 的整段替换可能被拒绝。让 agent 重新打开文档再改,或者改用查找替换。