ChatGPT

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:

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:

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

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.

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