VerbindenVerbindenClaude (claude.ai)

MCP Client

Claude (claude.ai)

Verbinden Sie Claude auf claude.ai als benutzerdefinierten Connector mit dem gehosteten Streamable-HTTP-MCP-Endpunkt, mit OAuth und den Scopes memory:read und memory:write.

Voraussetzung

Verwenden Sie Claude mit Unterstützung für benutzerdefinierte Connectoren und ein gültiges XMemo-Konto. Verbindungsdaten:

  • Oberfläche: Claude im Web (claude.ai), verbunden über einen benutzerdefinierten Connector.
  • Verbindungs-URL: https://xmemo.dev/mcp.
  • Transport: Streamable HTTP (streamable-http).
  • Authentifizierungsmodus: OAuth 2.0 Authorization Code mit PKCE und Dynamic Client Registration (dynamische Client-Registrierung).
  • Scopes: memory:read und memory:write.
  • Konto: Gültiges XMemo-Konto unter https://xmemo.dev.

XMemo als benutzerdefinierten Connector hinzufügen

Fügen Sie den gehosteten MCP-Server in Claude hinzu. Die Verbindungs-URL ist die einzige Servereinstellung:

  • 1. Öffnen Sie in Claude Customize > Connectors und wählen Sie Add custom connector. Direktlink: https://claude.ai/customize/connectors?modal=add-custom-connector.
  • 2. Name: XMemo.
  • 3. URL des Remote-MCP-Servers: https://xmemo.dev/mcp.
  • 4. Fügen Sie den Connector hinzu und klicken Sie dann auf Connect, um OAuth zu starten.

Zugriff mit OAuth genehmigen

Claude registriert sich über Dynamic Client Registration als OAuth-Client und öffnet die XMemo-Autorisierungsseite in Ihrem Browser. Melden Sie sich an und genehmigen Sie memory:read und memory:write bei der Zustimmung. Claude erhält seine Anmeldedaten aus dieser OAuth-Berechtigung.

Kein Bearer-Token hinzufügen

Der benutzerdefinierte Connector benötigt keinen API-Schlüssel. Tragen Sie keinen XMemo-API-Schlüssel, kein XMEMO_KEY und kein Bearer-Token in den Connector ein; die OAuth-Berechtigung liefert die Anmeldedaten und ihre Scopes.

XMemo in einer Unterhaltung aktivieren

Kehren Sie zu Claude zurück und aktivieren Sie XMemo für die Unterhaltung. Claude erkennt dann die XMemo-Tools mit ihren Titeln und Sicherheitsannotationen.

Mit einem echten recall-Aufruf testen

Gestalten Sie den ersten Aufruf schreibgeschützt. Dies ist ein echter recall-Aufruf, kein Platzhalter für eine Zustandsprüfung, und er schreibt keinen Speicher.

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

Erwartete Antwort (wörtliche Form)

Ein erfolgreicher Aufruf gibt die unten gezeigte öffentliche, gerankte 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>

In Claude verfügbare Tools

Im Profil claude-public sieht Claude 27 Tools. Sie sind unten nach Sicherheitsannotation gruppiert: Lese-Tools ändern niemals Daten, Schreib-Tools fügen Datensätze hinzu, schließen sie ab oder stellen sie wieder her, und destruktive Tools können bestehende Datensätze überschreiben, ändern oder löschen. Tools mit eigener Referenzseite sind verlinkt; die übrigen werden nur auf dieser Seite beschrieben.

Lese-Tools

Schreibgeschützt und idempotent; diese Tools ändern keine gespeicherten Daten:

  • get_mcp_identity (Check XMemo connection): gibt die authentifizierte Connector-Identität und die gewährten Speicher-Scopes zurück.
  • [search_memory](/docs/tools/search) (Search XMemo memories): durchsucht sichtbare bereichsbezogene oder Team-Speichereinträge.
  • [recall](/docs/tools/recall) (Recall XMemo memory): ruft die relevantesten sichtbaren Erinnerungen ab.
  • [recall_context](/docs/tools/recall-context) (Build XMemo context): erstellt aus sichtbaren Erinnerungen ein begrenztes Kontextpaket.
  • memory_overview (Show XMemo memory overview): fasst sichtbare Erinnerungen und die jüngste Aktivität zusammen.
  • memory_stats (Show XMemo memory statistics): gibt aggregierte Statistiken über sichtbare Erinnerungen zurück.
  • memory_activity (Show XMemo memory activity): zeigt eine sichere Zeitleiste Ihrer eigenen Speicheränderungen, ohne rohe Audit-Logs offenzulegen.
  • analyze_memory_text (Analyze XMemo memory text): zählt ein Wort oder eine exakte Phrase in sichtbaren Erinnerungen.
  • explain_memory (Explain XMemo memory): erklärt, warum eine sichtbare Erinnerung existiert oder zu einer Anfrage gepasst hat.
  • list_memory_todos (List XMemo memory TODOs): listet speicherbasierte TODOs und Aktionspunkte auf; so liest Claude TODOs.
  • list_ledger_transactions (List XMemo Ledger transactions): listet sichtbare Ledger-Einträge auf.
  • get_monthly_ledger_summary (Summarize XMemo Ledger by month): fasst sichtbare Ledger-Einträge nach Monat zusammen.
  • read_memory (Read Memory): liest eine begrenzte Seite einer exakten Erinnerung oder eines autorisierten Document über dessen Dokumentreferenz, wie sie recall oder die Suche zurückgibt.
  • get_project_context (Get project context): liest den autorisierten Kontext eines Projekts, das Ihnen gehört oder auf das Sie zugreifen können.

Schreib-Tools

Diese Tools fügen Datensätze hinzu, schließen sie ab oder stellen sie wieder her und sind nicht als destruktiv markiert:

  • add_expense (Record an XMemo Ledger transaction): erstellt einen strukturierten Ledger-Eintrag.
  • complete_memory_todo (Complete XMemo memory TODO): markiert ein bestehendes speicherbasiertes TODO oder einen Aktionspunkt als erledigt.
  • create_memory_todo (Create XMemo memory TODO): erstellt ein speicherbasiertes TODO oder einen Aktionspunkt.
  • [remember](/docs/tools/remember) (Remember in XMemo): erstellt eine bereichsbezogene Erinnerung oder dedupliziert sie.
  • restore_memory (Restore XMemo memory): stellt einen Datensatz wieder her, den forget im standardmäßigen Soft-Delete-Modus entfernt hat.
  • record_event (Record a milestone): hängt ein Meilenstein- oder Übergabeereignis an; bestehende Datensätze werden nie bearbeitet oder gelöscht.
  • create_pending_decision (Save a pending decision): speichert eine offene Entscheidung mit Kontext und Optionen zur späteren Prüfung.
  • resolve_decision (Resolve a pending decision): erfasst das gewählte Ergebnis für eine genau bestimmte offene Entscheidung und schließt sie, wobei ihr Verlauf erhalten bleibt.

Destruktive Tools

Diese Tools sind als destruktiv markiert, weil sie bestehende Datensätze überschreiben, ändern oder löschen können:

  • [forget](/docs/tools/forget) (Forget XMemo memory, TODO, or Ledger transaction): löscht eine ausgewählte Erinnerung, ein TODO oder einen Ledger-Eintrag; siehe Löschen und Wiederherstellen unten.
  • update_memory (Update XMemo memory): überschreibt Felder einer ausgewählten Erinnerung anhand der exakten Referenz.
  • update_state (Save working state): speichert oder ersetzt einen benannten Checkpoint des Arbeitsstands, damit eine spätere Unterhaltung ihn fortsetzen kann.
  • [todo](/docs/tools/todos) (Manage XMemo TODOs): erstellt, aktualisiert oder erledigt Ihre eigenen TODOs; siehe TODOs in Claude unten.
  • project (Manage XMemo project): erstellt ein Projekt oder ändert Erinnerungen, Entscheidungen, Dokument- und Unterhaltungsverknüpfungen oder Einstellungen eines autorisierten Projekts.

Löschen und Wiederherstellen

Das Löschen über forget ist wiederherstellbar, sofern Sie nicht ausdrücklich eine endgültige Löschung verlangen:

  • Standard: forget führt eine wiederherstellbare Soft-Löschung durch.
  • Rückgängig: restore_memory stellt einen per Soft-Löschung entfernten Datensatz wieder her.
  • Endgültig: forget mit mode='hard' ist endgültig und nicht wiederherstellbar. Es erfordert Ihre ausdrückliche Bestätigung, und ein endgültig gelöschter Datensatz kann nicht wiederhergestellt werden.

TODOs in Claude

In Claude erstellt, aktualisiert oder erledigt das todo-Tool nur TODOs. Claude liest TODOs mit list_memory_todos. Die Referenzseite zu todo beschreibt den vollständigen Dispatcher; verwenden Sie ihn in Claude nur für diese drei Aktionen.

Claude Desktop

Beginnen Sie in Claude Desktop mit demselben benutzerdefinierten Connector und OAuth-Ablauf. Eine lokale Konfiguration mit API-Schlüssel bleibt eine Alternative:

  • Empfohlen: Fügen Sie XMemo als benutzerdefinierten Connector mit https://xmemo.dev/mcp hinzu und schließen Sie OAuth ab. Es wird kein API-Schlüssel benötigt.
  • Alternative: Konfigurieren Sie den Erstanbieter-stdio-Proxy xmemo-mcp oder mcp-remote in claude_desktop_config.json mit einem XMemo-API-Schlüssel. Die Konfiguration des stdio-Proxys finden Sie in der [MCP-Übersicht](/docs/mcp/overview).

Claude Code

Claude Code verwendet eine separate Einrichtung. Siehe [Claude Code](/docs/mcp/claude-code) für den eigenständigen Skill und die direkte MCP-Konfiguration.

Häufige Fehler

OAuth-Fehler entsprechen den tatsächlichen Antworten des Token-Endpunkts:

  • invalid_grant — Der Autorisierungscode ist ungültig, abgelaufen oder bereits verwendet: Verbinden Sie XMemo in Claude erneut und autorisieren Sie es noch einmal.
  • invalid_target — Die OAuth-Ressource stimmt nicht mit diesem MCP-Server überein: Entfernen Sie den Connector und fügen Sie ihn mit https://xmemo.dev/mcp erneut hinzu.
  • 403 insufficient_scope — Die Berechtigung enthält memory:read oder memory:write nicht: Genehmigen Sie beide Scopes und verbinden Sie sich erneut.

Aktualisierung und Entfernung

Wartungsabläufe für den Claude-Connector:

  • Erneut verbinden: Wenn Claude für XMemo eine Autorisierungs- oder Neuverbindungsmeldung anzeigt, verbinden Sie den Connector erneut und schließen Sie OAuth noch einmal ab.
  • Entfernung: Entfernen Sie den benutzerdefinierten XMemo-Connector in den Connector-Einstellungen von Claude.

Quelle: Client-Fähigkeitsmatrix