Aperçu de MCP

Connecter XMemo à votre environnement d'IA

XMemo fournit une mémoire de projet durable pour Claude, ChatGPT, Codex, GitHub Copilot, OpenClaw, Hermes, DeepSeek Harness, Microsoft Agent Framework et les environnements d’exécution d’agents IA ouverts. Les clients se connectent directement au point de terminaison HTTP Streamable hébergé ou au proxy stdio de première partie xmemo-mcp fourni avec @xmemo/client.

• Claude sur claude.ai et Claude Desktop (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration; Directory listing pending) : Connecteur personnalisé vers https://xmemo.dev/mcp avec OAuth ; aucune clé API dans le connecteur (/docs/mcp/claude).
• Claude (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration) : Flux de travail de mémoire, points de contrôle du cycle de vie et continuité multi-agents pour Claude Code et 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) : Flux de travail de mémoire et espaces de travail interactifs (TODO Board, Ledger, Project Workspace) (/docs/mcp/chatgpt).
• Codex (Axis A: Config supported; Evidence required · Axis B: Manual MCP Configuration) : Mémoire de projet guidée par Skill et autorisation MCP (/docs/mcp/codex).
• OpenClaw (Axis A: Released; Pilot tested · Axis B: Official Marketplace, Native Integration) : Conseils de compétences orientés Recall et plugin de mémoire OpenClaw natif sur ClawHub (/docs/connect/openclaw).
• Hermes (Axis A: Released; Pilot tested · Axis B: Native Integration) : Plugin de mémoire Hermes natif (hermes-xmemo) sur PyPI avec points de contrôle de session et capture automatique (/docs/connect/hermes).
• DeepSeek Harness (Axis A: Released; Pilot tested · Axis B: Native Integration) : Plugin de harnais d'agent dsh natif (dsh-xmemo) sur npm pour la mémoire de boucle d'exécution CLI (/docs/connect/deepseek-harness).
• Microsoft Agent Framework (Axe A : Planifié ; publication du package en attente · Axe B : intégration native) : intégration communautaire indépendante pour la récupération de contexte en Python et la capture facultative ; il ne s’agit ni d’un produit ni d’une distribution officielle de Microsoft (/docs/connect/microsoft-agent-framework).
• GitHub Copilot & VS Code (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration) : Intégration MCP pour les agents IDE et CLI (/docs/mcp/copilot).
• Gemini CLI (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration) : Configuration OAuth prioritaire sans placer d'informations d'identification Bearer dans settings.json.

Deux axes de diffusion orthogonaux : disponibilité et mode de distribution

Les intégrations clientes sont classées selon deux axes indépendants : Axis A représente la maturité empirique et le statut de disponibilité (Released, Pilot / Entitled, ou Planned), tandis que Axis B définit le mode d'intégration et de distribution (Official Marketplace, Community Directory, Native Integration ou Manual MCP Configuration). Le canal de diffusion ne détermine pas la disponibilité, et les fonctionnalités de la feuille de route restent strictement distinguées des environnements d'exécution en production.

• Axis A (Availability / Evidence Status): Released (pleinement opérationnel en production), Pilot / Entitled (pilote bêta hébergé ou droit commercial requis), Planned (éléments de la feuille de route nécessitant une divulgation prospective explicite).
• Axis B (Integration / Distribution Mode): Official Marketplace (fiches examinées par les fournisseurs telles que le skill officiel ClawHub), Community Directory (fiches d'index tiers), Native Integration (support d'exécution intégré), Manual MCP Configuration (extraits JSON configurés par l'utilisateur).

Quatre chemins de connexion unifiés

Choisissez le chemin de connexion correspondant à l'architecture de votre client et à votre modèle opérationnel :

• Chemin 1 (Demandez à votre agent — Skill autonome) : Pour les agents compatibles (Claude Code, Codex). Installe le Skill vérifié dans le répertoire de skills du client via https://xmemo.dev/skill/install.
• Chemin 2 (MCP hébergé sur OAuth) : Pour les clients de bureau et hébergés (ChatGPT, connecteur personnalisé Claude sur claude.ai et Claude Desktop, Cursor, VS Code Copilot). Connecte https://xmemo.dev/mcp sans gestion manuelle des jetons.
• Chemin 3 (MCP direct avec XMEMO_KEY) : Pour les exécuteurs headless et les environnements CI. Transmet les jetons Bearer en toute sécurité via des variables d'environnement locales sur Streamable HTTP.
• Chemin 4 (Proxy stdio propriétaire — xmemo-mcp) : Pour les clients de bureau uniquement en stdio, les configurations de Claude Desktop sans connecteur personnalisé ou les outils dépourvus de support direct pour Streamable HTTP. Le package officiel @xmemo/client fournit xmemo-mcp (exécutable via npx -y -p @xmemo/client xmemo-mcp ou xmemo mcp serve) comme proxy stdio local autonome reliant au service hébergé (https://xmemo.dev).

Configuration du client OAuth

L'URL hébergée constitue l'intégralité de la configuration ; l'autorisation fournit les étendues.

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

Configuration par jeton direct

Les exécuteurs headless qui ne peuvent pas effectuer OAuth lisent le jeton depuis l'environnement à la place.

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

Configuration du proxy stdio propriétaire (xmemo-mcp)

Pour Claude Desktop, commencez par le connecteur personnalisé avec OAuth (/docs/mcp/claude) ; cette configuration par clé API est l'alternative. Pour les clients uniquement en stdio, le package officiel @xmemo/client fournit xmemo-mcp en tant que proxy stdio local autonome se connectant à https://xmemo.dev. Collez votre véritable clé API ; Claude Desktop ne développe pas les variables ${env:...} :

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

Surfaces d'outils qualifiées par profil

Les outils disponibles sont qualifiés par profil en fonction des fonctionnalités du client dans config/mcp-documentation-contract.json :

• Profil Cursor (cursor-plugin) : fournit des outils pour la résolution de conflits, les instantanés et Cloud Skills.
• Profil ChatGPT (chatgpt-public) : fournit des outils pour les espaces de travail interactifs (TODO Board, Ledger, Project Workspace).
• Profil public Claude (claude-public) : fournit des outils pour la mémoire de projet, les résumés de registre et le rappel actif.
• Profil de plugin Claude (claude-plugin) : fournit des outils pour les instantanés, les enregistrements de décision et la continuité de projet.
• Profil public générique (generic-public) : fournit des outils pour les clients MCP standard.

Intégrations candidates et distribution non vérifiée

XMemo suit les intégrations émergentes de clients et les extensions d'éditeur grâce à des preuves vérifiées. Les chemins candidats suivants restent non vérifiés ou en attente de révision par les mainteneurs ; aucune disponibilité sur une place de marché ni approbation officielle n'est revendiquée :

• Extension native VS Code (xmemo-vscode) : Le dépôt source (yonro/xmemo-vscode @ bf08e7c237, v0.1.1) et les workflows CI existent, mais la publication sur le Visual Studio Marketplace n'est pas confirmée et Open VSX a renvoyé 404. Les utilisateurs doivent connecter VS Code via la configuration vérifiée de MCP hébergé ou de Copilot Chat (/docs/mcp/copilot) plutôt que par des packages d'extension non vérifiés.
• Cindy Ghost Plugin (xmemo-cindy-plugin) : Le candidat au plugin Ghost (yonro/xmemo-cindy-plugin @ 0cbbac5a53, v1.0.0) reste en attente de révision par les mainteneurs, sans GitHub Releases publiques ni canal de distribution vérifié observés.
• Shared Skills Package (@xmemo/skills) : Bien que le code source du dépôt existe, la recherche publique npm a renvoyé 404 ; utilisez plutôt le Skill autonome vérifié (@xmemo/skill).

Laisser un exécuteur se configurer lui-même

Un exécuteur autonome peut récupérer son propre préréglage au lieu de demander à un humain de saisir des valeurs d'identité.

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