DotMD 就是 MCP 伺服器。你的代理程式看得到你正在讀的內容。

開啟 Markdown MCP 伺服器

這是用來在 DotMD 處理你的 Markdown 檔案的 MCP 伺服器：開啟檔案、讀取你的留言，以及審閱代理程式寫的內容。它不是把其他格式轉成 Markdown 的轉換工具。所有操作都在 Settings → MCP 進行：

• MCP server 會啟動伺服器。上方的狀態變成綠色並顯示 Listening。
• Start with DotMD 讓伺服器隨 DotMD 一起啟動。
• Port 預設為 8089。更改後，請把伺服器關掉再打開。
• 位址 http://127.0.0.1:8089/mcp 顯示在上方，旁邊有複製按鈕。

伺服器只在 DotMD 開啟時執行。關閉 DotMD 後，代理程式就連不上了。

把你的代理程式連接到 MCP 伺服器

用你的代理程式的方式，把伺服器的位址加進去一次即可。

Claude Code

在「終端機」執行下面這行。詳情請見 Claude Code 指南。

claude mcp add --transport http dotmd http://127.0.0.1:8089/mcp

Codex

在 Codex app 開啟 Settings → MCP servers → Add server 並選擇 Streamable HTTP，或把下面這段加進 ~/.codex/config.toml。tool_timeout_sec 這一行讓 Codex 在你審閱時能夠等待。更多資訊見 Codex 指南。

[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600

Cursor、Visual Studio Code 等

用這份設定新增一個伺服器。步驟見 Cursor 指南。

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

代理程式能用 DotMD 做什麼

伺服器提供給代理程式十二個工具：

規格的流程：代理程式寫好後呼叫 request_review，你留言並按下 Send，代理程式逐則修正，再用 resolve_review_comments 送回。實際的樣子請見 Claude Code 指南。

每一次呼叫你都看得到

Settings → MCP 中的 Recent Requests 用白話顯示每個助理做了什麼：例如附綠色勾號的「Codex · Opened plans/auth.md at line 42」、「Searched for “rate limit” (5 matches)」，或附紅色叉號的「Couldn't open ~/notes/a.md — no access」。把游標移到某一行，可看到完整路徑或原因。Technical details 則改為列出原始的 HTTP 請求。這份清單只在 DotMD 開啟期間保留。

安全性：誰能連上伺服器

• 伺服器只監聽 127.0.0.1，所以其他電腦連不上。
• 網頁無法使用它。任何來自瀏覽器的請求都會被拒絕，位址不是指向這台 Mac 的請求也一樣，這同時能防止 DNS rebinding。
• 它只接受 JSON 請求，而網頁表單送不出這種請求。
• 它從不寫入檔案。這些工具只作用於最前面的 DotMD 視窗。
• 它只開啟 DotMD 有權存取的檔案：你的工作區、「下載項目」，以及（若你允許）你的個人資料夾。其他的內容，代理程式會被告知請你把資料夾加入工作區。

被拒絕的請求會以紅色顯示在 Recent Requests，並附上原因。

Docker 中的代理程式

在 Docker 容器內，127.0.0.1 指的是容器本身，不是你的 Mac。使用 Docker Desktop 時，容器以 host.docker.internal 連到 Mac，所以請使用這個位址：

claude mcp add --transport http dotmd http://host.docker.internal:8089/mcp

其他用戶端在設定中填入同一個位址。這台 Mac 上的每個容器都能用這種方式連到伺服器，就像連到 Docker Desktop 放行至你的 Mac 的其他任何伺服器一樣。你網路上的其他電腦仍然連不上。

關於 DotMD MCP 伺服器的常見問題

更多問題