Guide général d'intégration d'Eulerian MCP via OAuth
EULERIAN MCP
- Guide d'intégration — Autres clients (OAuth)
- Pour les utilisateurs sans connaissances techniques avancées
- Connecteur distant avec OAuth 2.1 · valable pour tout client compatible MCP
1. Ce qu'est ce guide
Presque tous les assistants IA compatibles MCP se connectent à Eulerian de la même manière : vous ajoutez un connecteur distant avec l'URL du serveur MCP d'Eulerian et vous vous identifiez via OAuth 2.1. La seule chose qui change d'un client à l'autre est l'endroit où l'on ajoute ce connecteur. Ce guide général décrit le processus commun ; si vous utilisez Claude, ChatGPT, Gemini ou Mistral, vous disposez aussi d'un guide illustré dédié.
Le schéma commun à tous les clients : un connecteur distant + une connexion OAuth chez Eulerian.
Le principe, en une phrasePoint de terminaison distant + connexion OAuth : rien à installer, pas de terminal, aucun jeton à coller, et le client ne voit jamais votre mot de passe. Eulerian n'accorde qu'un accès limité et révocable.
2. Prérequis : ce que votre client doit prendre en charge
Pour se connecter avec cette méthode, le client IA doit réunir ces caractéristiques :
- Prend en charge les serveurs MCP distants (connecteurs personnalisés), pas seulement locaux.
- Prend en charge OAuth 2.1 comme méthode d'authentification ; idéalement avec le dynamic client registration, pour ne pas avoir à créer un Client ID/Secret à la main.
- Permet d'indiquer une URL de serveur (point de terminaison distant) accessible en HTTPS avec un certificat TLS valide.
- La connexion part des serveurs du fournisseur d'IA ; le point de terminaison doit donc être accessible depuis internet (pas derrière un pare-feu ou un VPN).
- Utilise le transport standard de MCP (Streamable HTTP).
Le serveur MCP d'EulerianLe connecteur s'appuie sur le serveur MCP d'Eulerian, développé par Eulerian. Il expose les outils de la plateforme et délègue l'authentification à OAuth 2.1, de sorte que chaque utilisateur n'accède qu'aux données que son compte Eulerian l'autorise à voir.
3. Agents compatibles
À titre d'exemple, ces clients remplissent aujourd'hui les prérequis ci-dessus. La partie Eulerian (endpoint + OAuth) est identique ; seul l'endroit où l'on ajoute le connecteur change :
Claude (web et bureau)
Oui
Oui
Paramètres → Connectors (ou extension .dxt en un clic sur bureau)
ChatGPT
Oui
Oui
Paramètres → Applications → Paramètres avancés → Mode développeur
Google Gemini
Oui
Oui
Console/administration Gemini, selon l'édition (à vérifier)
Mistral (Vibe)
Oui
Oui
Mistral Studio → Connecteurs ; activer par conversation
Autres clients MCP
Selon le client
Selon le client
Interface du client ou fichier de configuration
La disponibilité et les noms de menus peuvent évoluer et dépendent de votre offre ou de votre organisation. Si un client n'apparaît pas ici, vérifiez dans sa documentation qu'il remplit les prérequis de la Section 2.
4. Avant de commencer
Vous avez besoin de ces éléments avant de continuer :
1
Un client IA compatible
Un assistant qui remplit les prérequis de la Section 2 (MCP distant + OAuth 2.1).
2
L'URL du point de terminaison MCP d'Eulerian
C'est votre point de terminaison d'API Eulerian avec /mcp ajouté à la fin. Vous le trouvez dans l'interface d'Eulerian, dans votre compte, sous la rubrique « Eulerian API » (voir l'encadré ci-dessous).
3
Vos identifiants Eulerian
Votre identifiant et votre mot de passe Eulerian. Vous vous connecterez pendant l'étape OAuth. Aucun jeton d'API à coller.
4
Droits d'organisation (le cas échéant)
Sur certains clients avec des comptes équipe/entreprise, un administrateur doit activer les connecteurs personnalisés ou ajouter le connecteur au niveau de l'organisation.
https://<votre-endpoint-d-API-Eulerian>/mcp
Comment obtenir votre endpointDans l'interface d'Eulerian, dans votre compte, allez à la rubrique « Eulerian API » : votre point de terminaison d'API y figure. L'URL du serveur MCP est ce même endpoint avec /mcp ajouté à la fin.
5. Le processus étape par étape (OAuth)
Les étapes sont les mêmes sur tous les clients ; seul l'endroit où trouver la rubrique des connecteurs (étape 1) change.
Étape 1 Repérez où s'ajoutent les connecteurs
Dans votre client IA, cherchez la rubrique connecteurs (elle peut s'appeler Connectors, Connecteurs ou Applications). Certains clients demandent d'activer au préalable un mode développeur ou des droits d'administrateur.
Étape 2 Ajoutez un connecteur distant avec l'URL du endpoint
Choisissez d'ajouter un connecteur personnalisé / serveur MCP distant et collez l'URL du endpoint d'Eulerian avec /mcp à la fin (voir Section 4).
Étape 3 Choisissez OAuth comme authentification
Sélectionnez OAuth 2.1 comme méthode d'authentification. Sur de nombreux clients, elle est détectée automatiquement à partir de l'URL ; laissez le Client ID/Secret vide sauf indication contraire d'Eulerian.
Étape 4 Connectez-vous à Eulerian
Le client vous redirige vers l'écran de connexion d'Eulerian. Saisissez votre identifiant et votre mot de passe Eulerian. Ici, aucun jeton à coller : le client ne voit jamais votre mot de passe.
Étape 5 Autorisez l'accès (Approve)
Eulerian affiche les permissions demandées (par exemple eulerian:reports.read). Vérifiez-les et cliquez sur « Approve » pour autoriser (ou « Deny » pour annuler).
Exemple de l'écran d'autorisation d'Eulerian ; le nom du client et les permissions peuvent varier.
N'accordez que le nécessaireVérifiez toujours les permissions avant d'approuver. Pour la lecture seule des rapports, eulerian:reports.read suffit ; n'accordez des permissions d'écriture que si votre cas d'usage l'exige.
Étape 6 Activez-le et utilisez-le
Le connecteur est connecté. Certains clients exigent aussi de l'activer dans chaque conversation (dans le menu des outils). Ensuite, posez votre question en langage naturel, par exemple :
À quels outils Eulerian as-tu accès ?
Connexion terminéeRien à installer et aucun jeton collé. Vous pouvez révoquer l'accès à tout moment depuis votre client ou depuis votre compte Eulerian.
6. Où le configurer sur chaque client
La partie Eulerian est toujours la même ; ceci n'est qu'une carte de l'endroit où chaque plateforme ajoute le connecteur. Pour le détail illustré, consultez le guide spécifique de chaque client :
- Claude (web) : Paramètres → Connectors → « Add custom connector ».
- Claude (bureau) : méthode manuelle ou extension .dxt en un clic.
- ChatGPT : Paramètres → Applications → Paramètres avancés → Mode développeur → « Créer une application ».
- Google Gemini : dans la console/administration Gemini, selon l'édition (à vérifier).
- Mistral (Vibe) : créez-le dans Mistral Studio → Connecteurs ; puis activez-le dans chaque conversation.
- Clients CLI/IDE (Codex, VS Code + Copilot, Mistral Vibe CLI, Gemini CLI) : se configurent via un fichier de configuration ; consultez le guide de chacun.
7. Sécurité et bonnes pratiques
OAuth plutôt que des jetons
Aucun jeton n'est stocké sur votre poste ni dans le navigateur. Vous vous authentifiez avec votre compte Eulerian et Eulerian accorde au client un accès limité et révocable à tout moment.
Permissions explicites et minimales
Vérifiez les permissions sur l'écran d'autorisation d'Eulerian avant de cliquer sur « Approve » et n'accordez que le nécessaire. Évitez les permissions d'écriture si vous ne les utilisez pas.
Uniquement des connecteurs de confiance
N'ajoutez que des serveurs MCP de développeurs de confiance. Vérifiez toujours l'origine de l'URL : ici, le développeur est Eulerian.
Point de terminaison accessible et sécurisé
Le point de terminaison doit répondre en HTTPS avec un certificat TLS valide et être accessible depuis internet, car la connexion part des serveurs du fournisseur d'IA.
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 pour le traitement des données de l'entreprise.
8. Si quelque chose ne fonctionne pas
Je ne trouve pas où ajouter un connecteur
Cherchez « Connectors », « Connecteurs » ou « Applications » dans les paramètres du client. Certains exigent d'activer un mode développeur ou des droits d'administrateur (voir Sections 3 et 6).
La connexion ne s'établit pas ou est signalée invalide
Vérifiez l'URL : elle doit être votre endpoint d'API Eulerian avec /mcp à la fin, en HTTPS et avec un certificat TLS valide.
La connexion n'atteint pas le serveur
Le point de terminaison doit être accessible depuis internet : la connexion part des serveurs du fournisseur d'IA, pas de votre poste. S'il est derrière un pare-feu ou un VPN, il ne se connectera pas.
Eulerian refuse la connexion
Utilisez vos identifiants Eulerian (pas ceux du client IA). Si vous avez accès à plusieurs grids, utilisez l'endpoint avec le bon paramètre.
« Permission refusée » après autorisation
Sur l'écran d'autorisation d'Eulerian, vous devez cliquer sur « Approve » (pas « Deny »). Si vous avez cliqué sur « Deny », recommencez le flux de connexion.
L'assistant dit qu'il n'a pas accès au MCP
Certains clients exigent d'activer le connecteur dans chaque conversation (menu des outils). Activez-le et reposez votre question.
9. Ressources complémentaires
- Votre endpoint d'API : dans l'interface d'Eulerian, rubrique « Eulerian API » (ajoutez /mcp à la fin).
- OAuth 2.1 d'Eulerian (intégrations tierces) : doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Documentation du serveur MCP d'Eulerian : doc.eulerian.com/p/nv67dzqAxVGQxg/Serveur-MCP
- Dépôt GitHub : github.com/EulerianTechnologies/eulerian-marketing-platform-mcp
- Guides spécifiques par client : Claude (web et bureau), ChatGPT, Gemini et Mistral.