Configurer un serveur MCP dans Antigravity IDE

À quoi sert un serveur MCP dans Antigravity IDE

Le Model Context Protocol, ou MCP, fournit une méthode standard pour présenter à un agent des outils et du contexte externes. Un serveur peut exposer une base de données, une documentation, un système de tickets, un service cloud, un analyseur de fichiers ou une API. Antigravity lance le processus configuré ou contacte le point d'accès distant, découvre ses outils et les rend disponibles selon les autorisations accordées.

Installer MCP ne revient pas à installer un thème. Un serveur local stdio exécute une commande sur votre machine. Un serveur distant reçoit des requêtes et peut demander OAuth ou un jeton. Avant l'ajout, identifiez l'éditeur, les données accessibles, les actions possibles et la nécessité réelle d'un accès hors du dépôt.

Cette procédure suit la documentation Google actuelle et distingue l'IDE de la CLI Antigravity. L'IDE propose le Store et l'édition JSON. La CLI propose le gestionnaire interactif /mcp, mais son état ne prouve pas automatiquement que l'IDE de bureau utilise le même fichier.

Choisir une configuration MCP globale ou de projet

Adoptez la portée la plus étroite. Une entrée globale convient à un outil personnel répété ; une entrée de projet se révise, se partage et se retire avec le dépôt.

Installer un serveur depuis le MCP Store

Ouvrez un vrai projet, attendez la fin de la connexion et de l'initialisation, puis utilisez le menu à trois points en haut du panneau Agent. Sélectionnez MCP Servers. Survolez un serveur pris en charge et choisissez Install, ou consultez d'abord sa fiche. Terminez l'authentification officielle et revenez à la liste pour confirmer sa présence.

Commencez par un seul serveur. Plusieurs installations simultanées rendent le diagnostic difficile et ajoutent beaucoup d'outils au choix de l'agent. Une base propre associe un éditeur connu, un flux d'authentification et une requête de test.

1. Étape 1 — Ouvrez le panneau Agent et le menu à trois points.
2. Étape 2 — Choisissez MCP Servers et contrôlez l'éditeur et l'accès demandé.
3. Étape 3 — Installez un serveur, terminez son authentification officielle et rechargez.
4. Étape 4 — Demandez une lecture inoffensive et examinez résultat et autorisations.

Ajouter un serveur personnalisé avec mcp_config.json

Si le serveur n'est pas dans le Store, choisissez Manage MCP Servers puis View raw config. L'emplacement global documenté est ~/.gemini/config/mcp_config.json ; la configuration locale peut résider dans .agents/mcp_config.json. Gardez un unique objet mcpServers à la racine. Commande, arguments, endpoint et authentification doivent venir de la documentation de l'éditeur.

L'exemple reste volontairement inactif. Pour stdio, command et args lancent le processus. Pour une connexion distante actuelle, Google documente serverUrl ; les anciens champs url ou httpUrl peuvent être ignorés. Ne devinez ni paquet ni adresse et ne validez pas de clé privée dans Git.

{
  "mcpServers": {
    "serveur-exemple": {
      "command": "COMMANDE_OFFICIELLE",
      "args": ["ARGUMENT_OFFICIEL"]
    },
    "distant-exemple": {
      "serverUrl": "https://POINT_ACCES_OFFICIEL_EXEMPLE/mcp"
    }
  }
}

Il s'agit d'une structure, pas d'un serveur fonctionnel. Copiez exécutable, URL, en-têtes et OAuth uniquement depuis la source officielle choisie.

Recharger et vérifier le serveur MCP

Enregistrez un JSON valide, revenez à la liste et rechargez. Le serveur doit apparaître et ses outils ou ressources doivent pouvoir être inspectés. Ne commencez pas par une écriture : demandez la liste des ressources, la lecture d'un document de test ou seulement les noms d'outils.

En cas d'authentification, vérifiez le compte et la portée. Un voyant vert prouve la connexion, pas l'adéquation aux données confidentielles. Examinez l'outil, ses arguments et la source retournée avant de mémoriser une autorisation.

• Chargé — Le bon nom apparaît et la liste d'outils est consultable.
• Autorisé — Le compte et la portée correspondent au projet prévu.
• Fondé — Le test de lecture retourne la bonne source et non une réponse inventée.
• Réversible — Vous savez désactiver l'entrée, révoquer le jeton et retirer la configuration.

Règles de sécurité et d'autorisation MCP

Considérez chaque serveur comme du code qui franchit une frontière de données. Préférez un fournisseur officiel ou un dépôt inspectable, fixez la version si possible et refusez les scripts shell de tutoriels non vérifiés. Pour le cloud et les bases, utilisez un compte de développement avec le minimum de droits, jamais un propriétaire de production pour le premier test.

La portée du projet n'est pas un bac à sable automatique. Le processus peut lire ce que le compte système autorise. Écartez secrets et jetons des prompts et du JSON versionné. Examinez chaque écriture, suppression, déploiement, paiement, message et administration de compte tant qu'une politique précise n'existe pas.

Corriger les problèmes MCP dans Antigravity IDE et WSL

Les causes habituelles sont la mauvaise portée, un JSON invalide, PATH, l'authentification ou un mélange de chemins Windows et WSL. Modifiez une seule variable à la fois.

Le serveur n'apparaît pas après rechargement

Validez le JSON, placez mcpServers à la racine et vérifiez le fichier affiché par Manage MCP Servers. Recherchez une configuration globale ou locale différente. Redémarrez l'IDE seulement après l'échec d'un rechargement normal.

La commande marche dans le terminal, pas dans l'IDE

Le processus graphique peut avoir un PATH, un dossier personnel ou des variables différents. Employez un chemin absolu si l'éditeur l'autorise et relancez Antigravity après une modification système.

L'exécution depuis WSL échoue

Décidez quel système possède le processus. Un IDE Windows nécessite souvent wsl.exe explicite et des chemins Linux dans sa commande. Un programme WSL ne doit pas recevoir C:\ comme chemin Linux. Testez exactement la commande hors IDE.

Le serveur distant se connecte sans outils

Contrôlez le véritable endpoint, l'authentification et le transport. La configuration actuelle utilise serverUrl. Une page de produit ou un tableau de bord n'est pas l'adresse MCP.

Le serveur redémarre en boucle

Lancez-le directement et examinez stderr sans exposer de secret. Cherchez un runtime absent, une version incompatible, des logs sur stdout ou des identifiants expirés.

Vérification de version et de source de téléchargement

Ce site traite du téléchargement de logiciels ; la vérification a donc précédé la publication. Le 24 juillet 2026, le changelog officiel Google indiquait la version 2.2.1 datée du 25 juin 2026. Le site affichait déjà v2.2.1 : aucun numéro n'a dû changer. Cette page n'invente ni taille, checksum, analyse de sécurité, ni URL permanente de paquet.

Le bouton renvoie vers la page officielle comme solution vérifiée. Consultez-la de nouveau avant l'installation, car le déploiement peut être progressif. Les menus MCP peuvent évoluer : les documents officiels ci-dessous restent l'autorité pour les chemins et le schéma distant.