Configuration MCP d’Antigravity : emplacement du fichier, Store et erreurs courantes

Vous collez un nouveau serveur dans Antigravity, vous cliquez sur Refresh et la liste des outils reste vide. Souvent, le serveur fonctionne très bien. Le problème vient du fichier : quel mcp_config.json l’application lit, où il se trouve sur votre disque, et si le JSON utilise les noms de champs attendus par Antigravity. Les pages officielles de Google indiquent deux chemins différents, les forums montrent des personnes qui modifient la mauvaise copie, et les messages d’erreur sont assez courts pour ressembler à des énigmes.

Cet article établit précisément les faits. Vous obtenez l’emplacement exact du fichier sous Windows, macOS et Linux, trois façons d’ouvrir le fichier depuis l’application, une présentation du MCP Store, une configuration qui tient la route et une solution simple pour chaque erreur courante. Lorsque les sources ne concordent pas, le texte le signale au lieu de deviner.

Où se trouve mcp_config.json

Antigravity conserve la définition de chaque serveur MCP dans un seul fichier JSON nommé mcp_config.json. La page officielle MCP mentionne un fichier global, qui s’applique à tous les projets, et un fichier d’espace de travail, qui s’applique à un seul dépôt.

Chemin global selon le système d’exploitation

Sous Windows, %USERPROFILE% correspond à quelque chose comme C:\Users\YourName. Le dossier .gemini commence par un point, donc le Finder et la plupart des gestionnaires de fichiers Linux le masquent. Dans le Finder, appuyez sur Cmd+Shift+. pour afficher les éléments masqués. Dans l’explorateur de fichiers Windows, cochez Éléments masqués dans le menu Affichage. Vous pouvez aussi éviter la navigation et coller le chemin complet dans la barre d’adresse ou dans la zone Aller au dossier.

Configuration d’espace de travail pour un projet

Dans un dépôt, la documentation présente .agents/mcp_config.json comme emplacement d’espace de travail. Cet emplacement convient aux serveurs qui n’ont de sens que pour une seule base de code, comme un serveur de base de données pointant vers le schéma de développement de ce projet. Un article japonais de dépannage indique que les paramètres de l’espace de travail peuvent remplacer le fichier global. Vérifiez donc ce chemin en premier lorsqu’un serveur se comporte différemment dans un dépôt précis.

💡 Astuce : Si un fichier d’espace de travail contient des tokens, ajoutez .agents/mcp_config.json à .gitignore avant votre prochain commit.

Pourquoi la documentation ne s’accorde pas sur le chemin

La documentation actuelle et la page de configuration CloudBees Unify utilisent ~/.gemini/config/mcp_config.json. Les anciens tutoriels, beaucoup de fichiers README de serveurs et le rapport de bug sur le PATH macOS utilisent ~/.gemini/antigravity/mcp_config.json. Le fichier de token OAuth se trouve aussi dans le dossier antigravity, ce qui explique en partie pourquoi ce nom de dossier revient sans cesse.

Aucune page ne précise lequel des deux fichiers prime lorsque les deux existent. Tranchez par un test : ajoutez une entrée inoffensive dans l’un des fichiers, cliquez sur Refresh, et regardez si elle apparaît dans la liste des serveurs. Si ce n’est pas le cas, vous avez modifié le mauvais fichier. Gardez alors un seul fichier actif et renommez la copie restante en mcp_config.json.bak pour éviter qu’elles ne divergent. Ouvrir le fichier via View raw config dans l’IDE est le moyen le plus rapide de savoir lequel votre version utilise.

Trois façons d’ouvrir le fichier

Inutile de fouiller dans des dossiers cachés. Chaque interface d’Antigravity offre son propre accès à la même configuration.

Depuis le panneau Agent de l’IDE

Dans l’IDE d’Antigravity, cliquez sur le menu … en haut du panneau latéral de l’agent, puis choisissez MCP Servers, puis Manage MCP Servers, puis View raw config. Le fichier s’ouvre dans l’éditeur. Enregistrez-le, revenez à l’écran Manage MCP Servers et cliquez sur Refresh. Ce dernier clic est l’étape que les discussions de dépannage recommandent sans cesse.

Depuis les paramètres d’Antigravity 2.0

Dans Antigravity 2.0, le chemin est Settings (en bas à gauche), puis Customizations, puis Installed MCP Servers. Chaque serveur dispose d’un interrupteur, d’une corbeille, et d’un bouton Refresh commun. L’outil en ligne de commande a son propre accès : tapez /mcp dans le panneau de saisie pour ouvrir le MCP Manager interactif. Il affiche aussi les journaux de connexion, y compris les codes de réponse comme 401, 403 et 404 ainsi que les délais d’attente, ce qui en fait le meilleur endroit pour comprendre ce qui a réellement échoué.

Fonctionnement du MCP Store

Le MCP Store est une liste consultable de serveurs prêts à l’emploi. La documentation décrit 76 intégrations ou plus, couvrant les bases de données, les outils de développement, les plateformes de design, la sécurité et l’analyse de données. Vous y accédez depuis Installed MCP Servers en cliquant sur Add MCP, ou depuis le menu MCP Servers du panneau Agent de l’IDE.

Ajouter un serveur depuis le Store

1. Ouvrez Settings, puis Customizations, puis Installed MCP Servers.
2. Cliquez sur Add MCP pour ouvrir le store.
3. Recherchez ou faites défiler jusqu’au serveur souhaité, puis cliquez sur Add.
4. Terminez la connexion si le serveur en demande une.
5. Vérifiez que l’interrupteur est activé, puis cliquez sur Refresh.

Ouvrez la configuration brute une fois après votre première installation depuis le store. L’entrée écrite par le store sert de modèle prêt à l’emploi pour les entrées que vous rédigerez ensuite à la main.

💡 Astuce : Utilisez le store pour les serveurs qui exigent OAuth, car il gère l’écran de connexion. Utilisez du JSON rédigé à la main pour les scripts locaux, les serveurs privés et tout ce qui nécessite des en-têtes personnalisés.

Où atterrissent les tokens OAuth

Selon la documentation, les tokens OAuth sont enregistrés dans ~/.gemini/antigravity/mcp_oauth_tokens.json. Traitez ce fichier comme un coffre-fort de mots de passe : tenez-le à l’écart des dépôts de fichiers de configuration et des dossiers synchronisés dans le cloud. Lorsqu’une connexion échoue à répétition, utilisez d’abord le bouton Sign out dans l’IDE, ou vérifiez le statut Authed dans la vue CLI /mcp. Supprimer le fichier de token est un dernier recours, et cela peut vous déconnecter de tous les serveurs distants en même temps.

Une configuration qui fonctionne vraiment

Le fichier ne contient qu’un seul objet de premier niveau, mcpServers, et chaque serveur est une entrée nommée à l’intérieur. Les noms ne doivent pas contenir d’espaces. Un fil de discussion sur le serveur Figma a montré qu’un nom suggéré, « Figma Desktop », devait devenir FigmaDesktop, et que le champ d’URL devait s’appeler serverUrl et non url.

Serveurs locaux avec command et args

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:/Users/you/projects"],
      "env": { "NODE_ENV": "production" },
      "cwd": "C:/Users/you/projects"
    }
  }
}

Copier le prompt

Sous Windows, écrivez les chemins avec des barres obliques ou doublez les antislashs (C:\\Users\\you), car un antislash simple est un caractère d’échappement en JSON. Voici le rôle de chaque champ :

Serveurs distants avec serverUrl

{
  "mcpServers": {
    "remote-example": {
      "serverUrl": "https://api.example.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Copier le prompt

La documentation indique que les champs url simples ne sont pas pris en charge pour les serveurs distants : un extrait copié depuis un autre éditeur demande donc ce seul renommage. Les serveurs qui utilisent OAuth prennent un bloc oauth à la place d’un en-tête : la page CloudBees montre "oauth": { "clientId": "public-mcp-client" }. Pour les serveurs Google Workspace, créez un client OAuth de type Application Web dans la Google Cloud Console, ajoutez https://antigravity.google/oauth-callback comme URI de redirection, puis placez le clientId et le clientSecret dans la section oauth. Les serveurs qui acceptent les identifiants par défaut d’application Google utilisent "authProviderType": "google_credentials".

Avant d’enregistrer, vérifiez trois points qui cassent le JSON plus souvent que n’importe quel bug d’Antigravity : les virgules finales, les commentaires (JSON n’en accepte aucun) et les guillemets courbes collés depuis une page web.

Erreurs courantes et solutions

Context deadline exceeded

Ce message apparaît au démarrage, accompagné du message de socket ENOENT, lorsqu’un serveur ne termine pas son initialisation à temps. La solution signalée est simple : ouvrez Manage MCP Servers et cliquez sur Refresh. Si le problème revient à chaque redémarrage, un contournement pratique consiste à installer le paquet du serveur globalement et à faire pointer command vers le binaire installé, afin que rien ne doive être téléchargé pendant le démarrage de l’IDE.

Executable not found in PATH

Des messages tels que exec: "npx": executable file not found in $PATH apparaissent lorsque Antigravity est lancé depuis le Dock ou Spotlight de macOS. L’application hérite du PATH système réduit (/usr/bin:/bin:/usr/sbin:/sbin) au lieu de celui défini dans le profil de votre shell. Le fil de discussion le signale sur la version 1.22.2 et propose ces contournements :

• Lancez l’application depuis un terminal avec la commande agy.
• Indiquez le chemin absolu dans command. Exécutez which npx et collez le résultat, par exemple /opt/homebrew/bin/npx sur une installation Homebrew typique sur Apple Silicon.
• Créez un petit script d’encapsulation qui charge votre gestionnaire de versions de Node avant de démarrer le serveur.

Les utilisateurs de Windows doivent d’abord exécuter where npx dans un terminal. Si rien ne s’affiche, le problème vient de l’installation de Node, pas de la configuration.

Unauthorized on initialize

Une erreur Unauthorized sur initialize signifie qu’un serveur distant a reçu la première requête sans token utilisable. Mettez Antigravity à jour, déconnectez-vous du serveur, puis reconnectez-vous. Si vous utilisez un token dans un en-tête, vérifiez que le champ s’appelle bien Authorization, que la valeur commence par Bearer et que le token n’a pas expiré. Le code de statut dans les journaux de la CLI /mcp permet de préciser le diagnostic : 401 indique des identifiants absents ou incorrects, 403 un token sans les bonnes autorisations, et 404 un chemin d’URL erroné.

Plus de 100 outils

Antigravity refuse de se connecter lorsque le nombre d’outils activés sur l’ensemble des serveurs dépasse 100. Les gros serveurs pour GitHub ou les bases de données peuvent exposer des dizaines d’outils chacun, si bien que trois ou quatre d’entre eux suffisent à atteindre la limite. Désactivez les serveurs que vous n’utilisez pas, ou masquez des outils individuels avec la propriété disabledTools présentée dans la documentation.

Un autre cas mérite d’être connu. Un rapport sur le forum des développeurs Google IA décrit un serveur Roblox Studio, lancé via un fichier batch, qui affichait le message EOF sur Hub 2.4.3, 2.5.0 et 2.8.0, et ne fonctionnait de nouveau qu’après un retour à Hub 2.2.1. Lorsqu’un serveur local échoue de cette façon, exécutez sa commande exacte dans un terminal. Si elle échoue aussi là, la configuration est correcte et c’est le serveur qui pose problème. Si elle fonctionne dans le terminal, soupçonnez une régression de version et consultez le forum avant de modifier votre JSON.

Utiliser Gemini 3.1 Pro sur PicassoIA

Lorsque le JSON refuse de fonctionner, un modèle de langage fait office de correcteur rapide. Gemini 3.1 Pro fonctionne dans le navigateur sur PicassoIA, accepte du texte et jusqu’à 10 images, et vous permet de régler l’intensité de sa réflexion avant de répondre.

Étapes à suivre

1. Ouvrez la page de Gemini 3.1 Pro sur PicassoIA.
2. Remplacez chaque token réel de votre configuration par YOUR_TOKEN avant de coller quoi que ce soit.
3. Collez votre JSON dans le champ Prompt après une consigne claire, par exemple : « Vérifiez ce mcp_config.json d’Antigravity pour détecter les erreurs de syntaxe et les mauvais noms de champs. Les serveurs distants doivent utiliser serverUrl, et non url. Les noms de serveurs ne doivent pas contenir d’espaces. Listez chaque problème, puis renvoyez uniquement le JSON corrigé. »
4. Facultatif : joignez une capture d’écran du panneau d’erreur dans le champ Images (jusqu’à 10 images, 7 Mo chacune).
5. Lancez le modèle, copiez le JSON corrigé dans View raw config, enregistrez, puis cliquez sur Refresh.

Conseils sur les paramètres

• thinking_level : la valeur par défaut est high. Gardez-la pour une configuration longue avec de nombreux serveurs. low suffit pour une simple vérification de syntaxe.
• temperature : la valeur par défaut est 1. Abaissez-la vers 0,2 pour que le modèle renvoie le même JSON à chaque fois au lieu de faire preuve de créativité.
• system_instruction : réglez-le sur quelque chose comme « Vous êtes un validateur JSON strict pour les fichiers de configuration MCP » pour garder une réponse courte.
• max_output_tokens : la valeur par défaut est suffisante pour toute configuration que vous rédigerez, donc laissez-la telle quelle.

Le modèle ne voit pas votre disque : traitez donc tout chemin qu’il propose comme une supposition, et vérifiez-le dans le tableau présenté plus haut dans cet article. Pour un second avis sur le même prompt, passez-le aussi par Claude Sonnet 4.6 et comparez les deux réponses.

Liste de contrôle avant de redémarrer

Parcourez cette liste avant d’incriminer le serveur :

• Le JSON est valide : pas de virgules finales, pas de commentaires, uniquement des guillemets droits.
• Les serveurs distants utilisent serverUrl, et les serveurs locaux utilisent command avec args.
• Les noms de serveurs ne contiennent aucun espace.
• La commande fonctionne dans un terminal, ou command contient un chemin absolu.
• Les tokens se trouvent dans env ou headers, et le fichier est hors du contrôle de version s’il contient des secrets.
• Le nombre d’outils activés sur l’ensemble des serveurs reste inférieur à 100.
• Vous avez modifié le fichier réellement lu par l’application, ce que vous pouvez confirmer via View raw config.
• Vous avez cliqué sur Refresh, puis vérifié les interrupteurs ou la vue CLI /mcp.

💡 Astuce : Un serveur qui fonctionne dans votre terminal mais échoue dans Antigravity signale généralement une différence d’environnement, le plus souvent au niveau du PATH. Comparez la sortie de which ou where avec ce que voit l’application.

Essayez PicassoIA vous-même

Une fois vos serveurs connectés, votre agent peut aller plus vite, et chaque projet livré a besoin de visuels : bannières de README, en-têtes de documentation, en-têtes de blog et aperçus pour les réseaux sociaux. Picasso IA réunit les modèles d’image en un seul endroit, pour tester un prompt, changer l’objectif ou la lumière et générer à nouveau en quelques secondes.

Commencez avec Seedream 4.5 pour des scènes photoréalistes détaillées, ou P-Image pour des brouillons rapides. Décrivez le sujet, le décor, la direction de la lumière et l’objectif de la caméra, comme vous le feriez pour briefer un photographe. Parcourez la liste complète des modèles, choisissez celui qui convient à votre prochain projet et créez votre première image dès aujourd’hui.