Descripción general de MCP

Conectar XMemo a su entorno de IA

XMemo ofrece memoria de proyecto duradera para Claude, ChatGPT, Codex, GitHub Copilot, OpenClaw, Hermes, DeepSeek Harness, Microsoft Agent Framework y entornos abiertos de ejecución de agentes de IA. Los clientes se conectan directamente al endpoint HTTP Streamable alojado o mediante el proxy stdio de primera parte xmemo-mcp incluido en @xmemo/client.

• Claude en claude.ai y Claude Desktop (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration; Directory listing pending): Conector personalizado en https://xmemo.dev/mcp con OAuth; sin API key en el conector (/docs/mcp/claude).
• Claude (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Flujos de trabajo de memoria, puntos de control del ciclo de vida y continuidad entre agentes para Claude Code y 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): Flujos de trabajo de memoria y espacios de trabajo interactivos (TODO Board, Ledger, Project Workspace) (/docs/mcp/chatgpt).
• Codex (Axis A: Config supported; Evidence required · Axis B: Manual MCP Configuration): Memoria de proyecto guiada por Skill y autorización MCP (/docs/mcp/codex).
• OpenClaw (Axis A: Released; Pilot tested · Axis B: Official Marketplace, Native Integration): Guía de habilidades orientada a Recall junto con un complemento de memoria nativo de OpenClaw en ClawHub (/docs/connect/openclaw).
• Hermes (Axis A: Released; Pilot tested · Axis B: Native Integration): Complemento de memoria nativo de Hermes (hermes-xmemo) en PyPI con puntos de control de sesión y captura automática (/docs/connect/hermes).
• DeepSeek Harness (Axis A: Released; Pilot tested · Axis B: Native Integration): Complemento nativo de arnés de agentes dsh (dsh-xmemo) en npm para la memoria del bucle de ejecución de la CLI (/docs/connect/deepseek-harness).
• Microsoft Agent Framework (Axis A: Planned; publicación del paquete pendiente · Axis B: Native Integration): Integración comunitaria independiente para recuperar contexto en Python y captura opcional; no es un producto ni una distribución oficial 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): Integración de MCP para agentes de IDE y CLI (/docs/mcp/copilot).
• Gemini CLI (Axis A: Config supported; Evidence required for current client proof · Axis B: Manual MCP Configuration): Configuración prioritaria con OAuth sin colocar credenciales Bearer en settings.json.

Dos ejes de entrega ortogonales: disponibilidad y modo de distribución

Las integraciones de clientes se clasifican a lo largo de dos ejes independientes: Axis A representa la preparación empírica y el estado de disponibilidad (Released, Pilot / Entitled, o Planned), mientras que Axis B define el modo de integración y distribución (Official Marketplace, Community Directory, Native Integration o Manual MCP Configuration). El canal de entrega no determina la disponibilidad, y las características de la hoja de ruta se distinguen estrictamente de los entornos de ejecución en producción.

• Axis A (Availability / Evidence Status): Released (completamente operativo en producción), Pilot / Entitled (se requiere piloto beta alojado o derecho comercial), Planned (elementos de la hoja de ruta que requieren divulgación prospectiva explícita).
• Axis B (Integration / Distribution Mode): Official Marketplace (listados revisados por el proveedor, como la skill oficial de ClawHub), Community Directory (listados de índices de terceros), Native Integration (soporte de tiempo de ejecución integrado), Manual MCP Configuration (fragmentos JSON configurados por el usuario).

Cuatro rutas de conexión unificadas

Elija la ruta de conexión que coincida con la arquitectura de su cliente y su modelo operativo:

• Ruta 1 (Pida a su agente — Skill independiente): Para agentes compatibles (Claude Code, Codex). Instala el Skill verificado en el directorio de skills del cliente mediante https://xmemo.dev/skill/install.
• Ruta 2 (MCP alojado sobre OAuth): Para clientes de escritorio y alojados (ChatGPT, conector personalizado de Claude en claude.ai y Claude Desktop, Cursor, VS Code Copilot). Conecta https://xmemo.dev/mcp sin gestión manual de tokens.
• Ruta 3 (MCP directo con XMEMO_KEY): Para ejecutores headless y entornos de CI. Pasa tokens Bearer de forma segura a través de variables de entorno locales mediante Streamable HTTP.
• Ruta 4 (Proxy stdio de origen — xmemo-mcp): Para clientes de escritorio que solo admiten stdio, configuraciones de Claude Desktop que no usan el conector personalizado o herramientas que carecen de soporte directo para Streamable HTTP. El paquete CLI oficial @xmemo/client proporciona xmemo-mcp (ejecutable mediante npx -y -p @xmemo/client xmemo-mcp o xmemo mcp serve) como un proxy stdio local independiente que sirve de puente al servicio alojado (https://xmemo.dev).

Configuración del cliente OAuth

La URL alojada es toda la configuración; la concesión proporciona los ámbitos.

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

Configuración con token directo

Los ejecutores headless que no pueden completar OAuth leen el token del entorno en su lugar.

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

Configuración del proxy stdio de origen (xmemo-mcp)

Para Claude Desktop, empiece con el conector personalizado y OAuth (/docs/mcp/claude); esta configuración con API key es la alternativa. Para clientes que solo admiten stdio, el paquete CLI oficial @xmemo/client incluye xmemo-mcp como un proxy stdio local independiente que se conecta a https://xmemo.dev. Pegue su API key real; Claude Desktop no expande 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"
      }
    }
  }
}

Superficies de herramientas calificadas por perfil

Las herramientas disponibles están calificadas por perfil según las capacidades del cliente en config/mcp-documentation-contract.json:

• Perfil de Cursor (cursor-plugin): proporciona herramientas para resolución de conflictos, instantáneas y Cloud Skills.
• Perfil de ChatGPT (chatgpt-public): proporciona herramientas para espacios de trabajo interactivos (TODO Board, Ledger, Project Workspace).
• Perfil público de Claude (claude-public): proporciona herramientas para memoria de proyectos, resúmenes de libros de contabilidad y recuperación activa.
• Perfil de complemento de Claude (claude-plugin): proporciona herramientas para instantáneas, registros de decisiones y continuidad de proyectos.
• Perfil público genérico (generic-public): proporciona herramientas para clientes MCP estándar.

Integraciones candidatas y distribución no verificada

XMemo realiza un seguimiento de las integraciones de clientes emergentes y las extensiones de editor a través de evidencia verificada. Las siguientes rutas candidatas siguen sin verificarse o pendientes de revisión por parte de los mantenedores; no se reclama disponibilidad en el mercado ni respaldo oficial:

• Extensión nativa de VS Code (xmemo-vscode): El repositorio de origen (yonro/xmemo-vscode @ bf08e7c237, v0.1.1) y los flujos de trabajo de CI existen, pero la publicación en Visual Studio Marketplace no está confirmada y Open VSX devolvió 404. Los usuarios deben conectar VS Code a través de la configuración verificada de MCP alojado o Copilot Chat (/docs/mcp/copilot) en lugar de paquetes de extensiones no verificados.
• Cindy Ghost Plugin (xmemo-cindy-plugin): El candidato a complemento Ghost (yonro/xmemo-cindy-plugin @ 0cbbac5a53, v1.0.0) permanece pendiente de revisión por parte de los mantenedores, sin que se hayan observado GitHub Releases públicas ni canales de distribución verificados.
• Shared Skills Package (@xmemo/skills): Aunque existe el código fuente en el repositorio, la búsqueda pública en npm devolvió 404; use en su lugar el Skill independiente verificado (@xmemo/skill).

Deje que un runner se configure

Un ejecutor autónomo puede obtener su propio ajuste preestablecido en lugar de pedirle a un humano que introduzca valores de identidad.

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