Guide d'intégration d'Eulerian MCP avec Antigravity IDE
EULERIAN MCP
- Guide d'intégration avec Antigravity IDE
- Pour les utilisateurs sans connaissances techniques avancées
- Connecteur distant avec OAuth 2.1 · Éditeur de code · mcp_config.json
1. Ce que c'est et en quoi cela diffère des autres versions
Ce guide connecte Antigravity IDE au serveur MCP distant d'Eulerian. Antigravity IDE est l'éditeur de code de Google (basé sur VS Code) doté d'un agent intégré ; il prend en charge les serveurs MCP distants avec authentification OAuth 2.1. Vous n'installez aucun serveur local et ne collez aucun jeton d'API : le connecteur s'ajoute dans le fichier mcp_config.json et vous vous identifiez avec votre propre compte Eulerian. Par rapport à Antigravity 2.0, ici le connecteur se gère depuis le panneau de l'agent de l'éditeur (le menu MCP Servers) et, comme dans la 2.0, la connexion OAuth comporte une étape de copier-coller d'un code.
Le principe, en une phraseUn point de terminaison distant + une connexion OAuth : vous n'installez aucun serveur local, ne stockez aucun jeton d'API, et l'IDE ne voit jamais votre mot de passe. Eulerian n'accorde qu'un accès limité et révocable.
Ce que vous pouvez faire avec :
- Consulter les performances des campagnes paid search de la semaine dernière en une phrase.
- Découvrir quels canaux média ont apporté le plus de conversions ce mois-ci.
- Analyser le parcours client de votre segment le plus convertisseur.
- Obtenir des insights analytiques sans quitter l'éditeur ni exporter les données manuellement.
2. Avant de commencer
Vous avez besoin de ces quatre éléments avant de continuer :
1
Antigravity IDE
Téléchargez et installez Antigravity IDE pour votre système (Windows, macOS ou Linux) depuis antigravity.google/download (section « Antigravity IDE »).
2
Un compte Google
Antigravity démarre avec votre compte Google : vous en avez donc besoin pour utiliser l'éditeur.
3
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 ».
4
Vos identifiants Eulerian
Votre identifiant et votre mot de passe Eulerian. Vous vous connecterez pendant l'étape OAuth. Aucun jeton d'API à coller.
Prérequis du point de terminaisonLe point de terminaison doit être accessible depuis internet et en HTTPS avec un certificat TLS valide : dans l'IDE, la connexion part de votre poste. Si vous avez accès à plusieurs grids, utilisez le point de terminaison de celle concernée.
3. Installation étape par étape
Étape 1 Téléchargez et installez Antigravity IDE
Rendez-vous sur antigravity.google/download , descendez jusqu'à la section Antigravity IDE et téléchargez la version pour votre système (Windows, macOS ou Linux). Installez-le comme n'importe quelle application de bureau.
La section « Antigravity IDE » de la page de téléchargement officielle, avec des versions pour macOS, Windows et Linux.
Étape 2 Ouvrez-le
Ouvrez Antigravity IDE. Vous verrez l'éditeur avec son panneau de l'agent à droite (« Ask anything… »). C'est de là que nous gérerons le connecteur.
La fenêtre principale d'Antigravity IDE, avec l'éditeur et le panneau de l'agent à droite.
Étape 3 Repérez votre point de terminaison MCP dans Eulerian
Dans l'interface d'Eulerian, dans votre compte, ouvrez la rubrique Eulerian API. Votre API Endpoint y figure. L'URL du serveur MCP est ce même point de terminaison avec /mcp ajouté à la fin :
La rubrique « Eulerian API » : votre API Endpoint (valeurs de démonstration). Vous n'avez pas besoin de l'API token pour cette méthode.
https://<votre-endpoint-d-API-Eulerian>/mcp
Vous n'avez pas besoin de l'API tokenContrairement à d'autres méthodes, ici vous ne copiez pas l'API token. Vous avez seulement besoin de l'URL du point de terminaison avec /mcp ; vous vous identifierez avec votre identifiant et votre mot de passe pendant l'étape OAuth.
Étape 4 Ouvrez « MCP Servers » depuis le panneau de l'agent
Dans le panneau de l'agent (à droite), cliquez sur le bouton trois points « … » (Additional options) en haut. Les options de personnalisation apparaissent ; choisissez MCP Servers.
Dans le panneau de l'agent, cliquez sur les trois points « … » (Additional options) et choisissez « MCP Servers ».
Étape 5 Cliquez sur « Manage MCP Servers »
Par défaut, le MCP Store s'ouvre (un catalogue de connecteurs). Comme Eulerian n'est pas dans le catalogue, cliquez en haut à droite sur « Manage MCP Servers » pour l'ajouter manuellement.
Le MCP Store s'ouvre par défaut ; cliquez sur « Manage MCP Servers » (en haut à droite).
Étape 6 Ouvrez « View raw config » et ajoutez le serveur
Dans Manage MCP servers, cliquez en haut à droite sur « View raw config » pour ouvrir le fichier mcp_config.json. Ajoutez le serveur d'Eulerian avec votre point de terminaison et /mcp à la fin, puis enregistrez le fichier :
Dans « Manage MCP servers », cliquez sur « View raw config » (en haut à droite) pour éditer le fichier.
{"mcpServers": {"eulerian": {"serverUrl": "https://<votre-endpoint-d-API-Eulerian>/mcp"}}}
mcp_config.json avec le serveur « eulerian » et son serverUrl se terminant par /mcp (endpoint de démonstration).
Étape 7 Forcez le Refresh et « Authenticate » apparaît
Après l'enregistrement, le bouton Refresh peut continuer à tourner (les deux flèches en cercle ne s'arrêtent pas). Forcez-le en cliquant dessus. À côté d'Eulerian, vous verrez « Error: calling initialize... Unauthorized » et le bouton Authenticate.
Après avoir forcé « Refresh », l'avertissement « Unauthorized » apparaît à côté du bouton « Authenticate ».
Le « Unauthorized » ici est normalC'est l'état avant identification : vous n'avez pas encore effectué la connexion OAuth. Il disparaît dès que vous terminez l'authentification aux étapes suivantes.
Étape 8 Cliquez sur « Authenticate » (deux fois)
Cliquez sur Authenticate. Vous êtes redirigé vers Settings → Customizations, où vous reverrez le connecteur Eulerian avec son bouton Authenticate : cliquez à nouveau dessus pour lancer la connexion OAuth dans le navigateur.
Le bouton « Authenticate » vous mène à Settings → Customizations ; cliquez de nouveau sur « Authenticate » là.
Étape 9 Connectez-vous à Eulerian
L'écran de connexion d'Eulerian s'ouvre dans votre navigateur. Saisissez votre identifiant (Identifiant) et poursuivez avec votre mot de passe Eulerian. L'IDE ne voit jamais votre mot de passe.
L'écran de connexion d'Eulerian.
Étape 10 Autorisez l'accès (Approve)
Eulerian affiche les permissions demandées par antigravity-client (par exemple eulerian:reports.read). Vérifiez-les et cliquez sur « Approve » pour autoriser (ou « Deny » pour annuler).
L'écran d'autorisation d'Eulerian : vérifiez les permissions et cliquez sur « Approve ».
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 11 Copiez le code et collez-le dans l'IDE
Le navigateur affiche un code à usage unique. Cliquez sur Copy to Clipboard, revenez dans l'IDE et collez le code dans le champ « Paste auth code » (c'est la même boîte que dans Antigravity 2.0, avec le thème sombre de l'éditeur) ; cliquez ensuite sur Submit.
Antigravity affiche un code à usage unique : copiez-le avec « Copy to Clipboard » (code masqué) et collez-le dans l'IDE.
Étape 12 Connecteur connecté
Le connecteur Eulerian passe au vert avec un bouton Sign out et affiche le nombre d'outils activés (par exemple « 133 tools enabled »). Il est désormais connecté.
Le connecteur « Eulerian » connecté (point vert, « Sign out ») avec ses outils activés.
Connexion terminéeAucun serveur local installé et aucun jeton d'API stocké. Vous pouvez révoquer l'accès à tout moment avec « Sign out » ou depuis votre compte Eulerian.
Étape 13 Choisissez les outils à activer (facultatif)
Depuis Manage MCP servers → Configure, l'IDE vous permet d'activer ou de désactiver chacun des 134 outils d'Eulerian via son interrupteur. Utile pour limiter le connecteur à ce dont vous avez besoin (par exemple, garder les outils de reporting actifs et désactiver le reste).
Dans « Configure », vous pouvez activer/désactiver chacun des 134 outils d'Eulerian individuellement.
Étape 14 Utilisez-le
Dans le panneau de l'agent, posez votre question en langage naturel. L'IDE appellera les outils d'Eulerian selon votre demande, par exemple :
À quels outils Eulerian as-tu accès, et quels sites y a-t-il dans mon compte ?
L'agent de l'IDE répond en utilisant le MCP d'Eulerian, en listant les outils et les sites disponibles.
4. Équipes et organisations
Antigravity enregistre la configuration MCP dans le fichier mcp_config.json de votre poste, et l'authentification est individuelle : chaque utilisateur se connecte avec son propre compte Eulerian.
- Le connecteur est défini dans votre mcp_config.json (global dans ~/.gemini/config/mcp_config.json ou par projet dans .agents/mcp_config.json).
- Chaque utilisateur se connecte avec son propre compte Eulerian et n'accède donc qu'aux données que son compte peut voir.
- En environnement d'entreprise, confirmez auprès de votre département informatique quels outils d'IA sont approuvés pour traiter des données métier.
L'accès accordé est limité et révocable : vous pouvez le déconnecter avec « Sign out » dans l'IDE ou le révoquer depuis votre compte Eulerian à tout moment.
5. Autres clients et remarques
Antigravity 2.0, l'IDE et la CLI partagent le même fichier de configuration MCP (~/.gemini/config/mcp_config.json). Si vous avez déjà ajouté le serveur d'Eulerian sur une surface, les autres le détectent. Et comme l'authentification est OAuth 2.1 déléguée au client, le même point de terminaison distant fonctionne aussi avec Claude, ChatGPT ou Mistral : la partie Eulerian est toujours la même ; seul l'endroit où l'on ajoute le connecteur change.
IDE vs Antigravity 2.0 et CLICe guide couvre l'éditeur de code (Antigravity IDE). Antigravity 2.0 est l'app d'agent sans éditeur, et la CLI (agy) se pilote depuis le terminal avec la commande /mcp ; chacune a son propre guide, mais la partie Eulerian (point de terminaison + OAuth) est identique.
- OAuth 2.1 d'Eulerian (intégrations tierces) : doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Guides spécifiques : Antigravity 2.0, Antigravity CLI, Claude, ChatGPT, Mistral et « Autres clients ».
6. Sécurité et bonnes pratiques
OAuth plutôt que des jetons
Aucun jeton d'API n'est stocké sur votre poste. Vous vous authentifiez avec votre compte Eulerian et Eulerian accorde à l'IDE un accès limité (par exemple, lecture seule des rapports) et révocable à tout moment.
Le code d'autorisation est à usage unique
Le code que vous copiez et collez pendant la connexion est temporaire et à usage unique : il ne sert qu'à terminer l'authentification et expire rapidement. Ce n'est pas un jeton à stocker ni à partager.
N'activez que les outils que vous utilisez
Dans « Manage MCP servers → Configure », vous pouvez désactiver les outils dont vous n'avez pas besoin. Réduire la surface active est une bonne pratique de moindre privilège.
Des permissions explicites et minimales
Vérifiez les permissions sur l'écran d'autorisation d'Eulerian (par exemple eulerian:reports.read) avant de cliquer sur « Approve ». Évitez les permissions d'écriture si vous ne les utilisez pas.
Validez avec votre département informatique
Avant d'utiliser des données métier réelles, confirmez auprès de l'informatique quelles plateformes d'IA sont approuvées pour traiter les données de l'entreprise.
7. Si quelque chose ne fonctionne pas
Je ne trouve pas où ajouter le connecteur
Dans le panneau de l'agent, cliquez sur les trois points « … » (Additional options) → « MCP Servers » → « Manage MCP Servers » → « View raw config ».
Le bouton « Refresh » continue de tourner
C'est fréquent après l'édition du fichier : cliquez sur « Refresh » pour le forcer. Le statut du connecteur apparaîtra (et le bouton « Authenticate » si vous n'êtes pas encore identifié).
Je vois « Unauthorized » et le bouton « Authenticate »
C'est normal avant de se connecter. Cliquez sur « Authenticate », puis de nouveau sur « Authenticate » dans Settings → Customizations, et terminez la connexion. Si le « Unauthorized » persiste après authentification, contactez Eulerian.
La connexion ne s'établit pas ou est signalée comme invalide
Vérifiez l'URL : elle doit être votre point de terminaison d'API Eulerian avec /mcp à la fin, en HTTPS et avec un certificat TLS valide.
Eulerian refuse la connexion
Utilisez vos identifiants Eulerian (pas ceux de Google). Si vous avez accès à plusieurs grids, utilisez le point de terminaison de la bonne.
J'ai collé le code mais la connexion échoue toujours
Copiez le code complet avec « Copy to Clipboard » et collez-le dans « Paste auth code » avant qu'il n'expire ; s'il expire, recommencez depuis « Authenticate ».
L'agent dit qu'il n'a pas accès au MCP
Vérifiez que le connecteur est vert (« Sign out ») et que les outils dont vous avez besoin sont activés dans « Configure ». Ouvrez une nouvelle conversation et redemandez.
8. Ressources complémentaires
- Votre point de terminaison d'API : dans l'interface d'Eulerian, rubrique « Eulerian API » (ajoutez /mcp).
- Documentation du Serveur MCP d'Eulerian : doc.eulerian.com/p/nv67dzqAxVGQxg/Serveur-MCP
- MCP dans Antigravity (doc officielle) : antigravity.google/docs/mcp
- OAuth 2.1 d'Eulerian (intégrations tierces) : doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Téléchargement d'Antigravity : antigravity.google/download
- Dépôt GitHub : github.com/EulerianTechnologies/eulerian-marketing-platform-mcp