# 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. - Canonical: https://docs.xmemo.dev/de/docs/mcp/claude - Locale: de-DE - Content-Locale: de-DE - Canonical-Content-Digest: de1a3fce819ac5cc3e4ef555fb6ba57c0ae2af9af5e91367ad4efac64a274ea3 - Edition-Digest: a66139f5267a9967fed2464cb4ff2652d403ab20e539541cc7f572a75c9271d9 - Source-Revision: sha256:ef049dd959bada93a714e560eece53ae72cd3ce2d2ed84bbab43191b9ae93474 ## 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. ```text 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. ```text ### XMemo Memory Results: 1. Reference: | Location: > ``` ## 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.