Codex schreibt die Spec.Du prüfst sie in DotMD.

So verbindest du Codex: mit der App oder config.toml

DotMD betreibt einen kleinen MCP-Server auf deinem Mac. Darüber öffnet Codex Dateien in DotMD, schickt dir Dokumente zum Review und liest deine Kommentare. Die Codex-App, die Codex CLI und die Codex-Erweiterung für deine IDE teilen sich eine Einrichtung, du machst das also nur einmal.

1. Schalte den MCP-Server von DotMD ein

   Öffne in DotMD Settings → MCP und schalte MCP server ein. Der Status wird grün. Schalte auch Start with DotMD ein, damit der Server bereit ist, sobald DotMD geöffnet ist.

2. Füge den Server in Codex hinzu

   Öffne in der Codex-App Settings → MCP servers → Add server, wähle Streamable HTTP und füge die Adresse ein, die oben in Settings → MCP von DotMD steht. Standardmäßig ist das http://127.0.0.1:8089/mcp.

3. Oder bearbeite config.toml

   Lieber eine Datei? Trage das in ~/.codex/config.toml ein. Settings → MCP in DotMD hat dafür einen Kopieren-Button:

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

   Starte Codex nach dem Eintragen neu.

4. Prüfe, ob er antwortet

   Bitte Codex, eine Markdown-Datei in DotMD zu öffnen. Die Datei geht auf, und Recent Requests in Settings → MCP zeigt den Aufruf in einfachen Worten, mit einem grünen Haken.

Warum tool_timeout_sec wichtig ist

Wenn Codex dir eine Spec zum Review schickt, wartet es in einem einzigen MCP-Tool-Aufruf, bis du auf Send oder Approve klickst. Dabei verbraucht es keine Tokens. Doch Codex gibt einen Tool-Aufruf nach einer Minute auf, wenn du nichts anderes einstellst, und ein Review dauert länger.

Mit tool_timeout_sec = 3600 wartet Codex bis zu eine Stunde. Ohne diese Zeile hört Codex auf zu warten, und dein Review hat keinen Empfänger mehr. Verloren geht nichts: Deine Kommentare bleiben in DotMD, und du kannst Codex danach sagen „Lies meine Kommentare in DotMD und arbeite sie ein“. Am besten läuft der Ablauf aber, wenn Codex noch auf dich wartet.

Hilf Codex, deine Kommentare zu finden

Codex sieht sich seine MCP-Tools nur an, wenn es meint, sie zu brauchen. Bei „Arbeite die Kommentare zu paywall.md ein“ durchsucht es womöglich das Projekt, statt sie in DotMD zu lesen, denn deine Kommentare liegen in DotMD und nicht in der Datei. Es gibt zwei Wege, es in die richtige Richtung zu lenken.

Der erste: DotMD in der Bitte erwähnen, zum Beispiel „Arbeite die Kommentare zu paywall.md in DotMD ein“. Der zweite: Diese Zeilen einmal in ~/.codex/AGENTS.md oder in die AGENTS.md eines Projekts schreiben:

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.

Mit diesen Zeilen schickt Codex dir jede Spec, die es schreibt, und sucht deine Kommentare immer in DotMD.

Dein erstes Review einer Codex-Spec

Bitte Codex um das Dokument und sag, wo es hin soll und dass du es prüfen willst:

„Schreib die Spec nach docs/spec.md und schick sie mir zum Review in DotMD.“

1. Codex schickt dir die Datei

   Es speichert die Spec und schickt sie dir. Eine Mitteilung erscheint, die Datei steht unter Needs You, und Codex wartet.

2. Du kommentierst die Stellen

   Lies die Spec gerendert, mit Tabellen, Diagrammen und Code. Markiere eine Stelle, die sich ändern soll, drücke ⌥⌘M und schreib, was du willst. Geh das ganze Dokument durch, bevor du etwas abschickst.

3. Du schickst die Kommentare ab

   Klicke unten im Review-Bereich auf Send. Codex bekommt alle deine Kommentare auf einmal. Wenn du nichts ändern willst, steht auf dem Button Approve.

4. Du prüfst jede Korrektur in der Datei

   Codex bearbeitet die Datei und schickt jeden Kommentar mit einer Notiz zurück, was es getan hat. Jede Korrektur steht neben dem Kommentar, auf den sie antwortet, der alte Text rot, der neue grün. Übernimm sie mit Accept, öffne sie mit Reopen erneut oder nimm alle mit Accept All an. Dann Approve, oder schick eine weitere Runde.

Codex kann auch der Reviewer sein. Bitte es: „Prüfe docs/compare.md in DotMD und hinterlasse deine Kommentare an den Zeilen“, und seine Kommentare erscheinen unter seinem Namen. Siehe Ein Agent prüft den anderen.

Die ChatGPT-App kann sich nicht verbinden

Die ChatGPT-App erreicht MCP-Server von den Servern von OpenAI im Internet aus, nicht von deinem Mac. Der Server von DotMD antwortet nur auf deinem Mac, deshalb kann die ChatGPT-App ihn nicht nutzen. Nimm für die Modelle von OpenAI Codex.

Fragen zu Codex und DotMD

Weitere Fragen