Guide d'intégration d'Eulerian MCP avec Claude Desktop

Guide d'intégration d'Eulerian MCP avec Claude Desktop

EULERIAN MCP
  • Guide d'intégration avec Claude Desktop
  • Cible : Pour les utilisateurs sans connaissances techniques avancées
  • Extension en 1 clic ou installation manuelle · Claude Desktop

1. Qu'est-ce que le MCP Eulerian

Le MCP (Model Context Protocol) d'Eulerian est un connecteur qui permet à Claude d'accéder directement aux données de votre plateforme Eulerian Marketing Platform. Au lieu d'ouvrir des tableaux de bord, d'exporter des fichiers CSV ou d'écrire des requêtes SQL, vous posez simplement vos questions à Claude en langage naturel.
Une analogie simpleVoyez le MCP comme un « interprète » entre Claude et Eulerian. Claude parle en langage naturel, Eulerian parle en API ; le MCP traduit automatiquement entre les deux.

Ce que vous pouvez faire avec :

  • Consulter la performance des campagnes de search payant de la semaine dernière en une phrase,
  • Découvrir quels canaux média ont le plus contribué aux conversions ce mois-ci,
  • Analyser le parcours client de votre segment le plus convertisseur,
  • Obtenir des insights analytiques sans exporter les données manuellement.

2. Avant de commencer

Assurez-vous d'avoir ces quatre éléments avant de poursuivre l'installation :
Title
Title
1
Un compte Eulerian actif (type Webmaster)
Vous avez besoin d'un accès webmaster à votre instance Eulerian Marketing Platform. Si vous ne l'avez pas, contactez votre administrateur de plateforme.
Title
Title
2
Votre jeton API Eulerian (token API)
Une clé secrète fournie par Eulerian. Gardez-la en lieu sûr, vous en aurez besoin à l'Étape 3 (ou lors de la configuration de l'extension).
Title
Title
3
Python 3.10 ou supérieur
Téléchargez-le sur  python.org/downloads .
Lors de l'installation sous Windows, cochez « Add Python to PATH ». Nécessaire pour les DEUX méthodes : la méthode manuelle (Section 3) l'utilise directement, et l'extension .dxt (Section 4) s'exécute elle aussi avec le Python de votre système.
Title
Title
4
Claude Desktop installé
Téléchargez-le sur  claude.ai/download . Ce guide utilise Claude Desktop comme client principal.

3. Installation manuelle (terminal + fichier de configuration)

C'est la méthode classique, avec des commandes. Si vous préférez une installation sans commandes ni Python, allez directement à la Section 4 (extension en un clic) ; vous n'avez besoin que d'une des deux méthodes.

Étape 1 : Installer le paquet Eulerian

Ouvrez un terminal :
  • Windows : cherchez « cmd » ou « PowerShell »
  • Mac : cherchez « Terminal »
et exécutez cette commande : pip install eulerian-marketing-platform
Que fait cette commande ?Elle télécharge et installe le connecteur MCP d'Eulerian sur votre ordinateur. C'est comme installer une application, mais depuis le terminal. À la fin, vous verrez : Successfully installed eulerian-marketing-platform.

Étape 2 : Localiser le fichier de configuration de Claude Desktop

Claude Desktop possède un fichier de configuration où nous lui indiquons d'utiliser Eulerian. Selon votre système d'exploitation :
Système
Chemin du fichier
Windows
%APPDATA%\Claude\claude_desktop_config.json
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Linux
~/.config/Claude/claude_desktop_config.json
Raccourci depuis Claude DesktopOuvrez Claude Desktop > menu Claude > Settings > Developer > Edit Config. Le fichier s'ouvre directement.

Étape 3 : Ajouter la configuration Eulerian

Ouvrez claude_desktop_config.json avec n'importe quel éditeur de texte (Notepad, TextEdit, VS Code…) et remplacez son contenu par ce qui suit, en remplaçant les valeurs des PARAMÈTRES EN MAJUSCULES (endpoint et jeton) par les vôtres :

{
    "mcpServers": {
        "eulerian-marketing-platform": {
            "command": "python",
            "args": ["-m", "eulerian_marketing_platform.server"],
            "env": {
                "EMP_API_ENDPOINT": "https://VOTRE-INSTANCE.api.eulerian.com/mcp",
                "EMP_API_TOKEN": "VOTRE_JETON_SECRET_ICI"
            }
        }
    }
}

Important — remplacez les valeurs avant de coller le contenu :
A. Remplacez :
  • VOTRE-INSTANCE : par la donnée réelle de votre serveur Eulerian.
  • Exemple d'illustration, si mon serveur est démonstration, cela donne : https://demonstration.api.eulerian.com/mcp 
  • VOTRE_JETON_SECRET_ICI : par votre jeton API (token) qui est une longue chaîne de chiffres et de lettres.
  • Coller le contenu mis à jour
B. Enregistrez le fichier avec Ctrl+S (ou Cmd+S sur Mac).
Ne partagez jamais ce fichier avec qui que ce soit.

Étape 4 : Redémarrer Claude Desktop et vérifier la connexion

Fermez Claude Desktop (ne réduisez pas seulement la fenêtre, quitter complètement l'application) et rouvrez-le.
Signe de réussiteCherchez une icône de marteau en bas à droite du chat. En cliquant dessus, vous verrez les outils Eulerian disponibles. Sinon, demandez directement à Claude s'il est connecté au MCP Eulerian.
Pour confirmer que tout fonctionne, tapez dans Claude :
À quels outils d'Eulerian Marketing Platform as-tu accès ?
Claude devrait répondre en listant les outils disponibles sur votre plateforme.
Félicitation ! Vous avez finalisé l'intégration.

4. Alternative : installation en un clic avec l'extension (.dxt)

En plus de la méthode manuelle de la Section 3, Eulerian propose une extension en un clic pour Claude Desktop. C'est la voie la plus simple : sans terminal, sans commandes `pip` et sans éditer de fichiers JSON. Recommandée pour les utilisateurs non techniques.
Laquelle choisir ?L'extension .dxt est la façon la plus rapide et la plus simple. La méthode manuelle (Section 3) reste valable et utile si votre organisation restreint l'installation d'extensions ou si vous préférez maîtriser la configuration à la main. Les deux méthodes donnant le même résultat, n'utilisez qu'une seule des deux.
Vous avez besoin de la même chose qu'avant :
  • votre endpoint
  • votre jeton/token Eulerian (points 1 et 2 de la Section 2)
  • de Python 3.10 ou supérieur (l'extension l'utilise pour s'exécuter, voir la note ci-dessous).
Note : Et Python ?L'extension vous évite le terminal, la commande pip install et l'édition de JSON, mais elle nécessite que Python 3.10+ soit installé sur votre ordinateur : Claude Desktop embarque son propre runtime Node.js mais n'inclut pas Python, donc l'extension s'exécute avec le Python de votre système. Si vous ne l'avez pas, installez-le d'abord (point 3 de la Section 2 ; sous Windows, cochez « Add Python to PATH »). Le code du connecteur, lui, est inclus dans le .dxt : vous n'avez donc pas besoin de lancer pip install.

Étape 1 : Récupérer le fichier de l'extension

Téléchargez le fichier eulerian-marketing-platform-0.2.9.dxt (fourni par Eulerian, il est aussi disponible dans le dépôt GitHub indiqué dans les Ressources). Enregistrez-le à un endroit facile à retrouver, par exemple le dossier Téléchargements.
À propos de la versionLe nom du fichier inclut le numéro de version (ici 0.2.9). Si Eulerian publie une version plus récente, mettez à jour en installant le nouveau fichier .dxt de la même manière.

Étape 2 : Ouvrir Extensions dans Claude Desktop

Dans Claude Desktop, allez dans le menu Claude > Settings (Configuration) et ouvrez la section Extensions. Vous verrez la zone « Installé sur votre ordinateur » et, en dessous, une zone indiquant « Glissez des fichiers .MCPB ou .DXT ici pour installer ».

Étape 3 : Installer l'extension

Glissez le fichier eulerian-marketing-platform-0.2.9.dxt depuis son dossier jusqu'à cette zone d'installation (ou utilisez Configuration avancée pour le sélectionner). Une fois installée, elle apparaît dans la liste sous le nom « Eulerian Marketing Platform » avec l'étiquette PERSONNALISÉE et un bouton Configurer.

https://slite.com/api/files/tT4s-m3W1427wd/imported-image?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiZVl2cnk1YTNuMktpSHciLCJpYXQiOjE3ODc2MTY5OTUsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiUlhpTlZpTk9OY0FwUnoiLCJleHAiOjE3OTAyMDg5OTV9.gNMoHlwNr9bUicIM3CXLde161tWVeOP5u9Vb7PtXYQk


Étape 4 : Configurer l'endpoint et le jeton

Cliquez sur Configurer (ou cliquez sur l'extension) pour ouvrir ses réglages. Activez l'interrupteur « Activée » et renseignez les champs :
  • API Endpoint (obligatoire) : l'URL de votre serveur MCP Eulerian, par exemple  https://votre-instance.api.eulerian.com/mcp .
  • API Token (obligatoire) : votre jeton d'authentification Eulerian.
  • Request Timeout (seconds) : temps d'attente maximal des réponses. Laissez 300 ou augmentez-le pour les requêtes longues.
Cliquez sur Enregistrer.


Étape 5 : Vérifier la connexion

L'extension doit s'afficher comme « Activée ». Ouvrez un chat et cliquez sur l'icône marteau (en bas à droite) pour voir les outils Eulerian, ou demandez directement à Claude :
À quels outils d'Eulerian Marketing Platform as-tu accès ?
Si Claude liste les outils disponibles, l'intégration est terminée.
Installation finaliséeFélicitation ! Vous avez connecté Eulerian à Claude sans terminal, sans commandes et sans éditer de JSON. Le résultat est le même qu'avec la méthode manuelle de la Section 3.
Mettre à jour ou retirer l'extensionPour changer l'endpoint ou le jeton, revenez dans Settings > Extensions > eulerian-marketing-platform et cliquez sur Configurer. Pour la supprimer, utilisez Désinstaller. Le jeton est affiché masqué ; traitez-le comme un mot de passe.

5. Comment l'utiliser — Exemples de questions

Une fois connecté (par l'une ou l'autre méthode), vous pouvez poser vos questions à Claude en langage naturel. Quelques exemples :
  • Comment nos campagnes de search payant ont-elles performé la semaine dernière ?
  • Quels canaux média ont le plus contribué aux conversions ce mois-ci ?
  • Montre-moi le parcours client de notre segment le plus convertisseur.
  • Combien de sessions uniques avons-nous eues sur les 7 derniers jours par rapport au mois précédent ?
  • Quels outils Eulerian as-tu à disposition ?
Conseil pour de meilleurs résultatsSoyez précis dans vos questions. Au lieu de « comment vont les campagnes ? », essayez « quel est le CPA de nos campagnes display le mois dernier ? ». Plus c'est concret, plus la réponse de Claude sera précise.

6. Sécurité et bonnes pratiques

Validez avec votre service informatique

Avant d'utiliser de vraies données métier, confirmez avec l'IT quelles plateformes d'IA sont approuvées par votre organisation. Privilégiez des services entreprise comme Claude Teams/Enterprise.

Vérifiez les chiffres importants

Les IA peuvent se tromper en formulant des requêtes. Recoupez les insights critiques directement avec l'interface Eulerian. Dans Claude, vous pouvez cliquer sur n'importe quel chiffre pour voir quelles propriétés et métriques ont réellement été interrogées.

Protégez votre jeton API

Votre jeton est comme un mot de passe. Ne le partagez pas, ne le publiez pas sur des dépôts comme GitHub, et ne l'incluez pas dans des e-mails.

Prudence avec plusieurs MCP

Évitez d'utiliser plusieurs MCP en même temps sauf si vous leur faites tous confiance. Un MCP non sûr peut exposer les données des autres connecteurs actifs.

7. Problème fréquent : le fichier de configuration n'existe pas

C'est un problème courant sur les nouvelles installations de Claude Desktop (méthode manuelle)En allant dans Settings > Developer > Edit Config, Claude Desktop peut afficher une erreur indiquant que le chemin n'existe pas. Cela arrive parce que le dossier et le fichier ne sont pas créés automatiquement tant qu'on ne les ouvre pas pour la première fois depuis ce menu, ou simplement parce que votre installation ne les a pas générés. (Si vous utilisez l'extension .dxt de la Section 4, ce problème ne s'applique pas.)

Comment le résoudre : créer le dossier et le fichier manuellement

Suivez ces étapes selon votre système d'exploitation :

Sous Windows

  • Ouvrez l'Explorateur de fichiers et, dans la barre d'adresse, tapez exactement : %APPDATA%\Claude
  • Si le dossier Claude n'existe pas, créez-le : clic droit > Nouveau dossier > nommez-le exactement Claude.
  • Dans ce dossier, créez un nouveau fichier texte : clic droit > Nouveau > Document texte.
  • Renommez le fichier en claude_desktop_config.json (supprimez l'extension .txt si elle apparaît).
  • Ouvrez ce fichier avec le Bloc-notes et collez-y exactement le contenu de l'Étape 3 de la Section 3.
  • Enregistrez avec Ctrl+S et redémarrez Claude Desktop.
Astuce pour afficher les extensions sous WindowsSi vous ne voyez pas l'extension .txt en renommant le fichier, allez dans l'Explorateur de fichiers > menu Affichage > cochez « Extensions de noms de fichiers ». Vous pourrez alors le renommer correctement en .json.

Sous macOS

Ouvrez le Terminal (cherchez « Terminal » dans Spotlight avec Cmd+Espace) et exécutez ces deux commandes, une par une, pour créer le dossier et le fichier vide :
mkdir -p ~/Library/Application\ Support/Claudetouch ~/Library/Application\ Support/Claude/claude_desktop_config.json
Ouvrez le fichier avec n'importe quel éditeur de texte (TextEdit, VS Code…), ajoutez le contenu de l'Étape 3, enregistrez et redémarrez Claude Desktop.

Sous Linux

Ouvrez un terminal et exécutez :
mkdir -p ~/.config/Claudetouch ~/.config/Claude/claude_desktop_config.json
Éditez le fichier avec nano ou tout autre éditeur : nano ~/.config/Claude/claude_desktop_config.json. Collez le contenu de l'Étape 3, enregistrez avec Ctrl+O, confirmez avec Entrée et quittez avec Ctrl+X. Redémarrez Claude Desktop.

Vérification finale :

Une fois le fichier créé et Claude Desktop redémarré, retournez dans Settings > Developer > Edit Config. Cette fois, il devrait s'ouvrir sans erreur et vous montrer le contenu JSON que vous avez ajouté.

8. FAQ : Autres problèmes fréquents

Problème
Solution
Le serveur n'apparaît pas dans Claude Desktop
Fermez Claude Desktop complètement (vérifiez qu'il ne reste pas dans la barre système) et rouvrez-le. Vérifiez que le fichier JSON n'a pas d'erreurs de format, ou que l'extension .dxt est « Activée ».
Erreur : EMP_API_ENDPOINT variable required
L'URL du serveur n'est pas configurée correctement. Remplacez le texte d'exemple par votre URL Eulerian réelle (ou renseignez-la dans la configuration de l'extension).
Erreur : EMP_API_TOKEN variable required
Votre jeton API n'est pas configuré. Remplacez VOTRE_JETON_SECRET_ICI par le jeton réel fourni par Eulerian (ou saisissez-le dans l'extension).
« python » n'est pas reconnu comme commande
Concerne les DEUX méthodes : l'extension .dxt et la méthode manuelle s'exécutent avec le Python de votre système. Installez Python 3.10+ et, sous Windows, cochez « Add Python to PATH » ; fermez puis rouvrez le terminal et vérifiez que « python » fonctionne. Essayez aussi python3. Si Python n'est pas installé, l'extension ne démarrera pas non plus.
Les données ne semblent pas correctes
Cliquez sur le chiffre dans Claude pour voir quelles métriques ont été interrogées. Reformulez votre question en étant plus précis sur la période ou la métrique souhaitée.

9. Ressources supplémentaires

  • Dépôt GitHub :  github.com/EulerianTechnologies/eulerian-marketing-platform-mcp 
  • Paquet PyPI :  pypi.org/project/eulerian-marketing-platform/ 
  • Documentation officielle :  https://doc.eulerian.com/p/nv67dzqAxVGQxg/Serveur-MCP 
  • Télécharger Python :  python.org/downloads 
  • Télécharger Claude Desktop :  claude.ai/download 
Guide simplifié basé sur la documentation officielle d'Eulerian Technologies.