Comment déployer Google Antigravity MCP ? Configuration des autorisations sur un Mac cloud et validation en 2026

Google Antigravity MCP doit d’abord être déployé dans un Mac cloud isolé, avec une URL MCP vérifiée, un seul outil autorisé et une confirmation humaine pour les actions sensibles ; l’activation de permissions globales est à éviter pour les tâches de production. Cette méthode convient aux développeurs qui testent un agent, aux équipes qui préparent un environnement partagé et aux responsables qui doivent pouvoir expliquer chaque accès.

À qui s’adresse ce guide ?
Les développeurs qui souhaitent déplacer Google Antigravity d’un poste local vers un Mac cloud peuvent suivre cette progression jusqu’au premier appel contrôlé. Les responsables d’équipe y trouveront une méthode d’acceptation pour les clés, les outils et les journaux, tandis que les personnes qui comparent un Mac local et un environnement distant pourront évaluer le coût opérationnel de chaque option avant de généraliser l’usage.

Calendrier de déploiement

Le déploiement de Google Antigravity MCP ne doit pas être traité comme une simple installation de bibliothèque. Il s’agit d’une chaîne de confiance composée du poste distant, du réseau sortant, du serveur MCP, du modèle et des permissions qui autorisent l’agent à agir. La documentation officielle confirme la gestion des serveurs MCP, des connexions distantes et des contrôles d’accès ; elle ne transforme toutefois pas une connexion valide en garantie de sécurité automatique.

La séquence recommandée est la suivante :

Avant l’installation : réserver un environnement isolé, définir le projet de test et inventorier les secrets nécessaires.
Avant le premier outil : enregistrer un serveur MCP distant et vérifier sa réponse sans donner de permission d’écriture.
Lors du premier appel : utiliser une requête en lecture seule, puis comparer le résultat avec les journaux du serveur et du Mac.
Avant l’extension : ajouter les outils un par un, en séparant fichiers, commandes et appels MCP.
Avant l’usage d’équipe : versionner la configuration, faire tourner les clés et documenter les procédures de révocation.

Les fonctions et les champs peuvent évoluer avec la documentation et la version installée. La documentation officielle de Google Antigravity Agent doit donc rester la référence pour la syntaxe réellement acceptée au moment du déploiement.

Contrôle préalable

[ ] Le Mac cloud possède un répertoire de projet séparé des fichiers personnels.
[ ] La sortie réseau nécessaire au serveur MCP est autorisée, sans ouvrir inutilement les connexions entrantes.
[ ] Les variables d’environnement sont injectées par un mécanisme de secrets plutôt que copiées dans le dépôt.
[ ] Le compte utilisé pour le test ne possède pas de droits de production.
[ ] Les fichiers contenant des clés, des jetons, des données clients ou des informations de paiement sont exclus du périmètre initial.
[ ] Une méthode de récupération de session est prévue en cas de déconnexion du bureau distant.
[ ] Le responsable sait où sont conservés les journaux et combien de temps ils seront examinés.
[ ] Les tâches graphiques, audio ou vidéo ont été distinguées des tâches purement textuelles et de ligne de commande.

Un Mac cloud est particulièrement pratique pour isoler un environnement de développement, reproduire une configuration et laisser une session disponible à distance. Il ajoute cependant des dépendances : réseau, accès au bureau distant, stockage persistant, quotas de disque et gestion des identités. Pour une première configuration, les offres de location de Mac mini pour usage distant peuvent être comparées à un poste local en tenant compte de ces contraintes, et non uniquement de la puissance annoncée.

Architecture MCP et choix du premier serveur

Google Antigravity peut jouer le rôle d’agent qui demande une action, mais le serveur MCP reste le composant qui expose les outils et exécute leur logique. Un agent fondé sur Gemini, l’interface Antigravity et le service distant ne doivent donc pas être confondus : une réponse incorrecte du modèle, une erreur du serveur MCP et une permission refusée sur le Mac produisent des symptômes parfois proches, mais exigent des corrections différentes.

Deux modèles de connexion doivent être distingués :

Type de connexion	Fonctionnement	Intérêt pour un premier test	Risque à surveiller
MCP local	Le serveur s’exécute sur le Mac cloud et communique avec l’agent sur le même environnement	Contrôle direct du processus et diagnostic plus simple	Le serveur local peut hériter de fichiers, variables et droits du compte
MCP distant avec HTTP diffusé	Antigravity atteint une URL de service qui expose le protocole MCP à distance	Séparation claire entre l’agent et le service, utile pour un outil partagé	URL, certificat, en-têtes, sortie réseau et authentification doivent tous être valides

La documentation Google consacrée à la configuration MCP doit être consultée pour confirmer les champs disponibles et les exigences du service utilisé. Dans tous les cas, le nom du serveur doit être suffisamment explicite pour être retrouvé dans les journaux, l’URL doit être précise et la liste allowed_tools doit commencer par un seul outil en lecture.

Une configuration de travail peut être organisée autour des éléments suivants, à adapter au format réellement demandé par la version installée :

{
  "name": "serveur-mcp-lecture",
  "url": "https://exemple.invalid/mcp",
  "headers": {
    "Authorization": "Bearer ${MCP_TOKEN}"
  },
  "allowed_tools": [
    "read_only_lookup"
  ]
}

Cet extrait illustre la séparation entre l’adresse, l’authentification et les outils autorisés ; il ne faut pas copier une URL fictive ni placer un jeton réel dans un fichier versionné. Un nom comme serveur-mcp-lecture facilite l’audit, tandis qu’un nom générique ou réutilisé pour plusieurs services complique l’identification de la cause en cas d’échec.

Matrice des autorisations

L’erreur la plus coûteuse consiste à traiter les autorisations MCP comme un interrupteur unique. Trois familles doivent être examinées séparément :

read_file : accès au contenu des fichiers. Une lecture autorisée sur tout le dossier utilisateur peut exposer des clés, des historiques de terminal ou des documents sans rapport avec le projet.
command : exécution de commandes sur le Mac. Une commande apparemment anodine peut modifier l’environnement, supprimer des fichiers ou transmettre des données à un service externe.
MCP : appel des outils proposés par un serveur distant. Un outil de lecture n’a pas le même impact qu’un outil capable de créer une ressource, de publier un contenu ou de modifier un dépôt.

La documentation Google Cloud sur le contrôle d’accès MCP présente les principes de restriction et de délégation à appliquer à ces accès. Les permissions globales, les correspondances génériques et les règles couvrant tous les serveurs doivent être considérées comme des exceptions temporaires, jamais comme la configuration de référence.

Environnement	Fichiers	Commandes	Outils MCP	Confirmation humaine
Développement	Projet de travail et fichiers de test uniquement	Commandes nécessaires au développement, sans privilège administrateur	Un serveur identifié, avec lecture prioritaire	Recommandée pour toute écriture externe
Test	Jeu de données synthétique et répertoire isolé	Commandes limitées à la validation	Outils de lecture puis outil d’écriture contrôlé	Obligatoire pour la première écriture
Production	Périmètre explicitement documenté	Aucun accès large par défaut	Outils indispensables et précisément nommés	Obligatoire pour secrets, paiements, publication et suppression

La règle opérationnelle est simple : si une tâche peut être réalisée avec une lecture structurée, il ne faut pas accorder une commande d’écriture. Si un seul outil suffit, il ne faut pas autoriser le serveur entier. Si une action modifie un système externe, l’agent doit demander une confirmation explicite ou être placé derrière un mécanisme d’approbation.

Les rôles et permissions MCP documentés par Google Cloud aident à distinguer le rôle d’un utilisateur, celui du service distant et celui de l’agent. Cette séparation est importante lorsque plusieurs développeurs utilisent le même Mac cloud ou lorsque le serveur MCP accède à des ressources appartenant à une équipe.

Point de vigilance : une clé placée dans un en-tête n’est pas protégée par le seul fait qu’elle n’apparaît pas dans l’interface graphique. Elle peut encore être visible dans un fichier de configuration, un journal de débogage, un historique de commande ou une capture d’écran de session distante.

Premier enregistrement et diagnostic réseau

L’ajout d’un serveur MCP doit être progressif. Commencez par créer la configuration sans outil d’écriture, puis contrôlez chaque couche avant d’ajouter la suivante.

1. Préparer l’identité du service

Créez un jeton réservé à l’environnement de test, avec une durée de vie et un périmètre aussi limités que le service le permet. N’utilisez pas une clé personnelle qui donne accès à plusieurs projets. Placez la valeur dans le gestionnaire de secrets ou dans une variable d’environnement injectée au démarrage ; ne l’insérez ni dans le dépôt ni dans une commande conservée par l’historique du terminal.

2. Renseigner l’adresse distante

Ajoutez l’URL MCP complète, en vérifiant le protocole, le certificat et le chemin exact. Une adresse de base correcte peut néanmoins échouer si le service attend un chemin différent ou une négociation particulière. Depuis le Mac cloud, testez la résolution du nom et la sortie réseau avec les outils de diagnostic appropriés, sans imprimer l’en-tête d’authentification.

3. Configurer les en-têtes

Le nom de l’en-tête, son format et son emplacement doivent correspondre à la documentation du serveur. Une erreur d’authentification ne doit pas être corrigée en élargissant les permissions globales. Commencez par vérifier la variable d’environnement, son chargement dans le processus Antigravity et sa présence dans la session appropriée.

4. Limiter `allowed_tools`

Inscrivez un seul outil dont la fonction est clairement en lecture. Évitez les motifs génériques qui autorisent automatiquement les outils ajoutés ultérieurement par le serveur. La documentation de référence sur MCP et Antigravity doit être utilisée pour vérifier le nom exact attendu et le comportement de la version active.

5. Effectuer l’appel minimal

Demandez une valeur non sensible et facilement vérifiable : état d’un service de test, métadonnée d’un fichier synthétique ou extraction d’un petit objet structuré. Le but n’est pas de mesurer la créativité de l’agent, mais de démontrer que l’identité, le réseau, le protocole, l’outil et la réponse suivent le chemin prévu.

6. Conserver les traces utiles

Notez l’heure de l’essai, la configuration utilisée, le nom du serveur, l’outil appelé, le résultat, l’erreur éventuelle et la décision prise. Les secrets doivent être masqués. Cette trace permet de comparer une erreur de modèle avec une réponse invalide du serveur ou une session distante interrompue.

Validation de la première tâche

Après l’appel en lecture, la validation doit progresser vers une extraction structurée, puis vers une écriture volontairement limitée. Une tâche complexe pilotée par un agent n’est pas un bon test initial, car elle mélange le raisonnement, plusieurs outils, le contexte du projet et les effets de bord.

Le scénario d’acceptation peut suivre cette séquence :

Lecture contrôlée : l’outil retourne une donnée connue dans un espace de test.
Extraction structurée : la réponse respecte le schéma attendu, sans texte parasite qui rendrait l’automatisation ambiguë.
Échec simulé : une URL invalide ou un outil absent permet de vérifier que l’erreur est intelligible et qu’aucune permission supplémentaire n’est ajoutée automatiquement.
Écriture limitée : un fichier de test ou une ressource sans valeur métier est créé après confirmation humaine.
Reprise de session : une reconnexion du bureau distant ou du processus ne doit pas transformer une action interrompue en écriture silencieuse.

Les exemples pratiques du laboratoire Google Antigravity peuvent servir à comparer la logique générale du parcours, mais ils ne remplacent pas la validation de l’environnement propre au Mac cloud.

Pour chaque résultat, séparez trois catégories :

Échec du modèle : l’agent comprend mal la demande ou choisit un outil inadéquat alors que le service répond correctement.
Échec MCP : l’URL, le protocole, l’authentification, le serveur ou le schéma de réponse est en cause.
Échec du Mac cloud : session distante, disque, variable d’environnement, processus local ou sortie réseau défaillante.

Cette séparation évite de modifier une permission lorsqu’un serveur est simplement indisponible. Elle évite également d’accuser le modèle lorsqu’un jeton a expiré ou qu’un processus du Mac a été arrêté.

Extension d’équipe et maintenance

Une installation individuelle peut fonctionner sans être prête pour une équipe. Avant de partager la configuration, définissez un propriétaire du serveur MCP, une personne responsable des clés et un processus de retrait. Chaque nouvel outil doit être examiné selon sa destination, ses entrées, ses sorties et ses effets secondaires.

La liste de maintenance suivante doit être exécutée à intervalles documentés :

[ ] Faire tourner les clés sans modifier les fichiers du projet.
[ ] Révoquer les jetons liés à un développeur, une session ou un serveur supprimé.
[ ] Examiner chaque ajout ou changement de serveur MCP.
[ ] Comparer la configuration active avec une version approuvée.
[ ] Masquer les secrets dans les journaux et limiter les traces de données sensibles.
[ ] Surveiller l’espace disque utilisé par les journaux, les environnements et les médias.
[ ] Vérifier les sessions concurrentes et les connexions distantes abandonnées.
[ ] Prévoir l’arrêt des environnements inactifs lorsque leur persistance n’est pas nécessaire.
[ ] Tester une restauration après déconnexion avant de confier une tâche longue à l’agent.
[ ] Documenter la personne qui approuve une écriture vers un service externe.

Les hooks d’agent de Google peuvent compléter cette surveillance lorsqu’ils sont compatibles avec l’environnement utilisé, mais ils ne doivent pas être considérés comme un remplacement de la matrice de permissions. Un hook peut contrôler un moment du cycle d’exécution ; il ne définit pas à lui seul le périmètre légitime des fichiers, des commandes ou des outils.

Le passage à un environnement centralisé devient pertinent lorsque plusieurs équipes partagent les mêmes serveurs MCP, lorsque les journaux doivent être corrélés entre plusieurs agents ou lorsque les politiques d’approbation doivent être administrées depuis un point unique. À l’inverse, un Mac cloud isolé reste préférable pour un prototype, une validation d’intégration ou un projet nécessitant une interface macOS spécifique, notamment en audio, en vidéo ou en conception.

Questions fréquentes

Comment ajouter un serveur MCP dans Google Antigravity ?

Commencez par un serveur MCP distant accessible par une URL explicite, puis renseignez son nom, son adresse, ses en-têtes d’authentification et une liste allowed_tools limitée. Vérifiez d’abord la réponse du protocole et appelez un seul outil en lecture seule. N’ajoutez les autres outils qu’après avoir conservé la configuration et les journaux de cette première connexion.

Comment configurer les autorisations MCP d’Antigravity ?

Séparez les droits de lecture de fichiers, d’exécution de commandes et d’appel MCP. Évitez les caractères génériques appliqués à tous les serveurs ou à toutes les actions. Autorisez plutôt un outil précis sur un serveur précis, puis imposez une confirmation humaine pour les fichiers sensibles, les secrets, les paiements et toute écriture vers un service externe.

Que vérifier pour exécuter Antigravity sur un Mac cloud ?

Contrôlez l’accès réseau sortant, les variables d’environnement, le répertoire de projet, le stockage des secrets et la continuité de la session distante. Le Mac cloud doit aussi disposer d’un journal exploitable et d’une procédure de récupération. Pour les tâches audio, vidéo ou de conception, testez séparément les fichiers volumineux et les applications nécessitant une interface graphique.

Comment diagnostiquer un appel d’outil MCP qui échoue ?

Isolez l’erreur en vérifiant successivement l’URL, la résolution réseau, l’en-tête d’authentification, la réponse du protocole et le nom de l’outil autorisé. Comparez ensuite le journal MCP avec celui du Mac distant. Cette méthode permet de distinguer une erreur de raisonnement du modèle, un serveur MCP indisponible et un problème de session ou de permissions sur le Mac.

Un poste local reste souvent plus simple pour un usage personnel stable : il évite la dépendance à la connexion distante, ne demande pas de gérer une session persistante et permet un accès physique immédiat. Il devient moins pratique lorsqu’un environnement doit être partagé, recréé ou isolé, lorsque l’équipe travaille à distance ou lorsque des essais audio, vidéo et de conception doivent rester disponibles sans monopoliser le poste principal.

La location d’un Mac via Vuncloud peut offrir un environnement séparé pour tester Google Antigravity MCP, conserver une configuration reproductible et valider les permissions avant une décision d’achat. Elle ne convient toutefois pas à tous les cas : un besoin permanent de charge lourde, de périphériques physiques spécifiques ou de contrôle matériel direct peut justifier un Mac détenu localement. Pour comparer les modalités d’accès et les conditions de support, la page à propos de Vuncloud constitue un point de départ ; une demande détaillant le serveur MCP, le niveau d’isolement et le type de tâche permettra ensuite de vérifier si le Mac cloud est réellement adapté.