# Gemini CLI

Verwenden Sie die OAuth-Prioritätskonfiguration der Gemini CLI, ohne Bearer-Anmeldedaten in der settings.json abzulegen.

- Canonical: https://docs.xmemo.dev/de/docs/mcp/gemini
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 0a6aa86e8077d8de0a7e7252c8c9f50fdcc1bda86fd0811f01ffd845f1fd82b8
- Edition-Digest: 46eac64ba2711cd8154fac506aa2083221be7f0509a057c2f0eaab0bc33c22e6
- Source-Revision: sha256:5d9fac621d4eb098b31be9ae2758612bab42ce262e90628f5866b3d7ef7f90b9

## 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.

```bash
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.

```text
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.

```bash
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.

```json
{
  "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.

```text
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.

```text
### 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.

## Gemini CLI

OAuth client: merge this XMemo block into settings.json, set one stable XMEMO_AGENT_INSTANCE_ID for local attribution, then restart Gemini CLI and complete MCP OAuth. Do not add Authorization or XMEMO_KEY to this snippet.

```
{
  "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}"
      }
    }
  }
}
```