DotMD est un serveur MCP.Vos agents voient ce que vous lisez.

Activer le serveur MCP Markdown

C’est un serveur MCP pour travailler avec vos fichiers Markdown dans DotMD : les ouvrir, lire ce que vous commentez et relire ce que l’agent écrit. Ce n’est pas un convertisseur qui transforme d’autres formats en Markdown. Tout se passe dans Settings → MCP :

• MCP server démarre le serveur. L’état, en haut, passe au vert et affiche Listening.
• Start with DotMD le démarre à chaque lancement de DotMD.
• Port vaut 8089 par défaut. Après l’avoir changé, éteignez puis rallumez le serveur.
• L’adresse, http://127.0.0.1:8089/mcp, s’affiche en haut, avec un bouton pour la copier.

Le serveur tourne tant que DotMD est ouvert. Si vous fermez DotMD, l’agent ne peut plus l’atteindre.

Connectez votre agent au serveur MCP

Ajoutez l’adresse du serveur une fois, à la manière de votre agent.

Claude Code

Exécutez ceci dans Terminal. Les détails sont dans le guide Claude Code.

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

Codex

Dans l’app Codex, ouvrez Settings → MCP servers → Add server et choisissez Streamable HTTP, ou ajoutez ceci à ~/.codex/config.toml. La ligne tool_timeout_sec permet à Codex d’attendre pendant que vous relisez. Plus de détails dans le guide Codex.

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

Cursor, Visual Studio Code et les autres

Ajoutez un serveur avec cette configuration. Le guide Cursor donne les étapes.

{
  "mcpServers": {
    "dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
  }
}

Ce que l’agent peut faire avec DotMD

Le serveur donne à l’agent douze outils :

La boucle pour une spec : l’agent l’écrit et appelle request_review, vous commentez et cliquez sur Send, puis l’agent corrige chaque commentaire et le renvoie avec resolve_review_comments. Voyez à quoi cela ressemble dans le guide Claude Code.

Vous voyez chaque appel

Recent Requests dans Settings → MCP montre ce que chaque assistant a fait, en termes simples : « Codex · Opened plans/auth.md at line 42 » avec une coche verte, « Searched for “rate limit” (5 matches) » ou « Couldn't open ~/notes/a.md — no access » avec une croix rouge. Survolez une ligne pour voir le chemin complet ou la raison. Technical details affiche à la place les requêtes HTTP brutes. La liste n’est conservée que tant que DotMD est ouvert.

Sécurité : qui peut atteindre le serveur

• Le serveur n’écoute que sur 127.0.0.1 : les autres ordinateurs ne peuvent pas l’atteindre.
• Les pages web ne peuvent pas l’utiliser. Toute requête venant d’un navigateur est refusée, de même qu’une requête dont l’adresse ne désigne pas ce Mac, ce qui bloque aussi le DNS rebinding.
• Il n’accepte que des requêtes JSON, qu’un formulaire web ne peut pas envoyer.
• Il n’écrit jamais de fichiers. Les outils agissent sur la fenêtre DotMD au premier plan.
• Il n’ouvre que les fichiers auxquels DotMD a accès : votre espace de travail, Téléchargements et, si vous l’avez autorisé, votre dossier personnel. Pour tout le reste, l’agent est invité à vous demander d’ajouter le dossier à l’espace de travail.

Les requêtes refusées apparaissent dans Recent Requests en rouge, avec la raison.

Agents dans Docker

Dans un conteneur Docker, 127.0.0.1 désigne le conteneur lui-même, pas votre Mac. Avec Docker Desktop, les conteneurs atteignent le Mac sous le nom host.docker.internal : utilisez cette adresse :

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

Les autres clients prennent la même adresse dans leur configuration. Tous les conteneurs de ce Mac peuvent atteindre le serveur ainsi, comme n’importe quel autre serveur que Docker Desktop laisse passer vers votre Mac. Les ordinateurs de votre réseau, eux, ne le peuvent toujours pas.

Questions sur le serveur MCP de DotMD

Plus de questions