Claude Code écrit le plan.Vous le relisez dans DotMD.

Connecter Claude Code à DotMD

DotMD fait tourner un petit serveur MCP sur votre Mac. Claude Code s’en sert pour ouvrir des fichiers dans DotMD, vous envoyer des documents à relire et lire vos commentaires. La configuration prend une minute.

1. Activez le serveur MCP de DotMD

   Dans DotMD, ouvrez Settings → MCP et activez MCP server. Le statut passe au vert. Activez aussi Start with DotMD pour que le serveur soit prêt dès que DotMD est ouvert.

2. Ajoutez DotMD à Claude Code

   Lancez ceci une fois dans le Terminal :

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

   -s user configure DotMD pour tous vos projets, et pas seulement pour le dossier où vous avez lancé la commande. Si vous avez ajouté DotMD auparavant sans cette option, cette entrée appartient à un seul projet : exécutez claude mcp remove -s local dotmd dans ce projet pour la supprimer. Si vous avez changé le port, copiez l’adresse affichée en haut de Settings → MCP.

3. Vérifiez qu’il répond

   Demandez à Claude Code d’ouvrir un fichier Markdown dans DotMD. Le fichier s’ouvre, et Recent Requests dans Settings → MCP affiche l’appel en mots simples, avec une coche verte.

Voir et commenter un plan de Claude Code

Demandez le document à Claude Code, en précisant où l’enregistrer et que vous voulez le relire :

« Écris la spec dans docs/spec.md et envoie-la-moi dans DotMD pour relecture. »

1. Claude Code vous envoie le fichier

   Il enregistre la spec et vous l’envoie pour relecture. Une notification apparaît, le fichier figure sous Needs You et Claude Code attend. Il ne consomme aucun token pendant votre lecture, quelle qu’en soit la durée.

2. Vous commentez les passages

   Lisez la spec mise en forme, avec ses tableaux, diagrammes et code. Sélectionnez un passage à modifier, appuyez sur ⌥⌘M et écrivez ce que vous voulez. Parcourez tout le document avant d’envoyer quoi que ce soit.

3. Vous envoyez les commentaires

   Cliquez sur Send en bas du panneau Review. Claude Code reçoit tous vos commentaires d’un coup. S’il n’y a rien à changer, le bouton indique Approve.

4. Vous vérifiez chaque correction dans le fichier

   Claude Code modifie le fichier et vous renvoie chaque commentaire avec une note sur ce qu’il a fait. Chaque correction se trouve à côté du commentaire auquel elle répond, l’ancien texte en rouge et le nouveau en vert. Choisissez Accept, Reopen ou Accept All.

5. Vous approuvez

   Après ses corrections, Claude Code attend de nouveau. Ajoutez des commentaires et cliquez sur Send pour un autre tour, ou cliquez sur Approve et il continue, par exemple avec le code.

En faire une habitude : quelques lignes dans CLAUDE.md

Claude Code envoie un document à relire quand vous le lui demandez. Pour qu’il le fasse à chaque fois et cherche toujours vos commentaires dans DotMD, ajoutez ces lignes à CLAUDE.md dans votre projet, ou à ~/.claude/CLAUDE.md pour tous vos projets :

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 première ligne compte le plus. Vos commentaires sont conservés par DotMD, pas dans le fichier : un agent qui ne pense pas à DotMD les cherche dans le projet et ne trouve rien.

DotMD peut aussi ajouter ces règles au fichier à votre place en un clic : voir CLAUDE.md et AGENTS.md sur Mac.

Vous utilisez le plan mode ? Voir Plan mode de Claude Code : où les plans sont enregistrés et comment les relire.

Quoi demander à Claude Code

Une fois DotMD connecté, Claude Code peut aussi vous montrer des choses dans DotMD, pas seulement vous envoyer des documents. Quelques demandes qui marchent bien :

• « Écris le plan dans docs/plan.md et ouvre-le dans DotMD. »
• « Montre-moi dans DotMD où tu as changé les prix. »
• « J’ai laissé des commentaires sur le plan dans DotMD. Traite-les. »
• « Réécris le paragraphe que j’ai sélectionné dans DotMD. »
• « Relis docs/compare.md dans DotMD et laisse tes commentaires sur les lignes. »

La dernière fait de Claude Code le relecteur : ses commentaires apparaissent dans DotMD sous son nom, et vous choisissez ceux que reçoit l’auteur. Voir Un agent relit l’autre.

Claude Code dans un conteneur Docker

Dans un conteneur, 127.0.0.1 désigne le conteneur lui-même, pas votre Mac. Docker Desktop permet aux conteneurs de joindre le Mac via host.docker.internal : ajoutez DotMD avec cette adresse :

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

Les autres ordinateurs ne peuvent toujours pas joindre DotMD : le serveur ne répond que sur ce Mac. Le guide du serveur MCP donne les détails.

Questions sur Claude Code et DotMD

Plus de questions