# ChatGPT

Verbinden Sie ChatGPT über gehostetes Streamable HTTP MCP und Browser-OAuth mit den Bereichen memory:read und memory:write.

- Canonical: https://docs.xmemo.dev/de/docs/mcp/chatgpt
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 0a34bc1a4a60d47cc1fcab5b55616f0d81c50ddc2815030f687094efa4fdc4a5
- Edition-Digest: bdd437ed6266b2567f12398d8040ab6831548c8d126a52cd20ab951bcfb3ae1b
- Source-Revision: sha256:9bc37480fb26a371846f25bf5ea25d86ddd8bd3808e3df34131ef15403069090

## Voraussetzungen

Verwenden Sie eine OpenAI-App-Konfiguration, die einen Remote-MCP-Server und den gehosteten Streamable HTTP-Endpunkt unterstützt. Laufzeiten und Voraussetzungen:

- Konkrete Schnittstelle: ChatGPT-Web- und Desktop-Client (OpenAI Apps / Actions).
- Endpunkt: https://xmemo.dev/mcp.
- Transport: Streamable HTTP (streamable-http).
- Authentifizierungsmodus: OAuth mit den Bereichen memory:read und memory:write.
- Konto: Gültiges XMemo-Konto unter https://xmemo.dev.

## Installation / Einrichtung

Registrieren Sie im ChatGPT-Client oder im Dashboard der OpenAI-Plattform die gehostete MCP-URL und die OAuth-Metadaten für die Remote-Verbindung:

- Konfigurieren Sie die gehostete MCP-URL im App-Dashboard: https://xmemo.dev/mcp.
- Fordern Sie bei der Zustimmung memory:read und memory:write an.
- Fügen Sie dem App-Listing kein Bearer-Token hinzu.

## Anmeldedaten festlegen

Kein Schlüssel — schließen Sie Browser-OAuth ab. ChatGPT erhält die Anmeldedaten über den OAuth-Grant; setzen Sie kein XMEMO_KEY und fügen Sie keinen Authorization-Header hinzu:

```text
No XMEMO_KEY
Complete browser OAuth in ChatGPT
```

## XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Der geprüfte ChatGPT-OAuth-Eintrag hat keinen clientseitigen Identitäts-Header. Erfinden oder fügen Sie kein XMEMO_AGENT_INSTANCE_ID in die App-Konfiguration ein; bestätigen Sie, dass die Zuordnung über den OAuth-Grant für diesen Client-Pfad verwaltet wird.

## Bestehenden Konfigurationsblock beibehalten

Verwenden Sie den geprüften ChatGPT-Konfigurationsblock. Behalten Sie dessen gehostete URL, den OAuth-Modus und die angeforderten Bereiche bei; ändern Sie nur lokale Dashboard-Werte, die der Client benötigt:

```json
{
  "servers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}
```

## Client neu starten

Speichern Sie die App-Konfiguration, schließen Sie veraltete MCP-Verbindungen und öffnen Sie die ChatGPT-App oder Unterhaltung erneut, damit die aktuellen OAuth-Metadaten geladen werden.

## Mit einem echten Recall-Aufruf testen

Führen Sie den ersten MCP-Aufruf schreibgeschützt 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 Form)

Ein erfolgreicher Aufruf gibt die unten stehende öffentliche bewertete 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>
```

## Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus

Führen Sie die vollständige synthetische Speicheraufgabe in ChatGPT aus:

- 1. Synthetischen Fakt speichern: Bitten Sie ChatGPT, remember mit dem Inhalt "Demo project timestamps use UTC." und dem Pfad "projects/demo-onboarding/conventions" aufzurufen.
- 2. Zustandsloser Übergang: Öffnen Sie einen völlig neuen Chat-Thread in ChatGPT, um sicherzustellen, dass kein Speicher aus der Unterhaltung übernommen wird.
- 3. Recall mit Quellenzuordnung: Bitten Sie ChatGPT, "demo project timestamp format" abzurufen. Bestätigen Sie die zurückgegebenen Felder Reference und Location.
- 4. Speicher korrigieren: Bitten Sie ChatGPT, update_memory mit der aktiven ID aufzurufen, um die Konvention auf ISO 8601-Formatierung zu aktualisieren.
- 5. Optionale Bereinigung: Bitten Sie ChatGPT, forget mit der Speicher-ID aufzurufen, wenn der Test abgeschlossen ist.

## Funktionen und Profil-Tools

ChatGPT hat Zugriff auf profilqualifizierte Tools, die im MCP-Dokumentationsvertrag für das Profil chatgpt-public definiert sind:

- Kern-Speicher-Tools: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
- Projekt- und Kontext-Tools: get_mcp_identity, get_project_summary, project, todo, update_state, record_event, restore_memory, analyze_memory_text, memory_overview.
- Interaktive Arbeitsbereiche: open_project_workspace, open_todo_board, open_ledger, ledger.

## Einschränkungen und Grenzen

Betriebliche Grenzen und Einschränkungen für die ChatGPT-Integration:

- Arbeitsbereichsgrenze: Der Speicherzugriff ist strikt auf den Arbeitsbereich des autorisierten Benutzers beschränkt.
- Skill-Unterstützung: ChatGPT führt Tool-Aufrufe remote aus und führt keine eigenständigen lokalen Node.js-Skills aus.
- OAuth-Sitzung: Inaktive OAuth-Sitzungen können regelmäßig ablaufen, was eine erneute Autorisierung im Browser mit einem Klick erfordert.

## Häufige Fehler

ChatGPT-spezifische OAuth-Fehler bilden die echten Token-Endpunkt-Antworten ab:

- invalid_grant — Autorisierungscode ist ungültig, abgelaufen oder wurde bereits verwendet: Verbinden Sie ChatGPT erneut und autorisieren Sie es.
- invalid_target — Die OAuth-Ressource stimmt nicht mit diesem MCP-Server überein: Starten Sie die Verbindung mit https://xmemo.dev/mcp als Ressource neu.
- 403 insufficient_scope — Die Autorisierung umfasst weder memory:read noch memory:write: Genehmigen Sie den angeforderten Bereich und verbinden Sie sich erneut.

## Aktualisierung und Entfernung

Wartungsverfahren für ChatGPT:

- Aktualisierung: Aktualisieren Sie den ChatGPT-Client oder authentifizieren Sie sich erneut, um die Tool-Definitionen zu aktualisieren.
- Entfernung: Entfernen Sie die XMemo-Verbindung unter ChatGPT Settings -> Connected Accounts / MCP.

## ChatGPT / OpenAI Apps SDK

OAuth marketplace lane: configure the hosted MCP URL and OAuth metadata in the OpenAI app dashboard; never paste XMEMO_KEY or Bearer tokens into the listing.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "transport": "streamable-http",
      "auth": {
        "type": "oauth2",
        "resource": "https://xmemo.dev/mcp",
        "scopes": ["memory:read", "memory:write"]
      }
    }
  }
}
```