Guide d'intégration d'Eulerian MCP avec Antigravity CLI
EULERIAN MCP
- Guide d'intégration avec Antigravity CLI
- Pour les utilisateurs sans connaissances techniques avancées
- Connecteur distant avec OAuth 2.1 · Terminal (agy) · mcp_config.json
1. Ce que c'est et en quoi cela diffère des autres versions
Ce guide connecte Antigravity CLI au serveur MCP distant d'Eulerian. La CLI (la commande agy) est la version terminal de Google : un agent avec lequel vous travaillez en tapant dans la console, sans interface graphique. Elle prend en charge les serveurs MCP distants avec authentification OAuth 2.1. Vous 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 et à l'IDE, ici tout se passe dans le terminal : on ouvre le gestionnaire avec la commande /mcp et la connexion OAuth se termine en collant un code dans la console elle-même.
Le principe, en une phraseUn point de terminaison distant + une connexion OAuth : vous ne stockez aucun jeton d'API et la CLI 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 le terminal.
2. Avant de commencer
Vous avez besoin de ces quatre éléments avant de continuer :
1
La CLI d'Antigravity (agy)
S'installe avec une seule commande (voir Étape 1). Fonctionne sous Windows, macOS et Linux. Elle partage le compte et la configuration avec Antigravity 2.0 et l'IDE.
2
Un compte Google
La CLI se connecte avec votre compte Google au premier lancement (ou réutilise la session déjà ouverte si vous utilisez Antigravity 2.0/IDE).
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 : 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 Installez la CLI (agy)
Ouvrez un terminal et exécutez l'installateur de votre système. Sous Windows, ouvrez PowerShell (touche Windows → tapez « powershell » → Entrée) et collez :
Autres plateformesWindows (CMD) : curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd · macOS et Linux : curl -fsSL https://antigravity.google/cli/install.sh | bash. Après l'installation, fermez et rouvrez le terminal pour qu'il reconnaisse la commande agy.
Étape 2 Lancez « agy » et terminez la bienvenue
Dans un terminal neuf, tapez agy et appuyez sur Entrée. La première fois, la CLI peut ouvrir votre navigateur pour vous connecter avec votre compte Google (ou réutiliser la session déjà ouverte). Terminez ensuite l'assistant : choisissez un thème de couleur (flèches ↑/↓ + Entrée), acceptez les conditions d'utilisation ([Done]) et, à la question, faites confiance au dossier (« Yes, I trust this folder »).
Premier lancement de la CLI : choisissez un thème de couleur avec les flèches et appuyez sur Entrée.
La CLI demande de faire confiance au dossier d'où vous l'ouvrez ; laissez « Yes, I trust this folder » et appuyez sur Entrée.
Connexion au premier lancementElle peut vous demander de vous connecter via le navigateur avec votre compte Google, ou réutiliser la session déjà ouverte si vous partagez les identifiants avec Antigravity 2.0/IDE.
É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 tokenIci, 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 le fichier de configuration mcp_config.json
Le connecteur se définit dans un fichier texte que la CLI partage avec Antigravity 2.0 et l'IDE. Ouvrez-le avec un éditeur de texte. Sous Windows (dans PowerShell) :
notepad $env:USERPROFILE\.gemini\config\mcp_config.json
Où se trouve le fichierWindows : C:\Users\<votre-utilisateur>\.gemini\config\mcp_config.json · macOS et Linux : ~/.gemini/config/mcp_config.json. Si l'éditeur demande de créer le fichier, répondez oui. Vous pouvez aussi l'utiliser par projet dans .agents/mcp_config.json.
Étape 5 Ajoutez le serveur d'Eulerian et enregistrez
Collez ce contenu dans le fichier (remplacez par votre point de terminaison, avec /mcp à la fin) et enregistrez (Fichier → Enregistrer) :
{"mcpServers": {"eulerian": {"serverUrl": "https://<votre-endpoint-d-API-Eulerian>/mcp"}}}
Si vous l'avez déjà ajouté dans 2.0 ou l'IDEComme les trois surfaces partagent ce fichier, Eulerian peut déjà s'y trouver. Dans ce cas, inutile de le rajouter : passez directement à l'Étape 6.
Étape 6 Ouvrez le gestionnaire MCP avec /mcp
Dans la zone de saisie de la CLI, tapez /mcp et appuyez sur Entrée. Le gestionnaire MCP Servers s'ouvre, où vous verrez Eulerian. Comme vous n'êtes pas encore identifié, il affichera [Auth Needed] avec un avis « Unauthorized » (c'est normal ; on le corrige à l'étape suivante).
Le gestionnaire « MCP Servers » affiche Eulerian avec « [Auth Needed] » : l'authentification manque.
Étape 7 Lancez l'authentification
Avec Eulerian sélectionné (la flèche `>` à sa gauche), appuyez sur Entrée pour ouvrir les actions. Vous verrez Restart, Disable et [Authenticate]. Allez sur Authenticate et appuyez sur Entrée.
Avec Eulerian sélectionné, appuyez sur Entrée et choisissez « Authenticate ».
Étape 8 Connectez-vous et autorisez dans le navigateur
La CLI ouvre votre navigateur sur la page de connexion d'Eulerian. Saisissez votre identifiant et votre mot de passe Eulerian, et sur l'écran des permissions cliquez sur « Approve » (la CLI ne voit jamais votre mot de passe).
L'écran de connexion d'Eulerian.
Autorisation dans Eulerian : vérifiez les permissions et cliquez sur « Approve ».
N'accordez que le nécessaireVérifiez les permissions avant d'approuver. Pour la lecture seule des rapports, eulerian:reports.read suffit ; n'accordez l'écriture que si votre cas d'usage l'exige.
Étape 9 Copiez le code et collez-le dans le terminal
Le navigateur affiche un code à usage unique (cliquez sur Copy to Clipboard). Revenez au terminal : la CLI attend à « Paste the authorization code below ». Collez le code et appuyez sur Entrée. Vous verrez « Authentication successful! ».
Antigravity affiche un code à usage unique : copiez-le avec « Copy to Clipboard » (code masqué).
La CLI demande de coller le code d'autorisation (l'URL est masquée) ; collez-le et appuyez sur Entrée.
Si le navigateur ne s'ouvre pas tout seulLe terminal affiche une URL d'autorisation : copiez-la et ouvrez-la manuellement dans le navigateur pour vous connecter, puis collez le code ici.
Étape 10 Connecteur connecté
Appuyez sur Entrée pour revenir au panneau MCP. Maintenant Eulerian apparaît comme ✓ [Authed] avec la liste des outils disponibles. Il est désormais connecté.
Eulerian connecté : « ✓ Eulerian [Authed] » avec ses outils (eulerian_tool_invoke, …).
Connexion terminéeAucun jeton collé. Vous pouvez déconnecter la CLI à tout moment avec la commande /logout, ou révoquer l'accès depuis votre compte Eulerian.
Étape 11 Utilisez-le
Appuyez sur Échap (Esc) pour quitter le panneau MCP et revenir à la zone de saisie. Tapez-y votre question en langage naturel et appuyez sur Entrée ; la CLI appellera les outils d'Eulerian. Par exemple :
À quels outils Eulerian as-tu accès ?
La CLI répond en utilisant le MCP d'Eulerian, en listant les outils disponibles.
4. Équipes et organisations
La configuration MCP se trouve 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 : utilisez la commande /logout dans la CLI pour vous déconnecter, ou révoquez-le 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) et la même session. Si vous avez déjà ajouté Eulerian sur une autre surface, la CLI le détecte. Et comme l'authentification est OAuth 2.1 déléguée au client, le même point de terminaison 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.
CLI vs Antigravity 2.0 et IDECe guide couvre le terminal (Antigravity CLI, la commande agy). Antigravity 2.0 est l'app d'agent et l'IDE est l'éditeur de code ; chacun 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 IDE, 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 à la CLI 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 collez dans le terminal est temporaire et à usage unique : il ne sert qu'à terminer l'authentification et expire rapidement. Ce n'est pas un jeton à stocker ni à partager.
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.
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.
Déconnectez-vous quand vous avez terminé
Utilisez /logout pour déconnecter votre compte et effacer les identifiants enregistrés sur le poste. Avant d'utiliser des données réelles, confirmez avec l'informatique quelles plateformes d'IA sont approuvées.
7. Si quelque chose ne fonctionne pas
« agy » n'est pas reconnu comme commande
Fermez et rouvrez le terminal pour qu'il prenne le nouveau PATH après l'installation. Si cela persiste, réinstallez avec la commande de l'Étape 1.
Je ne vois pas Eulerian en ouvrant /mcp
Il n'a pas été ajouté au fichier de configuration : ouvrez-le avec un éditeur (Étape 4) et collez le bloc de l'Étape 5, enregistrez et rouvrez /mcp.
Eulerian affiche « [Auth Needed] » / « Unauthorized »
C'est normal avant de vous identifier. Sélectionnez Eulerian, appuyez sur Entrée et choisissez « Authenticate » (Étape 7). Si cela persiste après authentification, contactez Eulerian.
Le navigateur ne s'ouvre pas à l'étape de connexion
Le terminal affiche une URL : copiez-la et ouvrez-la manuellement dans le navigateur. Après approbation, copiez le code et collez-le dans le terminal.
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
Copiez le code complet avec « Copy to Clipboard » et collez-le avant qu'il n'expire ; s'il expire, relancez « Authenticate ».
Je veux repartir de zéro pour la session
Exécutez /logout dans la CLI pour effacer les identifiants enregistrés et vous authentifier de nouveau.
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
- Antigravity CLI — installation et utilisation (doc officielle) : antigravity.google/docs/cli/install
- MCP dans Antigravity CLI (doc officielle) : antigravity.google/docs/cli/mcp
- OAuth 2.1 d'Eulerian (intégrations tierces) : doc.api.eulerian.com/#section/Introduction/OAuth-2.1-for-third-party-integrations
- Dépôt GitHub : github.com/EulerianTechnologies/eulerian-marketing-platform-mcp