DotMD
Codex scrive la spec.Tu la rivedi in DotMD.
Aggiungi DotMD a Codex una volta sola. Ogni spec e ogni piano che scrive ti arriva come un documento da leggere e commentare, Codex aspetta mentre rivedi, e ogni correzione compare nel file perché tu la accetti.
macOS 14 o successivo. La lettura è gratuita; DotMD Pro ha 3 giorni di prova gratuita.
Risposta rapida
Nell’app di Codex apri Settings → MCP servers → Add server, scegli Streamable HTTP e incolla http://127.0.0.1:8089/mcp. Oppure aggiungi [mcp_servers.dotmd] a ~/.codex/config.toml con tool_timeout_sec = 3600, così Codex può aspettare mentre rivedi. Riavvia Codex. Le revisioni e gli strumenti per gli agenti fanno parte di DotMD Pro (3 giorni di prova gratuita); la lettura resta gratuita.
Come collegare Codex: con l’app o con config.toml
DotMD esegue un piccolo server MCP sul tuo Mac. Codex lo usa per aprire file in DotMD, mandarti documenti da rivedere e leggere i tuoi commenti. L’app di Codex, la CLI di Codex e l’estensione di Codex per il tuo IDE condividono un’unica configurazione, quindi la fai una volta sola.
-
Attiva il server MCP di DotMD
In DotMD apri Settings → MCP e attiva MCP server. Lo stato diventa verde. Attiva anche Start with DotMD, così il server è pronto ogni volta che DotMD è aperto.
-
Aggiungi il server in Codex
Nell’app di Codex apri Settings → MCP servers → Add server, scegli Streamable HTTP e incolla l’indirizzo in alto in Settings → MCP di DotMD. Di default è
http://127.0.0.1:8089/mcp. -
Oppure modifica config.toml
Preferisci un file? Aggiungi questo a
~/.codex/config.toml. Settings → MCP in DotMD ha un pulsante per copiarlo:[mcp_servers.dotmd] url = "http://127.0.0.1:8089/mcp" tool_timeout_sec = 3600Riavvia Codex dopo averlo aggiunto.
-
Controlla che risponda
Chiedi a Codex di aprire un file Markdown in DotMD. Il file si apre, e Recent Requests in Settings → MCP elenca la chiamata in parole semplici, con un segno di spunta verde.
Perché tool_timeout_sec è importante
Quando Codex ti manda una spec da rivedere, aspetta in una sola chiamata a uno strumento MCP finché non clicchi Send o Approve. Mentre aspetta non consuma token. Ma Codex abbandona una chiamata a uno strumento dopo un minuto, se non gli dici altro, e una revisione dura di più.
tool_timeout_sec = 3600 permette a Codex di aspettare fino a un’ora. Senza questa riga, Codex smette di aspettare e la tua revisione non ha più un destinatario. Non si perde nulla: i tuoi commenti restano in DotMD, e puoi dire a Codex «Leggi i miei commenti in DotMD e correggili» quando hai finito. Ma il ciclo funziona meglio quando Codex ti sta ancora aspettando.
Aiuta Codex a trovare i tuoi commenti
Codex guarda i suoi strumenti MCP solo quando pensa di averne bisogno. Se gli chiedi «correggi i commenti su paywall.md», può cercarli nel progetto invece di leggerli in DotMD, perché i tuoi commenti sono conservati da DotMD, non nel file. Ci sono due modi per indirizzarlo.
Il primo è nominare DotMD nella richiesta: «correggi i commenti su paywall.md in DotMD». Il secondo è aggiungere queste righe una volta sola a ~/.codex/AGENTS.md, o all’AGENTS.md di un progetto:
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.Con queste righe Codex ti manda ogni spec che scrive e cerca sempre i tuoi commenti in DotMD.
La tua prima revisione di una spec di Codex
Chiedi il documento a Codex, e di’ dove deve metterlo e che vuoi rivederlo:
«Scrivi la spec in docs/spec.md e mandamela in DotMD per la revisione.»
-
Codex ti manda il file
Salva la spec e te la manda. Compare una notifica, il file è elencato sotto Needs You, e Codex aspetta.
-
Commenti i passaggi
Leggi la spec formattata, con tabelle, diagrammi e codice. Seleziona un passaggio da cambiare, premi ⌥⌘M e scrivi cosa vuoi. Leggi tutto il documento prima di inviare qualcosa.
-
Invii i commenti
Clicca Send in fondo al pannello Review. Codex riceve tutti i tuoi commenti insieme. Se non hai niente da cambiare, il pulsante dice Approve.
-
Controlli ogni correzione nel file
Codex modifica il file e rimanda ogni commento con una nota su cosa ha fatto. Ogni correzione sta accanto al commento a cui risponde, il testo vecchio in rosso e quello nuovo in verde. Accettala con Accept, riaprila con Reopen, oppure accetta tutto con Accept All. Poi Approve, o manda un altro giro.
Codex può anche fare da revisore. Chiedigli «rivedi docs/compare.md in DotMD e lascia i tuoi commenti sulle righe», e i suoi commenti compaiono col suo nome. Vedi Un agente rivede l’altro.
L’app ChatGPT non può collegarsi
L’app ChatGPT raggiunge i server MCP dai server di OpenAI su internet, non dal tuo Mac. Il server di DotMD risponde solo sul tuo Mac, quindi l’app ChatGPT non può usarlo. Per i modelli di OpenAI usa Codex.
Domande su Codex e DotMD
Perché Codex smette di aspettare la mia revisione?
Il suo timeout per gli strumenti è breve di default. Aggiungi tool_timeout_sec = 3600 al server di DotMD in config.toml e riavvia Codex.
Codex cerca nel progetto invece di leggere i miei commenti.
Nomina DotMD nella richiesta («…in DotMD»), oppure aggiungi una volta sola le righe di AGENTS.md di questa guida.
Funziona con la CLI di Codex e con l’estensione per IDE?
Sì. L’app, la CLI e l’estensione per IDE condividono un’unica configurazione.
Posso collegare invece l’app ChatGPT?
No. Raggiunge i server MCP dai server di OpenAI, e DotMD risponde solo sul tuo Mac. Usa Codex.