Gemini CLI

Voraussetzungen

Verwenden Sie Gemini CLI-Entwicklertools mit deren geprüfter settings.json-MCP-Konfiguration und browserbasierter OAuth-Unterstützung. Die Unterstützung gilt für das Gemini CLI-Entwicklertool und impliziert keine Integration in den Gemini-Endbenutzer-Web-Chat (gemini.google.com) oder eine offizielle Genehmigung im Erweiterungs-Store.

• Endpunkt: https://xmemo.dev/mcp.
• Authentifizierungsmodus: OAuth.
• Konfigurationsdatei: ~/.gemini/settings.json.
• Transport: Streamable HTTP (httpUrl für den gehosteten Endpunkt).
• Erweiterungs-Repository: github:yonro/xmemo-gemini-cli (Manifest 0.1.0; dokumentierte GitHub-Installation, keine offizielle Galerie-Zulassung abgeleitet).

Installation / Einrichtung

Installieren Sie die Erweiterung mit dem Befehl Gemini CLI extensions oder fügen Sie den XMemo-Konfigurationsblock manuell in ~/.gemini/settings.json unter mcpServers ein.

• Erweiterungsbefehl: gemini extensions install https://github.com/yonro/xmemo-gemini-cli (verankert an yonro/xmemo-gemini-cli @ 39e25b185b README).
• Manueller Fallback: Den XMemo-Block in ~/.gemini/settings.json einfügen und dabei httpUrl und Identitäts-Header beibehalten.

gemini extensions install https://github.com/yonro/xmemo-gemini-cli

Anmeldedaten konfigurieren

Kein Schlüssel erforderlich — schließen Sie die browserbasierte OAuth-Autorisierung nach dem Neustart von Gemini CLI ab. Tragen Sie kein XMEMO_KEY und keinen Authorization-Header in die settings.json ein.

No XMEMO_KEY
Complete browser OAuth in Gemini CLI

XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Generieren Sie einen nicht-geheimen Wert pro lokaler Installation von Gemini CLI, speichern Sie ihn dauerhaft außerhalb von Git und verwenden Sie ihn nach Neustarts wieder, damit die Herkunftszuordnung stabil bleibt.

export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'

Bestehenden Konfigurationsblock beibehalten

Verwenden Sie den auf dieser Seite gerenderten bestehenden Gemini CLI-XMemo-Konfigurationsblock. Behalten Sie httpUrl und die nicht-geheimen Identitäts-Header bei; fügen Sie weder Authorization noch XMEMO_KEY hinzu.

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "gemini-cli",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Client neu starten

Starten Sie Gemini CLI nach dem Speichern der settings.json neu, damit der Endpunkt und die aktuelle Instanzidentität geladen werden, und schließen Sie anschließend die OAuth-Zustimmung ab.

Mit einem echten recall-Aufruf testen

Führen Sie den ersten MCP-Aufruf rein lesend aus. Dies ist ein tatsächlicher recall-Aufruf, kein Platzhalter für eine Statusprüfung, und er schreibt keine Daten in den Speicher.

recall({ query: "connection check", limit: 1 })

Erwartete Antwort (wörtliche Struktur)

Ein erfolgreicher Aufruf gibt die unten dargestellte öffentliche strukturierte Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Häufige Fehler

OAuth-Fehler bei Gemini CLI folgen dem gehosteten OAuth-Fehlervertrag.

• invalid_grant — Der OAuth-Autorisierungscode ist ungültig, abgelaufen oder wurde bereits verwendet: Verbinden Sie Gemini CLI erneut und autorisieren Sie neu.
• invalid_target — Die OAuth-Ressource stimmt nicht mit diesem MCP-Server überein: Verwenden Sie https://xmemo.dev/mcp und verbinden Sie sich erneut.
• 403 insufficient_scope — Die Gewährung umfasst nicht memory:read: Genehmigen Sie den erforderlichen Geltungsbereich und verbinden Sie sich erneut.