Guide d'intégration d'Eulerian MCP avec Visual Studio Code et GitHub Copilot
EULERIAN MCP
- Guide d'installation — pour débutants
- Connecter Eulerian à VS Code + GitHub Copilot
- Un pas-à-pas sans jargon — en partant d'un ordinateur sur lequel rien n'est installé
Ce guide vous montre, clic par clic, comment connecter le MCP Eulerian Marketing Platform à GitHub Copilot dans VS Code. VS Code est une application gratuite de Microsoft ; Copilot est son assistant IA. On part de zéro — installation de VS Code, création d'un compte gratuit — et on finit avec Copilot répondant à des questions sur vos vraies données Eulerian.
Ce dont vous aurez besoin :
Un ordinateur sur lequel installer des logiciels
Votre URL d'endpoint et votre jeton API Eulerian (via votre contact Eulerian)
Une adresse e-mail pour créer un compte GitHub gratuit.
Aucune expérience préalable requise.
Étape 1 Installer VS Code
Rendez-vous sur https://code.visualstudio.com , cliquez sur le gros bouton de téléchargement pour votre système, lancez l'installateur et acceptez les valeurs par défaut. Ouvrez VS Code à la fin — vous verrez un écran d'accueil comme celui-ci :
L'écran d'accueil de VS Code, qui invite à se connecter et à démarrer.
Étape 2 Ajouter GitHub Copilot et créer un compte gratuit
Cliquez sur l'icône Extensions dans la barre de gauche (quatre petits carrés), cherchez GitHub Copilot et cliquez sur Installer. Copilot vous demande alors de vous connecter. Si vous n'avez pas de compte GitHub, choisissez S'inscrire — sur la page d'inscription, laissez cochée la case « Sign up for Copilot Free » pour obtenir Copilot gratuitement :
Création d'un compte GitHub gratuit avec « Copilot Free » activé (données personnelles masquées).
Étape 3 Vous y êtes
Une fois connecté, VS Code s'ouvre avec le panneau Copilot Chat à droite. C'est là que vous parlerez à l'assistant.
VS Code connecté, avec le panneau Copilot Chat ouvert à droite.
Étape 4 Installer Python et le pont Eulerian
Copilot atteint Eulerian via un petit « pont » qui s'exécute sur votre machine. Installez Python 3.10+ depuis https://www.python.org/downloads/ (cochez « Add Python to PATH » sous Windows), puis ouvrez un terminal (Windows : Démarrer → tapez cmd → Entrée) et lancez :
pip install eulerian-marketing-platform
Étape 5 Indiquer Eulerian à VS Code
Ouvrez la palette de commandes avec Ctrl+Maj+P (macOS : Cmd+Maj+P), tapez MCP: Open User Configuration et Entrée. Un fichier mcp.json s'ouvre. Collez ceci, puis remplacez l'endpoint et le jeton par les vôtres :
{"servers": {"eulerian-marketing-platform": {"type": "stdio","command": "C:/Users/vous/AppData/Local/Programs/Python/Python312/python.exe","args": ["-m", "eulerian_marketing_platform.server"],"env": {"EMP_API_ENDPOINT": " https://votre-instance-eulerian.com/mcp ","EMP_API_TOKEN": "collez-ici-votre-jeton-eulerian"}}}}
Le point qui piège tout le monde : VS Code utilise la clé "servers" — pas "mcpServers" comme la plupart des autres apps. Pour le chemin command sous Windows, vous pouvez utiliser des barres obliques / (comme ci-dessus) ou des antislashs échappés \\ ; les deux fonctionnent. Trouvez votre Python avec python -c "import sys; print(sys.executable)".
Un petit bouton Démarrer apparaît juste au-dessus de la ligne "eulerian-marketing-platform" — cliquez dessus. Après quelques secondes, VS Code affiche le serveur en cours d'exécution avec ses outils :
mcp.json avec le serveur « Running · 134 tools » (le jeton est masqué ici par confidentialité).
Étape 6 Passer Copilot en mode Agent
Les outils MCP ne fonctionnent qu'en mode Agent. En bas de la zone Copilot Chat, ouvrez le menu déroulant de mode et choisissez Agent. Vous pouvez vérifier les outils actifs via le bouton outils (
) — les outils Eulerian apparaissent dans la liste :
) — les outils Eulerian apparaissent dans la liste :
Le sélecteur d'outils en mode Agent, montrant les outils MCP Eulerian disponibles pour Copilot.
Pratique : pour forcer Copilot à utiliser un outil Eulerian précis, tapez # suivi du nom de l'outil dans votre message (par exemple #getallowedwebsite_account).
Étape 7 Essayez — demandez vos données
Dans le chat (mode Agent), posez une question en langage naturel, par exemple une évolution hebdomadaire des visites. Copilot appelle les outils Eulerian et renvoie de vrais chiffres :
Copilot renvoyant une évolution des visites jour par jour depuis Eulerian (nom du client masqué).
Voilà toute l'installation. Vous pouvez désormais poser des questions métier en langage naturel et Copilot ira chercher les réponses dans Eulerian.
Bon à savoir (et ce que nous avons vérifié)
Si un rapport revient d'abord « invalide » : lors d'une première tentative de reporting, Copilot peut afficher reports definition is invalid — cela arrive quand la question n'a pas de dimension temporelle. L'agent corrige normalement de lui-même (il ajoute une dimension quotidienne date_day et réessaie), puis renvoie les données. Ce n'est pas un problème de connexion ni de protocole.
Note de validation (pour mémoire) : VS Code + GitHub Copilot a été testé de bout en bout et a fonctionné d'origine — connexion, 134 outils découverts et reporting réussis.
Si quelque chose ne fonctionne pas
Pas de commande MCP: Open User Configuration
Mettez VS Code à jour (nécessite 1.101+) et vérifiez que l'extension GitHub Copilot est installée.
Le serveur ne démarre pas / affiche 0 outil
Vérifiez que la clé est "servers" et que command pointe vers votre vrai chemin Python (Étape 5).
Copilot ignore les outils Eulerian
Vous n'êtes pas en mode Agent. Changez de mode en bas de la zone de chat, ou forcez un outil avec #nom_outil.
Un rapport revient « invalide »
Généralement auto-corrigé (voir ci-dessus). Sinon, demandez une ventilation « quotidienne » pour ajouter une dimension temporelle.