Guide d'intégration d'Eulerian MCP avec OpenAI Codex CLI
EULERIAN MCP
Guide d'installation — pour débutants
Connecter Eulerian à OpenAI Codex CLI
Un pas-à-pas sans jargon — d'une machine vierge jusqu'aux données Eulerian en direct
Ce guide vous montre, clic par clic, comment connecter le MCP Eulerian Marketing Platform à OpenAI Codex CLI (l'assistant d'OpenAI qui s'exécute dans une fenêtre de terminal). À la fin, vous pourrez poser à Codex des questions sur vos données Eulerian en langage naturel. Bonne nouvelle : Codex se connecte avec votre compte ChatGPT — aucune clé API nécessaire.
Ce dont vous aurez besoin (5 minutes) :
Un ordinateur sur lequel installer des logiciels
Votre URL d'endpoint Eulerian et votre jeton API (demandez-les à votre contact Eulerian, ils ressemblent à https://<votre>.api.eulerian.com/mcp et à une longue chaîne secrète)
Un compte ChatGPT (gratuit ou payant).
C'est tout.
Étape 1 Installer les deux prérequis de Codex
Codex CLI a besoin de Node.js (pour installer et lancer Codex) et de Python 3.10+ (pour exécuter le petit « pont » Eulerian). Installez les deux si vous ne les avez pas déjà :
- Node.js : rendez-vous sur https://nodejs.org , téléchargez la version « LTS », lancez l'installateur et continuez avec Suivant.
- Python : rendez-vous sur https://www.python.org/downloads/ , téléchargez la 3.10 ou plus récente. Sous Windows, cochez « Add Python to PATH » sur le premier écran de l'installateur.
Installez ensuite le pont Eulerian. Ouvrez un terminal (Windows : bouton Démarrer, tapez cmd, Entrée — une fenêtre noire s'ouvre ; macOS : ouvrez l'app Terminal) et tapez :
pip install eulerian-marketing-platform
Étape 2 Installer Codex CLI
Dans le même terminal, tapez ceci puis Entrée :
npm install -g @openai/codex
Une fois terminé, vérifiez qu'il est bien là :
codex --version
Vous devriez voir un numéro de version (nous avons testé avec codex-cli 0.142.5).
Étape 3 Se connecter (avec votre compte ChatGPT — sans clé API)
Tapez :
codex login
Votre navigateur s'ouvre. Connectez-vous avec votre compte ChatGPT et validez. Revenez au terminal — vous êtes connecté.
Pourquoi c'est agréable : contrairement à certains autres assistants en terminal, Codex ne vous demande pas de créer et coller une clé API. Votre connexion ChatGPT habituelle suffit.
Étape 4 Indiquer Eulerian à Codex (modifier un fichier de configuration)
Codex stocke ses réglages dans un fichier config.toml. Son emplacement :
Windows
%USERPROFILE%\.codex\config.toml
macOS / Linux
~/.codex/config.toml
Le plus rapide sous Windows : dans le terminal, tapez notepad %USERPROFILE%\.codex\config.toml puis Entrée (cliquez « Oui » s'il propose de créer le fichier). Collez le bloc ci-dessous, puis remplacez l'endpoint et le jeton par les vôtres :
[mcp_servers.eulerian-marketing-platform]command = "C:/Users/vous/AppData/Local/Programs/Python/Python312/python.exe"args = ["-m", "eulerian_marketing_platform.server"]startup_timeout_sec = 60[mcp_servers.eulerian-marketing-platform.env]EMP_API_ENDPOINT = " https://votre-instance-eulerian.com/mcp "EMP_API_TOKEN = "collez-ici-votre-jeton-eulerian"
Deux pièges courants : (1) le nom de section est mcp_servers avec un underscore. (2) Sous Windows, faites pointer command vers le chemin complet de votre Python. Vous ne savez pas où il est ? Lancez python -c "import sys; print(sys.executable)" et copiez ce qui s'affiche. Enregistrez le fichier.
Étape 5 Vérifier la connexion
Lancez Codex en tapant codex puis Entrée. Tapez ensuite /mcp et Entrée. Vous devriez voir le serveur Eulerian listé avec ses outils — environ 134 outils — ce qui signifie que la connexion fonctionne.
Codex CLI après avoir tapé /mcp : le serveur Eulerian est connecté et 134 outils sont disponibles.
Astuce : si vous lancez codex mcp list, vous verrez peut-être Auth : Unsupported à côté du serveur. C'est normal et sans conséquence — cela concerne le système de connexion optionnel propre à Codex, pas Eulerian, qui utilise votre jeton.
Étape 6 Essayez — demandez vos données
Il suffit de demander, en langage naturel. Une bonne première question :
Quels sites puis-je interroger avec mon compte Eulerian ?
Codex appelle l'outil Eulerian et liste vos sites — de vraies données, directement depuis votre compte :
Codex répondant avec la liste réelle des sites du compte Eulerian (nom du client masqué).
Voilà toute l'installation. Vous pouvez ensuite poser des questions métier en langage naturel — par exemple « montre-moi les visites de la semaine dernière » ou « compare coût et revenus ce mois-ci ».
Aller plus loin — reporting réel (et ce que nous avons vérifié)
Codex ne se contente pas de lister les sites ; il exécute aussi des requêtes de reporting complètes. Interrogé sur une évolution quotidienne des visites, il lit le guide de requêtes d'Eulerian, découvre les bons champs et renvoie un tableau propre jour par jour :
Codex renvoyant une évolution des visites jour par jour sur les 7 derniers jours (nom du client masqué).
Note de validation (pour mémoire) : Codex CLI a été testé de bout en bout sous Windows et a fonctionné d'origine — connexion, découverte des outils (134) et reporting multi-étapes réussis, sans clé API (connexion via compte ChatGPT).
Si quelque chose ne fonctionne pas
« codex n'est pas reconnu »
Node.js n'est pas installé, ou le terminal n'a pas été rouvert après son installation. Installez Node.js, puis ouvrez un nouveau terminal.
Le serveur apparaît mais sans outils / bloque au premier lancement
La première découverte peut prendre 20–30 s. Conservez startup_timeout_sec = 60 dans la config et patientez un instant.
« Python introuvable »
Utilisez le chemin complet de python.exe dans command (voir Étape 4).
Auth : Unsupported m'inquiète
Ignorez-le — normal et sans conséquence (voir Étape 5).