Guide d'intégration d'Eulerian MCP avec Gemini CLI

Guide d'intégration d'Eulerian MCP avec Gemini CLI

EULERIAN MCP
  • Guide d'intégration avec Gemini CLI
  • Pas à pas, aucune expérience requise | ~15–20 minutes | Gemini CLI
  • Cible : Développeurs et ingénieurs préférant les flux de travail en ligne de commande pour le code


1. Qu'est-ce que le MCP Eulerian

Le MCP Eulerian est un connecteur qui permet à votre assistant IA de lire directement vos données Eulerian Marketing Platform. Au lieu d'ouvrir des tableaux de bord ou d'exporter des fichiers, vous posez simplement des questions en langage naturel.
Ce guide installe le MCP avec Gemini CLI, un assistant gratuit de Google qui s'exécute dans une fenêtre « terminal ».
Vous ne voulez pas utiliser de terminal ? Claude Desktop propose un installateur en un clic, sans aucune commande. Si vous n'êtes pas à l'aise avec les commandes, c'est peut-être l'option la plus simple. Ce guide-ci est spécifique à Gemini CLI.

2. Avant de commencer

Vous aurez besoin de ces cinq éléments. Ne vous inquiétez pas des aspects techniques, les étapes ci-dessous vous montrent exactement quoi faire.
    Un compte Eulerian (type Webmaster) : si vous n'en avez pas, demandez à votre administrateur de plateforme.
    Votre jeton API Eulerian : une chaîne de texte secrète fournie par (disponible sur votre compte Eulerian). Gardez-la en lieu sûr, vous la collerez à l'Étape 4.
    Votre URL d'endpoint Eulerian : ressemble à  https://VotreInstance.api.eulerian.com/mcp . (disponible sur votre compte Eulerian)
    Python et Node.js installés. Téléchargements gratuits :
    Python sur  python.org/downloads  (sous Windows, cochez « Add Python to PATH » lors de l'installation),
    Node.js sur  nodejs.org 
    Un compte Google gratuit, pour créer une clé API Gemini à l'Étape 5.

3. Comment ouvrir le terminal (vous l'utiliserez plusieurs fois)

Le « terminal » est une fenêtre où vous tapez des commandes. Pour l'ouvrir :
  • Windows : appuyez sur la touche Windows, tapez cmd et appuyez sur Entrée. Une fenêtre noire s'ouvre : c'est le terminal (ou invite de commande)
  • macOS : appuyez sur Cmd + Espace, tapez Terminal, Entrée
  • Linux : ouvrez votre application Terminal.
Comment l'utiliser :
  • Cliquez dans la fenêtre : tapez (ou collez) une commande, puis appuyez sur Entrée pour l'exécuter
  • Pour coller dans le terminal Windows, faites un clic droit (Ctrl+V peut ne pas marcher). Vous pouvez garder cette fenêtre ouverte et la réutiliser à chaque étape.

4. Installation pas à pas

Étape 1 : Installer Gemini CLI

Ouvrez le terminal (section 3). Tapez la ligne suivante et appuyez sur la touche Entrée de votre clavier (cela peut prendre une minute) :
npm install -g @google/gemini-cli
Une fois terminé, vérifiez en tapant :
gemini --version
Si vous voyez un numéro de version, c'est bon. (S'il indique « not recognised », fermez le terminal, ouvrez-en un nouveau et réessayez.)


Étape 2 : Installer le connecteur Eulerian

Dans le même terminal, tapez :
pip install eulerian-marketing-platform
Vous devriez terminer par une ligne du type « Successfully installed eulerian-marketing-platform ».


Étape 3 : Trouver votre chemin Python (et notez-le)

Gemini a besoin de l'emplacement exact de Python sur votre ordinateur. Dans le terminal, tapez :
python -c "import sys; print(sys.executable)"
Il affiche une ligne, par exemple :
C:\Users\vous\AppData\Local\Programs\Python\Python312\python.exe
Copiez toute cette ligne et gardez-la sous la main — vous la collerez à l'Étape 4. Pour copier dans le terminal Windows : sélectionnez le texte à la souris, puis appuyez sur Entrée. (Si la ligne contient WindowsApps, installez Python depuis  python.org  et relancez ceci.)


Étape 4 : Créer et éditer le fichier de configuration

Ce fichier indique à Gemini d'utiliser Eulerian. Il s'appelle settings.json et se trouve dans un dossier nommé .gemini.
Voici exactement comment le trouver ou le créer :
a. Ouvrir le dossier
  • Ouvrez l'Explorateur de fichiers (l'icône de dossier jaune, ou appuyez sur Touche Windows + E).
  • Cliquez dans la barre d'adresse en haut, tapez exactement :%USERPROFILE%\.gemini et appuyez sur Entrée.
  • Si le dossier n'existe pas : tapez %USERPROFILE% à la place → Entrée → puis clic droit → Nouveau → Dossier et nommez-le exactement .gemini, puis ouvrez-le.
b. Activer les extensions de fichiers (pour que le fichier ne soit pas secrètement un .txt)
  • Dans l'Explorateur de fichiers : ouvrez le menu Affichage → Afficher → cochez Extensions de noms de fichiers. Les fichiers montrent alors leur vraie terminaison, comme .json ou .txt.
c. Créer le fichier (passez si un settings.json existe déjà)
  • Clic droit dans une zone vide → Nouveau → Document texte.
  • Renommez-le exactement en settings.json (supprimez la terminaison .txt). Cliquez Oui sur l'avertissement.
d. Ouvrir le fichier et coller le contenu
  • Clic droit sur settings.json → Ouvrir avec → Bloc-notes
  • Supprimez tout ce qu'il contient, puis collez exactement ceci :
{"mcpServers": {"eulerian-marketing-platform": {"command": "PASTE-YOUR-PYTHON-PATH-HERE","args": ["-m", "eulerian_marketing_platform.server"],"timeout": 600000,"env": {"EMP_API_ENDPOINT": "PASTE-YOUR-EULERIAN-URL-HERE","EMP_API_TOKEN": "PASTE-YOUR-TOKEN-HERE"}}}}
e. Remplacez les trois marqueurs PASTE-… par vos propres valeurs (gardez les guillemets " " autour de chacune) :
  • "command" : insérer votre chemin Python de l'Étape 3.
  • "EMP_API_ENDPOINT" : insérer votre URL Eulerian (point 3 de « Avant de commencer »). Exemple : https://demonstration.api.eulerian.com/mcp(veiller à ce que l'url se termine bien par /mcp, au besoin ajoutez-le manuellement)
  • "EMP_API_TOKEN" : insérer votre jeton Eulerian (point 2).
Windows — très important à propos du chemin Python : remplacez chaque antislash simple \ par un double antislash \\. Par exemple, ceci :
C:\Users\vous\...\python.exedoit être saisi comme :C:\\Users\\vous\\...\\python.exe
Puis enregistrez le fichier : appuyez sur Ctrl+S
Emplacement du fichier de réglages, pour référence :
Votre ordinateur
Emplacement du fichier de réglages
Windows
%USERPROFILE%\.gemini\settings.json
macOS
~/.gemini/settings.json
Linux
~/.gemini/settings.json

Étape 5 : Obtenir et définir votre clé API Gemini

C'est une clé gratuite qui permet à Gemini de répondre (elle est distincte de votre jeton Eulerian).
    Dans un navigateur, ouvrez  https://aistudio.google.com/apikey  et connectez-vous avec Google.
    Cliquez Create API key, puis Copy (elle commence par AIza ou similaire).
    De retour au terminal, tapez set GEMINI_API_KEY= puis clic droit pour coller votre clé juste après le =, et Entrée :
set GEMINI_API_KEY=votre-cle-collee-ici
(macOS/Linux : utilisez export GEMINI_API_KEY=votre-cle.)


Étape 6 : Lancer Gemini et vérifier la connexion

    Dans le même terminal, tapez gemini et Entrée
    S'il demande d'approuver le dossier, choisissez « Trust folder ». S'il demande comment s'authentifier, choisissez « Use Gemini API key ».
    Tapez /mcp list et Entrée. Après quelques secondes, le serveur Eulerian devrait apparaître comme Ready, avec une liste d'outils :



Étape 7 : Essayez

Dans le terminal de commande, demandez à Gemini en langage naturel, par exemple : « Quels sites puis-je interroger avec mon compte Eulerian ? »
La première fois, il demandera l'autorisation d'exécuter un outil — dites oui. Quand vous voyez vos vraies données, c'est terminé. Félicitations !


5. Comment l'utiliser : exemples de questions


  • Comment nos campagnes de search payant ont-elles performé la semaine dernière ?
  • Quels canaux ont le plus contribué aux conversions ce mois-ci ?
  • Compare le coût et les revenus des campagnes ce mois-ci vs le mois dernier.
  • Quels outils Eulerian as-tu à disposition ?
Astuce : soyez précis. « Quel est le CPA de nos campagnes display le mois dernier ? » fonctionne bien mieux que « comment vont les campagnes ? ».


6. Sécurité


  • Gardez votre jeton et votre clé privés. Ce sont comme des mots de passe, ne les partagez pas, ne les mettez pas dans des captures d'écran ou des e-mails. Si l'un est vu par quelqu'un d'autre, créez-en un nouveau.
  • Vérifiez avec votre équipe IT avant d'utiliser de vraies données métier avec un outil d'IA.
  • Recontrôlez les chiffres importants dans l'interface Eulerian : l'IA peut occasionnellement formuler une requête de façon imparfaite.


7. Si quelque chose ne fonctionne pas


Si vous voyez ceci
Faites ceci
« gemini » n'est pas reconnu
Fermez le terminal et ouvrez-en un nouveau. Toujours en échec ? Tapez npx @google/gemini-cli au lieu de gemini.
« python » n'est pas reconnu
Réinstallez Python depuis  python.org  en cochant « Add Python to PATH ». Puis ouvrez un nouveau terminal.
Le serveur affiche « Disconnected » au premier essai
La découverte des outils peut prendre 20–30 secondes. Patientez un instant et relancez /mcp list. La ligne "timeout" de l'Étape 4 aide aussi.
Toujours « Disconnected », et vous suspectez le chemin Python
Revérifiez l'Étape 4 : le command doit être votre chemin Python exact avec des doubles antislashs (\\).
« Usage limit reached »
C'est le quota de votre modèle Gemini, pas Eulerian. Tapez /model pour changer de modèle, ou attendez la réinitialisation.
La connexion indique « no longer supported / Antigravity »
Utilisez plutôt une clé API Gemini (Étape 5). La connexion Google gratuite ne fonctionne plus dans le CLI.

8. Liens utiles


  • Connecteur Eulerian (GitHub) :  github.com/EulerianTechnologies/eulerian-marketing-platform-mcp 
  • Clés API Gemini :  aistudio.google.com/apikey 
  • Installer Python :  python.org/downloads 
  • Installer Node.js :  nodejs.org