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.
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
Sous Linux, faites pointer la commande vers le binaire imagic situé dans le dossier où vous avez extrait la version portable, et conservez l’argument --mcp.
N’installez pas de paquet npm nommé imagic-mcp pour que cela fonctionne : le paquet npm portant ce nom est un projet sans rapport avec le nôtre, d’un autre auteur. Le serveur MCP d’imagic est intégré à l’application de bureau.
Vous lancez plutôt imagic depuis une copie du code source (réservé aux développeurs, ce n’est pas l’application empaquetée) ? Le point d’entrée de cette copie ressemble à ceci :
codex mcp add imagic -- imagic-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.
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"]
Vous lancez plutôt imagic depuis une copie du code source (réservé aux développeurs, ce n’est pas l’application empaquetée) ? Le point d’entrée de cette copie ressemble à ceci :
[mcp_servers.imagic] command = "imagic-mcp"
Où se trouve ce fichier
| macOS | ~/.codex/config.toml |
|---|---|
| Linux | ~/.codex/config.toml |
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 30 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 ?
Essayez-le sur une vraie séance
L’essai de 500 exports inclut imagic Max, le serveur MCP et tous les outils de cette page. Sans carte.
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.