MCP-Übersicht

XMemo mit Ihrer KI-Umgebung verbinden

XMemo bietet dauerhaften Projektspeicher über Claude, ChatGPT, Codex, GitHub Copilot, OpenClaw, Hermes, DeepSeek Harness, Microsoft Agent Framework und offene KI-Agenten-Laufzeitumgebungen hinweg. Clients verbinden sich direkt mit dem gehosteten Streamable-HTTP-Endpunkt oder über den im Paket @xmemo/client enthaltenen Erstanbieter-stdio-Proxy xmemo-mcp.

• Claude auf claude.ai und Claude Desktop (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration; Directory listing pending): Benutzerdefinierter Connector mit https://xmemo.dev/mcp und OAuth; kein API-Schlüssel im Connector (/docs/mcp/claude).
• Claude (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Speicher-Workflows, Lebenszyklus-Checkpoints und agentenübergreifende Kontinuität für Claude Code und Cowork (/docs/mcp/claude-code).
• ChatGPT (Axis A: Hosted beta pilot; Evidence required for any refreshed external claim · Axis B: Manual MCP Configuration; Marketplace pending): Speicher-Workflows und interaktive Arbeitsbereiche (TODO Board, Ledger, Project Workspace) (/docs/mcp/chatgpt).
• Codex (Axis A: Config supported; Evidence required · Axis B: Manual MCP Configuration): Skill-gestützter Projektspeicher und MCP-Autorisierung (/docs/mcp/codex).
• OpenClaw (Axis A: Released; Pilot tested · Axis B: Official Marketplace, Native Integration): Recall-first Skill-Anleitung plus ein natives OpenClaw-Speicher-Plugin auf ClawHub (/docs/connect/openclaw).
• Hermes (Axis A: Released; Pilot tested · Axis B: Native Integration): Natives Hermes-Speicher-Plugin (hermes-xmemo) auf PyPI mit Sitzungs-Checkpointing und automatischer Erfassung (/docs/connect/hermes).
• DeepSeek Harness (Axis A: Released; Pilot tested · Axis B: Native Integration): Natives dsh-Agent-Harness-Plugin (dsh-xmemo) auf npm für den Speicher der CLI-Ausführungsschleife (/docs/connect/deepseek-harness).
• Microsoft Agent Framework (Achse A: Geplant; Paketveröffentlichung ausstehend · Achse B: native Integration): Unabhängige Community-Integration zum Abruf von Python-Kontext und für die optionale Erfassung; kein offizielles Microsoft-Produkt und keine offizielle Distribution (/docs/connect/microsoft-agent-framework).
• GitHub Copilot & VS Code (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): MCP-Integration für IDE- und CLI-Agenten (/docs/mcp/copilot).
• Gemini CLI (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): OAuth-first-Konfiguration, ohne Bearer-Anmeldeinformationen in settings.json abzulegen.

Zwei orthogonale Bereitstellungsachsen: Verfügbarkeit und Verteilungsmodus

Client-Integrationen werden entlang zweier unabhängiger Achsen klassifiziert: Axis A repräsentiert die empirische Bereitschaft und den Verfügbarkeitsstatus (Released, Pilot / Entitled, oder Planned), während Axis B den Integrations- und Verteilungsmodus definiert (Official Marketplace, Community Directory, Native Integration oder Manual MCP Configuration). Der Bereitstellungskanal bestimmt nicht die Verfügbarkeit, und Roadmap-Funktionen bleiben streng von Produktionslaufzeiten unterschieden.

• Axis A (Availability / Evidence Status): Released (voll einsatzfähig in der Produktion), Pilot / Entitled (gehosteter Beta-Pilot oder kommerzielle Berechtigung erforderlich), Planned (Roadmap-Punkte, die eine explizite zukunftsorientierte Offenlegung erfordern).
• Axis B (Integration / Distribution Mode): Official Marketplace (vom Anbieter überprüfte Einträge wie der offizielle ClawHub-Skill), Community Directory (Indexeinträge von Drittanbietern), Native Integration (eingebettete Laufzeitunterstützung), Manual MCP Configuration (vom Benutzer konfigurierte JSON-Snippets).

Vier einheitliche Verbindungspfade

Wählen Sie den Verbindungspfad, der zu Ihrer Client-Architektur und Ihrem Betriebsmodell passt:

• Pfad 1 (Bitten Sie Ihren Agenten — Eigenständiger Skill): Für kompatible Agenten (Claude Code, Codex). Installiert den verifizierten Skill über https://xmemo.dev/skill/install im Skills-Verzeichnis des Clients.
• Pfad 2 (Gehostetes MCP über OAuth): Für Desktop- und gehostete Clients (ChatGPT, benutzerdefinierter Claude-Connector auf claude.ai und in Claude Desktop, Cursor, VS Code Copilot). Verbindet https://xmemo.dev/mcp ohne manuelle Token-Verwaltung.
• Pfad 3 (Direktes MCP mit XMEMO_KEY): Für Headless Runner und CI-Umgebungen. Übergibt Bearer-Token sicher über lokale Umgebungsvariablen mittels Streamable HTTP.
• Pfad 4 (Erstanbieter-stdio-Proxy — xmemo-mcp): Für reine stdio-Desktop-Clients, Claude-Desktop-Setups ohne benutzerdefinierten Connector oder Tools ohne direkte Streamable HTTP-Unterstützung. Das offizielle @xmemo/client-CLI-Paket bietet xmemo-mcp (ausführbar über npx -y -p @xmemo/client xmemo-mcp oder xmemo mcp serve) als in sich geschlossenen lokalen stdio-Proxy, der eine Verbindung zum gehosteten Dienst herstellt (https://xmemo.dev).

OAuth-Client-Konfiguration

Die gehostete URL ist die gesamte Konfiguration; der Grant liefert die Scopes.

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

Konfiguration mit direktem Token

Headless Runner, die OAuth nicht abschließen können, lesen das Token stattdessen aus der Umgebung.

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "transport": "streamable-http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "${XMEMO_AGENT_ID}",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Erstanbieter-stdio-Proxy-Konfiguration (xmemo-mcp)

Beginnen Sie in Claude Desktop mit dem benutzerdefinierten Connector und OAuth (/docs/mcp/claude); diese Konfiguration mit API-Schlüssel ist die Alternative. Für reine stdio-Clients liefert das offizielle @xmemo/client-CLI-Paket xmemo-mcp als eigenständigen lokalen stdio-Proxy, der eine Verbindung zu https://xmemo.dev herstellt. Fügen Sie Ihren tatsächlichen API-Schlüssel ein; Claude Desktop expandiert keine ${env:...}-Variablen:

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "@xmemo/client",
        "xmemo-mcp"
      ],
      "env": {
        "XMEMO_KEY": "<your-xmemo-api-key>",
        "XMEMO_URL": "https://xmemo.dev"
      }
    }
  }
}

Profilqualifizierte Tool-Oberflächen

Verfügbare Tools sind gemäß den Client-Funktionen in config/mcp-documentation-contract.json profilqualifiziert:

• Cursor-Profil (cursor-plugin): Bietet Tools für Konfliktlösung, Snapshots und Cloud Skills.
• ChatGPT-Profil (chatgpt-public): Bietet Tools für interaktive Arbeitsbereiche (TODO Board, Ledger, Project Workspace).
• Claude-Öffentlichkeitsprofil (claude-public): Bietet Tools für Projektspeicher, Ledger-Zusammenfassungen und aktiven Abruf.
• Claude-Plugin-Profil (claude-plugin): Bietet Tools für Snapshots, Entscheidungsaufzeichnungen und Projektkontinuität.
• Generisches öffentliches Profil (generic-public): Bietet Tools für Standard-MCP-Clients.

Kandidaten-Integrationen und unbestätigte Verteilung

XMemo verfolgt neue Client-Integrationen und Editor-Erweiterungen anhand verifizierter Nachweise. Die folgenden Kandidatenpfade bleiben unbestätigt oder stehen noch zur Überprüfung durch die Maintainer aus; es wird keine Marktplatzverfügbarkeit oder offizielle Unterstützung beansprucht:

• VS Code Native Extension (xmemo-vscode): Quell-Repository (yonro/xmemo-vscode @ bf08e7c237, v0.1.1) und CI-Workflows existieren, aber die Veröffentlichung im Visual Studio Marketplace ist unbestätigt und Open VSX lieferte 404. Benutzer sollten VS Code über das verifizierte gehostete MCP oder die Copilot Chat-Konfiguration (/docs/mcp/copilot) anbinden, anstatt unbestätigte Erweiterungspakete zu verwenden.
• Cindy Ghost Plugin (xmemo-cindy-plugin): Der Ghost-Plugin-Kandidat (yonro/xmemo-cindy-plugin @ 0cbbac5a53, v1.0.0) steht noch zur Überprüfung durch die Maintainer aus; es wurden keine öffentlichen GitHub Releases oder verifizierten Vertriebskanäle beobachtet.
• Shared Skills Package (@xmemo/skills): Obwohl der Quellcode im Repository existiert, lieferte die öffentliche npm-Abfrage 404; verwenden Sie stattdessen den verifizierten eigenständigen Skill (@xmemo/skill).

Einen Runner sich selbst konfigurieren lassen

Ein autonomer Runner kann sein eigenes Preset abrufen, anstatt einen Menschen um Identitätswerte bitten zu müssen.

curl -s https://xmemo.dev/api/v1/mcp/config/autonomous-agent