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 開啟檔案、把文件送給你審閱,並讀取你的留言。設定只要一分鐘。

  1. 開啟 DotMD 的 MCP 伺服器

    在 DotMD 中開啟 Settings → MCP,打開 MCP server。狀態會變成綠色。也打開 Start with DotMD,只要 DotMD 開著,伺服器就隨時待命。

  2. 在 Cursor 的 MCP 設定中加入伺服器

    開啟 Cursor 的設定,前往 MCP 區段,用這份設定新增一個伺服器。它會寫入 Cursor 保存 MCP 伺服器的 mcp.json 檔案:

    {
      "mcpServers": {
        "dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
      }
    }

    如果你更改過連接埠,請複製 DotMD 的 Settings → MCP 上方顯示的位址。

  3. 確認它有回應

    請代理程式在 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 傳給我審閱。」

  1. 代理程式把檔案送給你

    它儲存規格並送給你。會跳出通知,檔案出現在 Needs You 之下,代理程式開始等待。

  2. 你在段落上留下註解

    以渲染後的樣子閱讀規格,包含表格、圖表與程式碼。選取需要修改的段落,按下 ⌥⌘M,寫下你要的內容。送出前先看完整份文件。

  3. 你送出註解

    按下 Review 面板底部的 Send。代理程式會一次收到你所有的留言。如果沒有要修改的地方,按鈕會顯示 Approve。

  4. 你在檔案中檢查每項修正

    代理程式編輯檔案,並把每則留言連同說明它做了什麼的備註送回來。每項修正都放在它所回應的留言旁邊,舊文字為紅色,新文字為綠色。用 Accept 接受、用 Reopen 重新開啟,或用 Accept All 全部接受。

DotMD 審閱代理程式對規格的變更:舊段落為紅色,新段落為綠色,上方有 Decline All 與 Accept All,留言在 Review 面板中
在 DotMD 中審閱:每項修改都在提出要求的註解旁邊。

代理程式能做什麼

除了把文件送給你,代理程式還能在某一行開啟檔案、讀取你選取的內容、標示它修改過的行、搜尋你的工作區,並以審閱者身分留言。MCP 伺服器指南列出了全部十二個工具。以下是幾個很好用的要求:

  • 「把計畫寫到 docs/plan.md,然後在 DotMD 開啟。」
  • 「改寫我在 DotMD 中選取的段落。」
  • 「我在 DotMD 對計畫留了註解,請逐一處理。」

關於 Cursor 與 DotMD 的常見問題

在 Visual Studio Code 也能用嗎?

可以,任何 MCP 用戶端都行:在它的 MCP 設定中,把同一個位址加為 HTTP 伺服器。

我還沒審閱完,代理程式就不等了。

你的留言仍留在 DotMD。告訴代理程式「讀取我在 DotMD 的留言並修正」,或調高它的 MCP 工具逾時。

DotMD 需要一直開著嗎?

需要。DotMD 開啟期間,才會執行 MCP 伺服器。

代理程式能不經我同意就更改檔案嗎?

DotMD 的伺服器從不寫入檔案。代理程式照常編輯檔案,而你可以在 DotMD 看到每一項變更。

更多問題