Codex escribe la spec.Tú la revisas en DotMD.

Cómo conectar Codex: con la app o con config.toml

DotMD ejecuta un pequeño servidor MCP en tu Mac. Codex habla con él para abrir archivos en DotMD, enviarte documentos para revisar y leer tus comentarios. La app de Codex, la CLI de Codex y la extensión de Codex para tu IDE comparten una sola configuración, así que solo la haces una vez.

1. Activa el servidor MCP de DotMD

   En DotMD, abre Settings → MCP y activa MCP server. El estado se pone en verde. Activa también Start with DotMD para que el servidor esté listo siempre que DotMD esté abierto.

2. Añade el servidor en Codex

   En la app de Codex abre Settings → MCP servers → Add server, elige Streamable HTTP y pega la dirección que aparece arriba en Settings → MCP de DotMD. Por defecto es http://127.0.0.1:8089/mcp.

3. O edita config.toml

   ¿Prefieres un archivo? Añade esto a ~/.codex/config.toml. Settings → MCP en DotMD tiene un botón para copiarlo:

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

   Reinicia Codex después de añadirlo.

4. Comprueba que responde

   Pide a Codex que abra un archivo Markdown en DotMD. El archivo se abre, y Recent Requests en Settings → MCP muestra la llamada con palabras sencillas y una marca verde.

Por qué importa tool_timeout_sec

Cuando Codex te envía una spec para revisar, espera en una sola llamada a una herramienta MCP hasta que pulses Send o Approve. Mientras espera no gasta tokens. Pero Codex abandona una llamada a una herramienta al cabo de un minuto si no le indicas otra cosa, y una revisión dura más.

tool_timeout_sec = 3600 permite que Codex espere hasta una hora. Sin esa línea, Codex deja de esperar y tu revisión se queda sin destinatario. No se pierde nada: tus comentarios siguen en DotMD, y puedes decirle a Codex «Lee mis comentarios en DotMD y corrígelos» cuando termines. Pero el ciclo funciona mejor cuando Codex sigue esperándote.

Ayuda a Codex a encontrar tus comentarios

Codex solo consulta sus herramientas MCP cuando cree que las necesita. Si le pides «corrige los comentarios de paywall.md», puede buscarlos en el proyecto en lugar de leerlos en DotMD, porque tus comentarios los guarda DotMD, no el archivo. Hay dos maneras de orientarlo.

La primera es mencionar DotMD en la petición: «corrige los comentarios de paywall.md en DotMD». La segunda es añadir estas líneas una sola vez a ~/.codex/AGENTS.md, o al AGENTS.md de un proyecto:

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 estas líneas Codex te envía cada spec que escribe y siempre busca tus comentarios en DotMD.

Tu primera revisión de una spec de Codex

Pide a Codex el documento, y dile dónde debe guardarlo y que quieres revisarlo:

«Escribe la spec en docs/spec.md y envíamela a DotMD para revisarla.»

1. Codex te envía el archivo

   Guarda la spec y te la envía. Aparece una notificación, el archivo figura en Needs You y Codex espera.

2. Comentas los pasajes

   Lee la spec renderizada, con sus tablas, diagramas y código. Selecciona un pasaje que deba cambiar, pulsa ⌥⌘M y escribe lo que quieres. Revisa el documento entero antes de enviar nada.

3. Envías los comentarios

   Haz clic en Send en la parte inferior del panel Review. Codex recibe todos tus comentarios de una vez. Si no tienes nada que cambiar, el botón dice Approve.

4. Revisas cada corrección en el archivo

   Codex edita el archivo y te devuelve cada comentario con una nota sobre lo que hizo. Cada corrección queda junto al comentario al que responde, con el texto antiguo en rojo y el nuevo en verde. Acéptala con Accept, reábrela con Reopen o acéptalo todo con Accept All. Luego Approve, o envía otra ronda.

Codex también puede ser el revisor. Pídele «revisa docs/compare.md en DotMD y deja tus comentarios en las líneas», y sus comentarios aparecerán con su nombre. Mira Un agente revisa a otro.

La app de ChatGPT no puede conectarse

La app de ChatGPT llega a los servidores MCP desde los servidores de OpenAI en internet, no desde tu Mac. El servidor de DotMD solo responde en tu Mac, así que la app de ChatGPT no puede usarlo. Para los modelos de OpenAI, usa Codex.

Preguntas sobre Codex y DotMD

Más preguntas