Passer au contenu principal

Configurer Antigravity pour Kanera MCP

Google Antigravity se connecte à Kanera via le Model Context Protocol. Il prend en charge les serveurs HTTP Streamable distants avec découverte OAuth et enregistrement dynamique des clients, si bien qu'aucun client préenregistré ni aucune clé API n'est nécessaire. La même configuration fonctionne dans l'application Antigravity, l'IDE et Antigravity CLI.

Ajoutez Kanera à votre configuration MCP globale d'Antigravity à ~/.gemini/config/mcp_config.json, ou à .agents/mcp_config.json dans un projet lorsque la connexion ne doit être disponible que dans ce projet :

{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp"
}
}
}

Si le fichier répertorie déjà d'autres serveurs, ajoutez l'entrée kanera dans l'objet existant mcpServers. Dans l'IDE, vous pouvez ouvrir ce fichier depuis le panneau latéral de l'agent : choisissez … -> MCP Servers -> Manage MCP Servers -> View raw config.

Authentifiez-vous ensuite :

  1. Dans l'application Antigravity, ouvrez Customizations -> Installed. Sous MCP Servers, choisissez S'authentifier à côté de Kanera.
  2. Connectez-vous à Kanera dans le navigateur, vérifiez l'accès demandé et choisissez Autoriser l'accès.
  3. Copiez le code d'autorisation affiché par Antigravity, collez-le dans Enter authorization code, et choisissez Submit.

Antigravity se reconnecte à Kanera et actualise automatiquement le jeton lorsqu'il expire. Dans Antigravity CLI, saisissez /mcp pour ouvrir le gestionnaire MCP, vérifier que Kanera est connecté et lire ses journaux de connexion.

Antigravity demande une confirmation avant d'exécuter un outil MCP sans règle d'autorisation. Pour lui permettre d'utiliser les outils de Kanera sans demander à chaque fois, autorisez mcp(kanera/*) dans vos autorisations Antigravity. Quoi que le client autorise, Kanera vérifie toujours votre rôle sur chaque tableau et la politique des agents IA de votre organisation à chaque requête.

Voir Connecter un agent IA pour les portées et la déconnexion d'un agent.

Installez la compétence Kanera​

La connexion MCP donne à Antigravity l'accès aux outils de Kanera. La compétence d'agent Kanera lui apprend à résoudre les noms en identifiants stables, à lire l'état en direct avant de signaler ou de modifier du travail, à distinguer le travail terminé de l'activité de création, à utiliser des clés d'idempotence et à gérer en toute sécurité les échecs d'autorisation ou de limite de débit.

Installez la compétence globalement avec l'installateur ouvert Agent Skills :

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera -a antigravity --yes --global

Pour une installation manuelle, téléchargez le répertoire complet kanera de la compétence, et placez-le dans l'un de ces emplacements :

  • ~/.gemini/config/skills/kanera/ pour une compétence personnelle disponible dans tous les projets.
  • .agents/skills/kanera/ dans un dépôt pour partager la compétence avec ce projet.

Antigravity présente la compétence à son agent et charge les instructions complètes lorsqu'une demande s'y rapporte. Vous pouvez aussi nommer la compétence dans votre prompt, ou saisir /kanera dans l'application ou la CLI. Dans la CLI, exécutez /skills reload si vous avez ajouté la compétence pendant une session.

Exception : connectez-vous avec une clé API​

Utilisez OAuth chaque fois que possible

Une clé API est un secret de longue durée que vous stockez et renouvelez vous-même, et le travail effectué avec une clé personnelle est enregistré à votre nom, sans le via <agent> habituelle. N'en utilisez une que lorsque OAuth ne peut vraiment pas fonctionner :

  • Votre version d'Antigravity ne parvient pas à terminer le flux OAuth distant.
  • Vous avez besoin d'un serveur stdio local et vous ne pouvez pas utiliser le Kanera CLI. kanera auth login se connecte avec OAuth, et kanera mcp sert stdio avec cette connexion, aucune clé requise.
  • La machine n'a pas de navigateur pour la connexion. Essayez l'autorisation de l'appareil d'abord si votre client le prend en charge.

Lorsque vous utilisez une clé, créez-la Lecture seule sauf si l'agent doit modifier le travail.

Antigravity envoie les valeurs d'en-tête exactement telles qu'elles sont écrites, la clé est donc stockée dans le fichier de configuration lui-même. Utilisez le fichier global ~/.gemini/config/mcp_config.json plutôt qu'un fichier de projet, et ne le commitez jamais :

{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_KANERA_API_KEY"
}
}
}
}

Créez une clé personnelle dans Paramètres du profil -> Clés API ou une clé d'espace de travail dans Paramètres de l'espace de travail -> API.

Référence client​