Claude Code escribe el plan.Tú lo revisas en DotMD.

Cómo conectar Claude Code a DotMD

DotMD ejecuta un pequeño servidor MCP en tu Mac. Claude Code lo usa para abrir archivos en DotMD, enviarte documentos para revisar y leer tus comentarios. Configurarlo lleva un minuto.

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 DotMD a Claude Code

   Ejecuta esto una vez en Terminal:

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

   Así se añade DotMD al proyecto en el que estás. Para tenerlo en todos tus proyectos, pon --scope user antes de dotmd. Si cambiaste el puerto, copia la dirección que aparece arriba en Settings → MCP.

3. Comprueba que responde

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

Ver y comentar un plan de Claude Code

Pide a Claude Code el documento y dile dónde guardarlo y que quieres revisarlo:

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

1. Claude Code te envía el archivo

   Guarda la spec y te la envía para que la revises. Aparece una notificación, el archivo figura en Needs You y Claude Code espera. No gasta tokens mientras lees, tardes lo que tardes.

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 al pie del panel Review. Claude Code recibe todos tus comentarios a la vez. Si no hay nada que cambiar, el botón dice Approve.

4. Revisas cada corrección en el archivo

   Claude Code edita el archivo y te devuelve cada comentario con una nota sobre lo que hizo. Cada corrección aparece junto al comentario al que responde, el texto antiguo en rojo y el nuevo en verde. Usa Accept, Reopen o Accept All.

5. Apruebas

   Tras sus correcciones, Claude Code vuelve a esperar. Deja más comentarios y haz clic en Send para otra ronda, o haz clic en Approve y seguirá adelante, por ejemplo con el código.

Que sea un hábito: unas líneas en CLAUDE.md

Claude Code envía un documento para revisar cuando se lo pides. Para que lo haga siempre y busque tus comentarios en DotMD, añade estas líneas a CLAUDE.md en tu proyecto, o a ~/.claude/CLAUDE.md para todos tus proyectos:

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.

La primera línea es la más importante. Tus comentarios los guarda DotMD, no el archivo, así que un agente que no piensa en DotMD los busca en el proyecto y no encuentra nada.

Qué pedirle a Claude Code

Con DotMD conectado, Claude Code puede enseñarte cosas en DotMD, además de enviarte documentos. Algunas peticiones que funcionan bien:

• «Escribe el plan en docs/plan.md y ábrelo en DotMD.»
• «Enséñame en DotMD dónde cambiaste los precios.»
• «He dejado comentarios en el plan en DotMD. Repásalos.»
• «Reescribe el párrafo que he seleccionado en DotMD.»
• «Revisa docs/compare.md en DotMD y deja tus comentarios en las líneas.»

La última convierte a Claude Code en revisor: sus comentarios aparecen en DotMD con su nombre y tú eliges cuáles recibe quien escribió el documento. Consulta Un agente revisa a otro.

Claude Code en un contenedor Docker

Dentro de un contenedor, 127.0.0.1 es el propio contenedor, no tu Mac. Docker Desktop permite a los contenedores llegar al Mac como host.docker.internal, así que añade DotMD con esa dirección:

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

Otros ordenadores siguen sin poder llegar a DotMD: el servidor solo responde en este Mac. La guía del servidor MCP tiene los detalles.

Preguntas sobre Claude Code y DotMD

Más preguntas