Gemini CLI mit deinem Studio verbinden

Was ist das

Gemini CLI ist Gemini von Google, das im Terminal deines Computers läuft. Mit dem KI-Konnektor kann es Daten aus deinem Studio abfragen (Umsätze, Kunden, Termine und Finanzen), wenn du eine Frage stellst. Dabei gelten die Berechtigungen des Benutzers, dem der Schlüssel gehört. Gemini kann die Daten nur abfragen und nichts im System ändern.

Wann verwenden

Du verwendest Gemini bereits im Terminal und möchtest dich über den Betrieb deines Studios informieren, ohne das System zu öffnen.
Du möchtest Zahlen aus dem System mit anderen Aufgaben kombinieren, die Gemini für dich erledigt.

Bevor Sie beginnen

Halte die Adresse des Konnektors bereit. Du kannst sie wie im Artikel KI verbinden beschrieben kopieren. Außerdem brauchst du einen API-Schlüssel mit der Berechtigung „Verwendung als KI-Konnektor erlauben“. Gemini CLI muss auf deinem Computer installiert sein. Du kannst dich auch über das System anmelden: Wenn du keinen Schlüssel-Header verwendest, gib in Gemini CLI /mcp auth heya ein und melde dich im geöffneten Fenster an.

Schritt für Schritt

Schritt 1 — Konnektor hinzufügen

Führe im Terminal den folgenden Befehl aus. Ersetze die Adresse durch die, die du über Adresse kopieren kopiert hast, und hk_... durch deinen Schlüssel:

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

Damit der Konnektor in allen Ordnern auf deinem Computer verfügbar ist, füge -s user hinzu. Wenn du lieber die Konfigurationsdatei (~/.gemini/settings.json) bearbeiten möchtest, füge Folgendes ein:

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Verwende httpUrl und nicht url: In Gemini CLI ist url das alte Verbindungsformat und funktioniert nicht mit dem Konnektor.

Schritt 2 — Verbindung prüfen

Öffne Gemini CLI und gib /mcp ein. Der Konnektor heya sollte mit dem Status CONNECTED und den Tools listar_areas, buscar_ferramentas und executar_consulta angezeigt werden.

Schritt 3 — Eine Frage stellen

Frage zum Beispiel: „Welche Ausgaben im Studio sind diese Woche fällig?“

Was danach passiert

Gemini sucht die passende Abfrage für deine Frage, führt sie aus und antwortet mit den Zahlen aus dem System.
Unter API Key wird der aktualisierte Wert für Zuletzt verwendet angezeigt.
Um den Zugriff zu beenden, widerrufe den Schlüssel unter API Key. Gemini verliert den Zugriff innerhalb von 30 Sekunden.

Häufige Fehler und Fragen

F: Funktioniert das mit Gemini im Browser (gemini.google.com)? A: Noch nicht. Gemini im Browser erfordert eine eigene Anmeldung statt eines API-Schlüssels. Verwende Gemini CLI.

F: /mcp zeigt DISCONNECTED an. Was kann ich tun? A: Prüfe, ob du httpUrl (und nicht url) verwendet hast, die Adresse mit /mcp endet und der Schlüssel vollständig eingefügt wurde – einschließlich Bearer und dem Leerzeichen danach.

F: Gemini sagt, für den Schlüssel sei die Berechtigung „Verwendung als KI-Konnektor erlauben“ erforderlich. Warum? A: Der Schlüssel wurde ohne diese Option erstellt. Bearbeite ihn unter API Key und aktiviere Verwendung als KI-Konnektor erlauben.

F: Mein Gemini CLI wurde zu Antigravity CLI. Gilt diese Anleitung weiterhin? A: Google hat Gemini CLI für einen Teil der Konten durch Antigravity CLI ersetzt. Suche dort nach der Option, einen MCP-Server über HTTP mit einem Header hinzuzufügen. Adresse und Header Authorization: Bearer hk_... bleiben gleich.

F: Kann ich den Schlüssel in einer Projektdatei speichern? A: Besser nicht. Die Datei .gemini/settings.json im Projektordner wird oft in die Versionsverwaltung aufgenommen. Dadurch wäre der Schlüssel offengelegt. Verwende stattdessen die Datei für dein Benutzerkonto (~/.gemini/settings.json).