Connecter imagic à OpenAI Codex CLI

1Installez imagic et lancez l’essai

Le serveur MCP est livré avec imagic Max, et l’essai gratuit de 500 exports débloque tout, sans carte. Téléchargez d’abord imagic depuis la page de l’application de bureau, car Codex CLI a besoin d’un interlocuteur.

2Ajoutez imagic à Codex CLI

Codex CLI exécute directement les serveurs MCP locaux, sans tunnel ni point d’accès distant.

codex mcp add imagic -- imagic-mcp

Vous avez installé l’application empaquetée depuis ce site ? Il n’y a alors aucune commande imagic-mcp sur votre machine : l’application elle-même est le serveur (exemple sous Windows ; sous macOS, c’est /Applications/imagic.app/Contents/MacOS/imagic) :

codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

Configuration

Codex CLI lit ~/.codex/config.toml. La clé de premier niveau est mcp_servers, qui n’est pas la clé mcpServers utilisée par la plupart des autres clients.

[mcp_servers.imagic]
command = "imagic-mcp"

Vous avez installé l’application empaquetée depuis ce site ? Il n’y a alors aucune commande imagic-mcp sur votre machine : l’application elle-même est le serveur. Faites pointer command vers elle et passez --mcp (exemple sous Windows ; sous macOS, la commande est /Applications/imagic.app/Contents/MacOS/imagic) :

[mcp_servers.imagic]
command = "C:\\Program Files\\imagic\\imagic.exe"
args = ["--mcp"]

Où se trouve ce fichier

OpenAI ne publie ce chemin que sous la forme ~, sans équivalent documenté pour Windows ; utilisez donc la commande ou l’interface ci-dessus plutôt que de deviner son emplacement.

3Demandez un tri

Redémarrez Codex CLI s’il était déjà lancé, puis indiquez-lui une séance :

Trie la séance de D:/Shoots/eva_tom, applique mon style et exporte les photos retenues.

Codex CLI appellera tour à tour scan_directory, analyze_photos, apply_my_style et export_photos. Chacun d’eux s’exécute sur votre machine : l’agent envoie des instructions, jamais vos photos.

Les pièges à éviter

• C’est du TOML, pas du JSON, et la clé est mcp_servers avec un tiret bas.
• Un fichier .codex/config.toml limité au projet n’est chargé que si vous faites confiance au projet.
• Le délai de démarrage est de 10 secondes par défaut et celui des outils de 60 ; augmentez startup_timeout_sec si une grande bibliothèque s’ouvre lentement.
• OpenAI ne publie aucun chemin propre à Windows pour config.toml.

Ce qu’imagic peut faire une fois connecté

Cela fait 25 outils au total, couvrant la bibliothèque, le tri, la retouche et votre style appris. Consultez la référence complète des outils, ou les workflows pour savoir quoi demander concrètement.

Vous configurez un autre client ?

Configuration vérifiée d’après la documentation de OpenAI. Si Codex CLI modifie son installation et que cette page prend du retard, dites-le-nous et nous la corrigerons.