Zum Hauptinhalt springen

Richten Sie Gemini CLI für Kanera MCP ein

Gemini CLI stellt über das eine Verbindung zu Kanera her Modellkontextprotokoll. Es unterstützt Remote-HTTP-Server, automatische OAuth-Erkennung, dynamische Client-Registrierung und Token-Aktualisierung.

Kanera als Remote-HTTP-Server hinzufügen:

gemini mcp add --scope user --transport http kanera https://mcp.kanera.app/mcp

Starten Sie Gemini CLI und authentifizieren Sie sich dann über die interaktive Eingabeaufforderung:

/mcp auth kanera

Gemini CLI öffnet Kanera in Ihrem Browser. Melden Sie sich an, überprüfen Sie den angeforderten Zugriff und wählen Sie aus Zugriff erlauben. Lauf gemini mcp list von Ihrer Shell aus, um zu überprüfen, ob der Server verbunden ist, oder verwenden Sie /mcp innerhalb der Gemini-CLI, um es zu überprüfen.

Sie können Kanera auch direkt in den Gemini-CLIs konfigurieren settings.json:

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

Für interaktives OAuth sind ein lokaler Browser und ein Localhost-Rückruf erforderlich. Verwenden Sie in einer Headless- oder Remote-Umgebung, die diesen Rückruf nicht ausführen kann Geräteautorisierung ob Ihr Client die Gerätegewährung unterstützt oder darauf zurückgreift ein API-Schlüssel. Siehe Verbinden Sie einen KI-Agenten für Bereiche und Trennen eines Agenten.

Installieren Sie den Kanera-Skill​

Über die MCP-Verbindung erhält Gemini CLI Zugriff auf die Tools von Kanera. Das optionale Fertigkeit des Kanera-Agenten 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.

Installieren Sie den Skill global mit dem offenen Agent Skills-Installationsprogramm:

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

Für eine manuelle Installation laden Sie die vollständige herunter kanera Fertigkeitsverzeichnis und platzieren Sie es an einem dieser Orte:

  • ~/.agents/skills/kanera/ oder ~/.gemini/skills/kanera/ für eine persönliche Kompetenz, die projektübergreifend verfügbar ist.
  • .agents/skills/kanera/ oder .gemini/skills/kanera/ in einem Repository, um den Skill mit diesem Projekt zu teilen.

Ausführung /skills list innerhalb der Gemini-CLI, um zu überprüfen, ob der Skill verfügbar ist, und /skills reload nachdem ich es geändert habe. Gemini CLI fordert eine Bestätigung an, wenn ein Skill aktiviert wird.

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

:::Achtung: Verwenden Sie OAuth, wann immer Sie können. Ein API-Schlüssel ist ein langlebiges Geheimnis, das Sie selbst speichern und rotieren, und die mit einem persönlichen Schlüssel ausgeführte Arbeit wird als Sie selbst aufgezeichnet, ohne dass dies der Fall ist über <agent> Etikett. Verwenden Sie eine davon nur, wenn OAuth wirklich nicht funktionieren kann:

  • Ihre Gemini-CLI-Umgebung kann den Localhost-OAuth-Rückruf nicht abschließen.
  • Sie benötigen einen lokalen stdio-Server und können diesen nicht verwenden Kanera CLI. kanera auth login meldet sich mit OAuth an und kanera mcp stellt stdio mit dieser Anmeldung bereit, kein Schlüssel erforderlich.
  • Der Computer verfügt über keinen Browser für die Anmeldung. Versuchen Sie es Geräteautorisierung Zuerst, wenn Ihr Kunde dies unterstützt.

Wenn Sie einen Schlüssel verwenden, erstellen Sie ihn Schreibgeschützt es sei denn, der Agent muss die Arbeit ändern und sie in einer Umgebungsvariablen statt in einer festgeschriebenen Datei aufbewahren. :::

Fügen Sie einen Autorisierungsheader hinzu settings.json das liest den Schlüssel aus Ihrer Umgebung:

{
  "mcpServers": {
    "kanera": {
      "httpUrl": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer $KANERA_API_KEY"
      }
    }
  }
}

Erstellen Sie einen persönlichen Schlüssel Profileinstellungen -> API-Schlüssel oder eine Arbeitsbereichstaste eingeben Arbeitsbereichseinstellungen -> API. Vermeiden Sie es, den Schlüssel direkt hineinzustecken settings.json.

Kundenreferenz​