DotMD
DotMD es un servidor MCP.Tus agentes ven lo que estás leyendo.
DotMD ejecuta un servidor MCP local en tu Mac. Claude Code, Codex, Cursor o cualquier cliente MCP pueden abrir tus archivos Markdown, leer tu selección y tus comentarios, señalar líneas y enviarte una spec para revisar.
macOS 14 o posterior. Leer es gratis; DotMD Pro tiene 3 días de prueba gratuita.
Respuesta rápida
Settings → MCP → MCP server lo inicia en http://127.0.0.1:8089/mcp. Añade esa dirección a tu agente una sola vez. El agente podrá entonces abrir archivos en DotMD, leer tu selección y tus comentarios, resaltar líneas y enviarte un documento para revisar. Las revisiones y las herramientas para agentes forman parte de DotMD Pro (3 días de prueba gratuita); leer sigue siendo gratis.
Activa el servidor MCP de Markdown
Es un servidor MCP para trabajar con tus archivos Markdown en DotMD: abrirlos, leer lo que comentas y revisar lo que escribe el agente. No es un conversor que pase otros formatos a Markdown. Todo se hace en Settings → MCP:
- MCP server inicia el servidor. El estado de arriba se pone verde y muestra Listening.
- Start with DotMD lo inicia cada vez que arranca DotMD.
- Port es 8089 por defecto. Después de cambiarlo, apaga y vuelve a encender el servidor.
- La dirección,
http://127.0.0.1:8089/mcp, aparece arriba, con un botón para copiarla.
El servidor funciona mientras DotMD está abierto. Si cierras DotMD, el agente no puede alcanzarlo.
Conecta tu agente al servidor MCP
Añade la dirección del servidor una sola vez, de la forma en que lo hace tu agente.
Claude Code
Ejecuta esto en Terminal. Los detalles están en la guía de Claude Code.
claude mcp add --transport http dotmd http://127.0.0.1:8089/mcpCodex
En la app de Codex abre Settings → MCP servers → Add server y elige Streamable HTTP, o añade esto a ~/.codex/config.toml. La línea tool_timeout_sec permite que Codex espere mientras revisas. Más en la guía de Codex.
[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600Cursor, Visual Studio Code y otros
Añade un servidor con esta configuración. La guía de Cursor tiene los pasos.
{
"mcpServers": {
"dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
}
}Qué puede hacer el agente con DotMD
El servidor da al agente doce herramientas:
| Herramienta | Qué hace |
|---|---|
open_file | Abre un archivo o una carpeta en DotMD, opcionalmente en una línea, que se resalta |
request_review | Te envía a revisar un documento que escribió el agente y espera hasta que pulses Send o Approve |
get_current_file | Qué archivo está abierto, su título, el modo y la sección que estás leyendo |
get_selection | El texto que seleccionaste, con sus números de línea |
highlight | Se desplaza a unas líneas y las resalta unos segundos |
show_changes | Muestra los cambios del agente junto a sus comentarios, o en el historial de versiones |
list_files | Los archivos Markdown de tu espacio de trabajo, con sus títulos |
search | Busca en el texto de todos los archivos del espacio de trabajo |
get_review_comments | Los comentarios de un archivo, tuyos o de un agente revisor |
add_review_comments | Deja comentarios en líneas de un archivo, como revisor, con el nombre del agente |
complete_review | Te avisa de que un agente revisor ha terminado, con su veredicto y un resumen de una frase |
resolve_review_comments | Te devuelve comentarios para revisar, cada uno con una nota y las líneas cambiadas por él |
El ciclo de una spec: el agente la escribe y llama a request_review, tú comentas, pulsas Send, y el agente corrige cada comentario y lo devuelve con resolve_review_comments. Mira cómo se ve en la guía de Claude Code.
Ves cada llamada
Recent Requests en Settings → MCP muestra lo que hizo cada asistente, con palabras sencillas: «Codex · Opened plans/auth.md at line 42» con una marca verde, «Searched for “rate limit” (5 matches)» o «Couldn't open ~/notes/a.md — no access» con una cruz roja. Pasa el cursor sobre una línea para ver la ruta completa o el motivo. Technical details muestra en su lugar las peticiones HTTP sin procesar. La lista se conserva solo mientras DotMD está abierto.
Seguridad: quién puede llegar al servidor
- El servidor escucha solo en 127.0.0.1, así que otros ordenadores no pueden alcanzarlo.
- Las páginas web no pueden usarlo. Se rechaza cualquier petición que venga de un navegador, y también una cuya dirección no nombre este Mac, lo que además frena el DNS rebinding.
- Solo acepta peticiones JSON, que un formulario web no puede enviar.
- Nunca escribe archivos. Las herramientas actúan sobre la ventana de DotMD en primer plano.
- Solo abre archivos a los que DotMD tiene acceso: tu espacio de trabajo, Descargas y, si lo permitiste, tu carpeta personal. Para cualquier otra cosa se le indica al agente que te pida añadir la carpeta al espacio de trabajo.
Las peticiones rechazadas aparecen en Recent Requests en rojo, con el motivo.
Agentes en Docker
Dentro de un contenedor Docker, 127.0.0.1 es el propio contenedor, no tu Mac. Con Docker Desktop, los contenedores llegan al Mac como host.docker.internal, así que usa esa dirección:
claude mcp add --transport http dotmd http://host.docker.internal:8089/mcpOtros clientes usan la misma dirección en su configuración. Todos los contenedores de este Mac pueden alcanzar el servidor así, igual que cualquier otro servidor que Docker Desktop deja pasar hasta tu Mac. Los ordenadores de tu red siguen sin poder.
Preguntas sobre el servidor MCP de DotMD
¿Pueden otros ordenadores alcanzar el servidor MCP de DotMD?
No. Escucha solo en 127.0.0.1. Los contenedores Docker de este Mac sí pueden, mediante host.docker.internal.
¿Puede usarlo una página web?
No. Se rechazan las peticiones de un navegador, y solo se aceptan peticiones JSON de este Mac.
¿El servidor escribe mis archivos?
No. Nunca escribe archivos; actúa sobre la ventana de DotMD en primer plano.
El puerto 8089 está ocupado.
Cambia el puerto en Settings → MCP, apaga y vuelve a encender el servidor, y actualiza la dirección en tu agente.