Codex écrit la spec.Vous la relisez dans DotMD.

Connecter Codex : avec l’app ou config.toml

DotMD fait tourner un petit serveur MCP sur votre Mac. Codex s’en sert pour ouvrir des fichiers dans DotMD, vous envoyer des documents à relire et lire vos commentaires. L’app Codex, la CLI Codex et l’extension Codex de votre IDE partagent une seule configuration : vous ne la faites qu’une fois.

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 le serveur dans Codex

   Dans l’app Codex, ouvrez Settings → MCP servers → Add server, choisissez Streamable HTTP et collez l’adresse affichée en haut de Settings → MCP de DotMD. Par défaut, c’est http://127.0.0.1:8089/mcp.

3. Ou modifiez config.toml

   Vous préférez un fichier ? Ajoutez ceci à ~/.codex/config.toml. Settings → MCP dans DotMD propose un bouton pour le copier :

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

   Redémarrez Codex après l’avoir ajouté.

4. Vérifiez qu’il répond

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

Pourquoi tool_timeout_sec compte

Quand Codex vous envoie une spec à relire, il attend dans un seul appel d’outil MCP que vous cliquiez sur Send ou Approve. Il ne consomme aucun token pendant ce temps. Mais Codex abandonne un appel d’outil au bout d’une minute si vous ne lui dites pas autre chose, et une relecture dure plus longtemps.

tool_timeout_sec = 3600 permet à Codex d’attendre jusqu’à une heure. Sans cette ligne, Codex cesse d’attendre et votre relecture n’a plus de destinataire. Rien n’est perdu : vos commentaires restent dans DotMD, et vous pouvez dire à Codex « Lis mes commentaires dans DotMD et corrige-les » quand vous avez fini. Mais la boucle fonctionne mieux quand Codex vous attend encore.

Aidez Codex à trouver vos commentaires

Codex ne consulte ses outils MCP que lorsqu’il pense en avoir besoin. À « corrige les commentaires de paywall.md », il peut chercher dans le projet au lieu de les lire dans DotMD, parce que vos commentaires sont conservés par DotMD, pas dans le fichier. Il y a deux façons de le mettre sur la bonne voie.

La première est de mentionner DotMD dans la demande : « corrige les commentaires de paywall.md dans DotMD ». La seconde est d’ajouter ces lignes une fois à ~/.codex/AGENTS.md, ou à l’AGENTS.md d’un projet :

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.

Avec ces lignes, Codex vous envoie chaque spec qu’il écrit et cherche toujours vos commentaires dans DotMD.

Votre première relecture d’une spec Codex

Demandez le document à Codex, 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. Codex vous envoie le fichier

   Il enregistre la spec et vous l’envoie. Une notification apparaît, le fichier est listé sous Needs You, et Codex attend.

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. Codex reçoit tous vos commentaires d’un coup. Si vous n’avez rien à changer, le bouton affiche Approve.

4. Vous vérifiez chaque correction dans le fichier

   Codex modifie le fichier et 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. Acceptez-la avec Accept, rouvrez-la avec Reopen, ou tout accepter avec Accept All. Puis Approve, ou envoyez un nouveau tour.

Codex peut aussi être le relecteur. Demandez-lui « relis docs/compare.md dans DotMD et laisse tes commentaires sur les lignes », et ses commentaires apparaissent sous son nom. Voir Un agent relit l’autre.

L’app ChatGPT ne peut pas se connecter

L’app ChatGPT atteint les serveurs MCP depuis les serveurs d’OpenAI sur internet, pas depuis votre Mac. Le serveur de DotMD ne répond que sur votre Mac : l’app ChatGPT ne peut donc pas l’utiliser. Pour les modèles d’OpenAI, utilisez Codex.

Questions sur Codex et DotMD

Plus de questions