DotMD
下載 Mac 版 在 Mac App Store 下載

Codex 寫規格。你在 DotMD 審閱。

只要把 DotMD 加進 Codex 一次，它寫的每份規格和計畫，都會以可閱讀、可註解的文件送到你面前。你審閱時 Codex 會等著，每項修正都會顯示在檔案中，等你接受。

下載 Mac 版 即將推出 在 Mac App Store 下載

需要 macOS 14 或以上版本。閱讀免費；DotMD Pro 提供 3 天免費試用。

快速解答

在 Codex app 開啟 Settings → MCP servers → Add server，選擇 Streamable HTTP，貼上 http://127.0.0.1:8089/mcp。或在 ~/.codex/config.toml 加入 [mcp_servers.dotmd] 並設定 tool_timeout_sec = 3600，讓 Codex 在你審閱時能夠等待。然後重新啟動 Codex。審閱和代理工具屬於 DotMD Pro（可免費試用 3 天）；閱讀仍然免費。

如何連接 Codex：用 app 或 config.toml

DotMD 會在你的 Mac 上執行一個小型 MCP 伺服器。Codex 透過它在 DotMD 開啟檔案、把文件送給你審閱，並讀取你的留言。Codex app、Codex CLI 和 IDE 的 Codex 擴充功能共用同一份設定，所以只需設定一次。

  1. 開啟 DotMD 的 MCP 伺服器

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

  2. 在 Codex 中加入伺服器

    在 Codex app 開啟 Settings → MCP servers → Add server，選擇 Streamable HTTP，貼上 DotMD 的 Settings → MCP 上方顯示的位址。預設是 http://127.0.0.1:8089/mcp。

  3. 或是編輯 config.toml

    想用檔案設定？把下面這段加入 ~/.codex/config.toml。DotMD 的 Settings → MCP 有複製按鈕：

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

    加入後請重新啟動 Codex。

  4. 確認它有回應

    請 Codex 在 DotMD 開啟一個 Markdown 檔案。檔案會開啟，Settings → MCP 中的 Recent Requests 會用白話列出這次呼叫，並附上綠色勾號。

為什麼 tool_timeout_sec 很重要

Codex 把規格送給你審閱後，會在單一次 MCP 工具呼叫中等待，直到你按下 Send 或 Approve。等待期間不會消耗任何 token。但如果沒有另外設定，Codex 會在一分鐘後放棄這次工具呼叫，而審閱通常不只一分鐘。

tool_timeout_sec = 3600 讓 Codex 最多等上一小時。沒有這一行，Codex 就會停止等待，你的審閱也就沒有對象可送。不會有東西遺失：你的留言仍留在 DotMD，審閱完後你可以告訴 Codex「讀取我在 DotMD 的留言並修正」。不過，Codex 仍在等你時，整個流程最順暢。

幫 Codex 找到你的留言

Codex 只有在認為需要時，才會去看它的 MCP 工具。你請它「修正 paywall.md 的留言」，它可能會在專案裡搜尋，而不是到 DotMD 讀取，因為你的留言是由 DotMD 保存，不在檔案裡。有兩個方法可以把它導向正確的地方。

第一個是在要求中提到 DotMD，例如「修正 DotMD 裡 paywall.md 的留言」。第二個是把下面幾行加進 ~/.codex/AGENTS.md，或專案的 AGENTS.md，只需加一次：

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

有了這幾行，Codex 每寫好一份規格都會送給你，並且一律到 DotMD 找你的留言。

第一次審閱 Codex 的規格

向 Codex 要文件時，說明要存在哪裡，以及你想審閱它：

「把規格寫到 docs/spec.md，然後在 DotMD 傳給我審閱。」

  1. Codex 把檔案送給你

    它儲存規格並送給你。會跳出通知，檔案出現在 Needs You 之下，Codex 開始等待。

  2. 你在段落上留下註解

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

  3. 你送出註解

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

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

    Codex 編輯檔案，並把每則留言連同說明它做了什麼的備註送回來。每項修正都放在它所回應的留言旁邊，舊文字為紅色，新文字為綠色。用 Accept 接受、用 Reopen 重新開啟，或用 Accept All 全部接受。然後按 Approve，或再送出一輪。

DotMD：代理程式正在等你審閱規格，檔案在 Needs You 之下，留言在附有 Send 按鈕的 Review 面板中
代理程式正在等你審閱：檔案在 Needs You 之下，你的留言在面板中。

Codex 也可以擔任審閱者。請它「在 DotMD 審閱 docs/compare.md，並在相關的行上留言」，它的留言就會以它的名字出現。請見一個代理程式審閱另一個。

ChatGPT app 無法連接

ChatGPT app 是從網際網路上 OpenAI 的伺服器連接 MCP 伺服器，而不是從你的 Mac。DotMD 的伺服器只在你的 Mac 上回應，所以 ChatGPT app 無法使用。要用 OpenAI 的模型，請使用 Codex。

關於 Codex 與 DotMD 的常見問題

為什麼 Codex 不再等我審閱？

它的工具逾時預設很短。請在 config.toml 中 DotMD 的伺服器設定加入 tool_timeout_sec = 3600，然後重新啟動 Codex。

Codex 在專案裡搜尋，而不是讀取我的留言。

在要求中提到 DotMD（「…在 DotMD」），或把本指南中的 AGENTS.md 那幾行加進去一次。

Codex CLI 和 IDE 擴充功能也能用嗎？

可以。app、CLI 和 IDE 擴充功能共用同一份設定。

我可以改連接 ChatGPT app 嗎？

不行。它是從 OpenAI 的伺服器連接 MCP 伺服器，而 DotMD 只在你的 Mac 上回應。請使用 Codex。

更多問題

其他指南

Claude Code Cursor 註解

使用情境

代理互相審閱 開發者