Configuration MCP : connecter Merlin Project à Codex

Codex est l'agent de terminal d'OpenAI, donc le pendant de Claude Code pour qui dispose déjà d'un abonnement OpenAI. Comme tout client MCP, Codex ne connaît votre plan de projet qu'une fois le serveur Merlin déclaré ; ensuite il lit tâches, échéances et ressources directement dans le projet partagé. Une ligne dans le terminal y suffit. Cet article explique comment cette commande est bâtie, comment vérifier la connexion, et se termine par un point d'avancement issu de données réelles du plan.

La vidéo de cet article

La vidéo (en allemand) est intégrée à la version allemande de cet article.

Ce qu'il vous faut

  • Merlin Project dans sa version actuelle, serveur MCP installé, projet partagé
  • Codex, installé et connecté ; sans connexion, la commande tombe dans le vide

Le côté Merlin est identique pour tous les clients :

  1. Installez le serveur. Dans Merlin Project, ouvrez le menu Merlin Project et choisissez Install MCP Server. Merlin dépose un petit programme sur votre Mac, le pont entre le client IA et le plan. L'installateur affiche le chemin ; il s'agit de /usr/local/bin/merlinproject-mcp.
  2. Partagez le projet. Ouvrez le projet et cliquez sur AI Tools dans la barre d'outils. Cochez Autoriser les outils d’IA à interagir avec le document ; le symbole s'affiche plein. Le partage ne vaut que pour ce projet, tous les autres restent invisibles pour le serveur. Dès qu'un client est connecté, le symbole passe au bleu.
Un clic partage ce projet précis : AI Tools dans la barre d'outils, puis activer Autoriser les outils d’IA à interagir avec le document. Tous les autres projets restent invisibles pour le serveur.

local · lecture seule · inaccessible à distance. Le serveur ne lit que les projets que vous partagez, ne modifie rien dans vos données, et personne ne l'atteint depuis l'extérieur. Ce qu'un client dans le nuage voit des données lues est expliqué dans l'article sur la protection des données.

Étape 1 : faire connaître le serveur à Codex

Ouvrez le terminal et saisissez cette seule ligne :

Connecter Terminal

codex mcp add merlin-project -- /usr/local/bin/merlinproject-mcp

La ligne comporte deux moitiés. Tout ce qui précède le double tiret s'adresse à Codex : retiens un serveur nommé merlin-project. Tout ce qui suit est le programme que Codex doit lancer pour ce serveur. Codex confirme que le serveur est enregistré.

Étape 2 : vérifier dans la session

Le serveur est désormais enregistré. Pour savoir si Codex le voit aussi dans la session en cours, vous utilisez une commande dans Codex lui-même. Lancez Codex avec codex et saisissez :

Vérifier, dans la session Codex en cours Codex

/mcp

Codex énumère les serveurs connectés ; merlin-project en fait partie.

La première question : le point d'avancement

Venons-en à la question qui compte. Vous voulez l'état de votre projet en quelques phrases, plus les jalons atteints et les prochaines échéances critiques, tel que vous l'enverriez à un donneur d'ordre :

Prompt: Comment informer le comité de pilotage ?

Crée à partir des données actuelles du projet un point d'étape pour le comité de pilotage : une demi-page au maximum, compréhensible pour des lecteurs sans connaissance détaillée. Structure : statut global en une phrase, avancement depuis le dernier point, risques actuels, décisions nécessaires. Évite le jargon et indique pour chaque risque le jalon concerné.

Voir ce prompt dans la bibliothèque ›

Codex lit le plan via MCP et rédige le point avec les vraies échéances. Si une tâche se décale demain, Codex rédigera demain la version actualisée. Au premier appel d'outil, Codex demande votre accord.

Si le serveur n'apparaît pas

  • Commande inconnue ? Codex n'est pas installé ou le chemin manque dans le terminal. Vérifiez l'installation, ouvrez un nouveau terminal.
  • Enregistré mais absent de /mcp ? Quittez la session Codex et relancez-la ; les sessions en cours ne rechargent pas la configuration.
  • Réponse vide ? Partagez le projet dans Merlin via « AI Tools » ; comparez le chemin avec celui de l'installateur.

Liste de contrôle

Pour s'exercer, le projet d'exemple Produktlaunch Phoenix convient. D'autres formats de rapport figurent dans la bibliothèque de prompts. Le pendant Claude dans le terminal, avec l'appel pour des rapports automatiques, est décrit dans l'article sur Claude Code. Tous les guides :

Si vous avez des questions sur cet article de blog ou si vous souhaitez en discuter, nous attendons avec impatience votre contribution dans notre forum.

Planifiez des projets qui fonctionnent vraiment.

Une app pour votre plan de projet, native sur tous les appareils Apple.