讓編輯器裡的 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 重新開啟文件再改,或者改用查詢替換。