Zum Hauptinhalt springen

Richte Antigravity für Kanera MCP ein

Google Antigravity verbindet sich mit Kanera über das Model Context Protocol. Es unterstützt entfernte Streamable HTTP-Server mit OAuth-Erkennung und dynamischer Client-Registrierung, sodass weder ein vorab registrierter Client noch ein API-Schlüssel nötig ist. Dieselbe Konfiguration funktioniert in der Antigravity-App, der IDE und der Antigravity CLI.

Füge Kanera zu deiner globalen Antigravity-MCP-Konfiguration hinzu unter ~/.gemini/config/mcp_config.json, oder zu .agents/mcp_config.json in einem Projekt, wenn die Verbindung nur dort verfügbar sein soll:

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

Wenn die Datei bereits andere Server enthält, füge den Eintrag kanera innerhalb des vorhandenen Objekts mcpServers hinzu. In der IDE kannst du diese Datei über die Seitenleiste des Agenten öffnen: Wähle … -> MCP Servers -> Manage MCP Servers -> View raw config.

Authentifiziere dich dann:

  1. Öffne in der Antigravity-App Customizations -> Installed. Unter MCP Servers, wähle Authentifizieren neben Kanera.
  2. Melde dich im Browser bei Kanera an, überprüfe den angeforderten Zugriff und wähle Zugriff erlauben.
  3. Kopiere den Autorisierungscode, den Antigravity anzeigt, füge ihn ein in Enter authorization code, und wähle Submit.

Antigravity verbindet sich erneut mit Kanera und aktualisiert das Token automatisch, wenn es abläuft. Gib in der Antigravity CLI /mcp ein, um den MCP-Manager zu öffnen, zu prüfen, ob Kanera verbunden ist, und die Verbindungsprotokolle zu lesen.

Antigravity fragt nach, bevor es ein MCP-Tool ohne Berechtigungsregel ausführt. Damit es die Tools von Kanera nutzen kann, ohne jedes Mal zu fragen, erlaube mcp(kanera/*) in deinen Antigravity-Berechtigungen. Unabhängig davon, was der Client erlaubt, prüft Kanera bei jeder Anfrage weiterhin deine Rolle auf jedem Board und die KI-Agent-Richtlinie deiner Organisation.

Siehe KI-Agent verbinden für Scopes und das Trennen eines Agenten.

Installiere den Kanera-Skill​

Die MCP-Verbindung gibt Antigravity Zugriff auf die Tools von Kanera. Der optionale Kanera-Agenten-Skill lehrt es, Namen in stabile IDs aufzulösen, den Live-Status zu lesen, bevor Arbeit gemeldet oder geändert wird, abgeschlossene Arbeit von Erstellungsaktivität zu unterscheiden, Idempotenzschlüssel zu verwenden und Berechtigungs- oder Ratenbegrenzungsfehler sicher zu behandeln.

Installiere den Skill global mit dem offenen Agent-Skills-Installer:

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

Für eine manuelle Installation lädst du das vollständige kanera Skill-Verzeichnis herunter und lege es an einem dieser Orte ab:

  • ~/.gemini/config/skills/kanera/ für einen persönlichen Skill, der projektübergreifend verfügbar ist.
  • .agents/skills/kanera/ in einem Repository, um den Skill mit diesem Projekt zu teilen.

Antigravity zeigt den Skill seinem Agenten an und lädt die vollständigen Anweisungen, wenn eine Anfrage dazu passt. Du kannst den Skill auch in deinem Prompt nennen oder /kanera in der App oder der CLI eingeben. Führe in der CLI /skills reload aus, falls du den Skill während einer Sitzung hinzugefügt hast.

Ausnahme: Verbindung mit einem API-Schlüssel herstellen​

Nutze OAuth, wann immer möglich

Ein API-Schlüssel ist ein langlebiges Geheimnis, das du selbst speicherst und rotierst, und Arbeit, die mit einem persönlichen Schlüssel erledigt wird, wird auf deinen Namen verbucht, ohne das über <agent>. Verwende einen Schlüssel nur, wenn OAuth wirklich nicht funktionieren kann:

  • Deine Antigravity-Version kann den Remote-OAuth-Ablauf nicht abschließen.
  • Du benötigst einen lokalen stdio-Server und kannst dieses Werkzeug nicht einsetzen: Kanera CLI. kanera auth login meldet sich mit OAuth an und kanera mcp stellt stdio mit dieser Anmeldung bereit, ohne dass ein Schlüssel nötig ist.
  • Der Rechner hat keinen Browser für die Anmeldung. Probiere zuerst die Geräteautorisierung aus, wenn dein Client sie unterstützt.

Wenn du doch einen Schlüssel verwendest, erstelle ihn mit dem Umfang Nur lesen, es sei denn, der Agent muss Arbeit ändern.

Antigravity sendet Header-Werte genau so, wie sie geschrieben sind, daher wird der Schlüssel direkt in der Konfigurationsdatei gespeichert. Verwende die globale Datei ~/.gemini/config/mcp_config.json statt einer Projektdatei und committe sie niemals:

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

Erstelle einen persönlichen Schlüssel unter Profileinstellungen -> API-Schlüssel oder einen Arbeitsbereichsschlüssel in Arbeitsbereichseinstellungen -> API.

Client-Referenz​