Cursor 的代理程式寫文件。你在 DotMD 審閱。
只要把 DotMD 加進 Cursor 一次,代理程式就會把規格和計畫以可閱讀、可註解的文件送給你,讀取你在確切行上的留言,並在檔案中修正,等你接受。
需要 macOS 14 或以上版本。閱讀免費;DotMD Pro 提供 3 天免費試用。
快速解答
用下方設定把 DotMD 加進 Cursor 當作 MCP 伺服器(DotMD 的 Settings → MCP 有複製按鈕)。Visual Studio Code 和其他 MCP 用戶端使用相同的位址 http://127.0.0.1:8089/mcp。接著請代理程式在 DotMD 把規格送給你。審閱和代理工具屬於 DotMD Pro(可免費試用 3 天);閱讀仍然免費。
Cursor 的 MCP 設定:把 DotMD 加進 mcp.json
DotMD 會在你的 Mac 上執行一個小型 MCP 伺服器。Cursor 的代理程式透過它在 DotMD 開啟檔案、把文件送給你審閱,並讀取你的留言。設定只要一分鐘。
-
開啟 DotMD 的 MCP 伺服器
在 DotMD 中開啟 Settings → MCP,打開 MCP server。狀態會變成綠色。也打開 Start with DotMD,只要 DotMD 開著,伺服器就隨時待命。
-
在 Cursor 的 MCP 設定中加入伺服器
開啟 Cursor 的設定,前往 MCP 區段,用這份設定新增一個伺服器。它會寫入 Cursor 保存 MCP 伺服器的
mcp.json檔案:{ "mcpServers": { "dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" } } }如果你更改過連接埠,請複製 DotMD 的 Settings → MCP 上方顯示的位址。
-
確認它有回應
請代理程式在 DotMD 開啟一個 Markdown 檔案。檔案會開啟,Settings → MCP 中的 Recent Requests 會用白話列出這次呼叫,並附上綠色勾號。
Visual Studio Code 與其他 MCP 用戶端
DotMD 不限於 Cursor。Visual Studio Code 以及任何能與 HTTP 伺服器通訊的 MCP 用戶端,都使用相同的位址 http://127.0.0.1:8089/mcp。在用戶端的 MCP 設定中把它加為 HTTP 伺服器;如果用戶端接受 JSON,就使用上面同一份設定。本頁其餘內容也同樣適用。
Claude Code 與 Codex 有各自的設定方式。請見 Claude Code 與 Codex 的指南。
讓代理程式等你
代理程式把規格送給你審閱後,會在單一次工具呼叫中等待,直到你按下 Send 或 Approve,等待期間不消耗 token。這需要在你的代理程式中為 MCP 伺服器設定較長的工具逾時:請在它的 MCP 選項中找這個設定。
逾時太短時,代理程式大約每分鐘就會再問一次,而每一次都是模型的一個回合,或者乾脆停止等待。無論哪種情況都不會遺失任何東西:你的留言仍留在 DotMD。
第一次審閱 Cursor 代理程式的規格
向代理程式要文件時,說明要存在哪裡,以及你想審閱它:
「把規格寫到 docs/spec.md,然後在 DotMD 傳給我審閱。」
-
代理程式把檔案送給你
它儲存規格並送給你。會跳出通知,檔案出現在 Needs You 之下,代理程式開始等待。
-
你在段落上留下註解
以渲染後的樣子閱讀規格,包含表格、圖表與程式碼。選取需要修改的段落,按下 ⌥⌘M,寫下你要的內容。送出前先看完整份文件。
-
你送出註解
按下 Review 面板底部的 Send。代理程式會一次收到你所有的留言。如果沒有要修改的地方,按鈕會顯示 Approve。
-
你在檔案中檢查每項修正
代理程式編輯檔案,並把每則留言連同說明它做了什麼的備註送回來。每項修正都放在它所回應的留言旁邊,舊文字為紅色,新文字為綠色。用 Accept 接受、用 Reopen 重新開啟,或用 Accept All 全部接受。
代理程式能做什麼
除了把文件送給你,代理程式還能在某一行開啟檔案、讀取你選取的內容、標示它修改過的行、搜尋你的工作區,並以審閱者身分留言。MCP 伺服器指南列出了全部十二個工具。以下是幾個很好用的要求:
- 「把計畫寫到 docs/plan.md,然後在 DotMD 開啟。」
- 「改寫我在 DotMD 中選取的段落。」
- 「我在 DotMD 對計畫留了註解,請逐一處理。」
關於 Cursor 與 DotMD 的常見問題
在 Visual Studio Code 也能用嗎?
可以,任何 MCP 用戶端都行:在它的 MCP 設定中,把同一個位址加為 HTTP 伺服器。
我還沒審閱完,代理程式就不等了。
你的留言仍留在 DotMD。告訴代理程式「讀取我在 DotMD 的留言並修正」,或調高它的 MCP 工具逾時。
DotMD 需要一直開著嗎?
需要。DotMD 開啟期間,才會執行 MCP 伺服器。
代理程式能不經我同意就更改檔案嗎?
DotMD 的伺服器從不寫入檔案。代理程式照常編輯檔案,而你可以在 DotMD 看到每一項變更。