Inicio rápido para XMemo

Utilice XMemo como un hogar de memoria compartida para asistentes de IA: conecte un cliente, guarde contexto útil una vez, recuérdelo más tarde y mantenga las credenciales fuera de la configuración pública.

Introducción #

Un hogar de memoria

Mantenga las preferencias duraderas, los hechos del proyecto, las decisiones y las notas de entrega en una capa de memoria de propiedad del usuario que los asistentes aprobados puedan recordar.

Conecte su cliente

Utilice la URL MCP alojada con el perfil del cliente para los runners de ChatGPT, Claude, VS Code / GitHub Copilot, Copilot CLI, Codex, Gemini, Cursor o MCP directos.

Mantener el control

Utilice OAuth cuando sea compatible, la transferencia de ambiente-secreto para clientes directos, y controles de cuenta para revisar, eliminar y exportar límites.

Persona onboarding flows #

Usuario de ChatGPT

Goal: Dale a ChatGPT acceso duradero a tus preferencias de XMemo, datos de proyecto, decisiones y TODOs sin pegar fichas bearer en un chat.
Connection: Conecte el servidor XMemo MCP alojado a través de la aplicación ChatGPT/OpenAI OAuth flow, luego apruebe la subvención de memoria:read y memoria:write para su cuenta XMemo.
Success action: Guarde una nota de preferencia sintética o de proyecto, inicie un nuevo chat y luego pida a ChatGPT que la recuerde a través de XMemo antes de continuar el trabajo.
Troubleshooting: Si OAuth falla o las herramientas no aparecen, salir del servidor MCP en la aplicación host, volver a conectar la URL del servidor XMemo y volver a probar antes de crear tokens directos.

Copiloto / Codex desarrollador

Goal: Lleve decisiones de repo, convenciones de codificación, notas de corrección de errores e historial de tareas entre los agentes IDE y CLI.
Connection: Use OAuth para VS Code / GitHub Copilot y Gemini CLI cuando esté disponible. Para Copilot CLI, Codex, Cursor u otros clientes MCP directos, mantenga XMEMO_KEY en el entorno local o en el almacén de secretos y establezca un XMEMO_AGENT_INSTANCE_ID estable.
Success action: Grabe una decisión de base de código o corrección de errores, y luego pida al siguiente agente IDE o CLI que recuerde el contexto XMemo relevante antes de editarlo.
Troubleshooting: Si las memorias están vacías, verifique la ruta de configuración MCP seleccionada, la variable de entorno XMEMO_KEY para clientes directos y cualquier credencial OAuth rancio en la aplicación host.

Equipo / propietario del piloto de la empresa

Goal: Evalúe la memoria compartida con controles de cuenta, atribución de origen, flujos de trabajo export/delete y pruebas de configuración seguras para los revisores.
Connection: Cree o introduzca el espacio de trabajo protegido de XMemo, invite a usuarios aprobados, luego conecte a cada cliente a través de OAuth o una credencial directa con alcance de acuerdo con las insignias de preparación.
Success action: Haga que un miembro piloto guarde una memoria sintética del equipo, confirme la atribución de origen en XMemo, luego revise delete/export y las rutas de soporte.
Troubleshooting: Si un miembro no puede conectarse, compruebe los permisos de rol, la aprobación de OAuth, el estado de preparación del cliente y la orientación de soporte antes de emitir un nuevo token.

Operador de agente autónomo

Goal: Deje que los agentes sin cabeza o programados registren el progreso, recuperen decisiones previas y mantengan una identidad estable de instancia no secreta.
Connection: Obtener /api/v1/mcp/config/autonomous-agent. Preferir auth_modes.oauth cuando el runner soporta OAuth + cabeceras personalizadas; utilice auth_modes.xmemo_key con XMEMO_KEY de una tienda secreta sólo para runners totalmente sin cabeza.
Success action: Ejecute una tarea sintética que escriba el progreso a XMemo, reinicie el runner y confirme que recuerda que el progreso usando el mismo XMEMO_AGENT_INSTANCE_ID.
Troubleshooting: Si la atribución cambia o recuerda dividida entre instancias, persistir XMEMO_AGENT_INSTANCE_ID fuera de git y verificar que el runner no lo esté regenerando en cada inicio.

Controles de la consola de memoria #

XMemo no es sólo un punto final MCP. La Consola de memoria es el lugar orientado al usuario para revisar, corregir, eliminar y exportar la memoria mientras mantiene la atribución de agente visible.

Memoria de vista y búsqueda

Abra la consola para ver las memorias guardadas, inspeccione las rutas y los tipos de memoria, y confirme si una memoria debería haber devuelto un elemento específico.

Editar o corregir entradas

Corrija los hechos rancios, mueva los elementos a rutas más claras o reemplace las notas obsoletas para que los futuros asistentes recuerden el último contexto aprobado por el usuario.

Suprimir y exportar

Utilice los flujos de trabajo de la cuenta para eliminar memorias que ya no desea y para localizar rutas de exportación para la revisión de la memoria con alcance de cuenta.

Atribución del agente

Revise qué cliente o runner escribió una memoria, incluyendo el agente no secreto y las etiquetas de instancia cuando el cliente los envía.

Controles de privacidad y credenciales

Mantenga visible el consentimiento de OAuth, el uso directo, la transferencia del entorno secreto y los límites de soporte antes de expandir un piloto personal o de equipo.

Solicitud de acceso XMemo #

Abrir entrada de cuenta ↗

Guía rápida de XMemo alojado #

Comience con el servicio XMemo administrado y una de estas rutas de conexión. Auto-acogida, Docker, Supabase y Python configuración de paquetes son referencias de desarrolladores, no la primera ruta para usuarios alojados.

Pregunte a su agente

Pegue esto en un agente de confianza para seguir sus controles de seguridad normales.

Instale la habilidad XMemo independiente en su directorio de habilidades: ejecute el instalador desde https://xmemo.dev/skill/install (en Windows, https://xmemo.dev/skill/install.ps1) con XMEMO_SKILL_DIR configurado en su directorio de habilidades más /xmemo-memory. Ejecute el comando doctor que imprime para verificar la instalación, luego recargue sus habilidades y siga los pasos de primera ejecución de la habilidad. Siga sus controles de seguridad habituales y no utilice privilegios elevados.

Clientes de OAuth

Use esta ruta para ChatGPT, OpenAI app review, VS Code, y GitHub Copilot cuando el host soporte OAuth. Añada la URL MCP alojada, apruebe memoria:read y memoria:write, y no pegue XMEMO_KEY en la configuración del cliente.

MCP URL: https://xmemo.dev/mcp
Scopes: memory:read memory:write

MCP directo con XMEMO_KEY

Utilice esta ruta solo para clientes o runners sin cabeza que no puedan completar OAuth. Almacene XMEMO_KEY en el entorno local o en la tienda secreta, mantenga la URL MCP alojada en configuración y nunca pegue el token real en documentos públicos o chat.

MCP URL: https://xmemo.dev/mcp
Token source: XMEMO_KEY environment variable
Optional identity: XMEMO_AGENT_INSTANCE_ID

Controles de cuentas

Después de la primera conexión, utilice la entrada de la cuenta para revisar lo que se guardó, comprobar la atribución del agente y encontrar delete/export o rutas de soporte antes de expandir un piloto.

Account entry: https://xmemo.dev/login

Seguridad pública #

El descubrimiento público es de sólo lectura y sin secretos.
Client setup requires secrets in environment variables or a system secret store, not in generated URLs.
Documentos de productos públicos evitan intencionalmente enlaces a consolas de operadores, documentos API, descubrimiento JSON, catálogos de instaladores, URLs de arranque en bruto, URLs de servicio en bruto y material de credencial.

Fuente de pruebas #

Documentos respaldados por fuentes de la ruta de descubrimiento XMemo, contrato de descubrimiento alojado, servidor MCP y SDK TypeScript.

Preguntas frecuentes / Solución de problemas #

¿Por qué mi asistente de IA no recuerda algo que le conté antes? —
¿Por qué mi asistente de IA mezcla mis proyectos o conversaciones? —
¿Cómo puedo hacer que mi asistente de IA olvide algo por completo? —
¿XMemo seguirá recordándome si cambio de ordenador o de asistente de IA? —
¿Por qué mi asistente de IA guardó lo mismo dos veces? —
¿Por qué mi asistente de IA me da demasiado o muy poco contexto del pasado? —
He desconectado XMemo; ¿cómo compruebo que el asistente antiguo no pueda usarlo? —
¿Por qué mi asistente de IA ya no puede usar XMemo? —
¿Qué conexión de XMemo debo usar en mi asistente de IA? —
¿Qué hago si mi asistente de IA todavía no puede conectarse a XMemo? —

Requisitos previos #

Approved service URL - Used by xmemo setup --url to fetch discovery, onboarding status, and MCP config templates.
Node.js and npm - Discovery and the product page advertise @xmemo/client as the public CLI package.
Scoped token or OAuth grant - ChatGPT and VS Code / GitHub Copilot use OAuth; direct MCP and REST clients use XMEMO_KEY from an environment variable or secret store.

Conectar con XMemo #

xmemo setup --url drives the entire trial. The documented hosted setup flow is implemented as discovery → onboarding status → MCP config template → reviewed client configuration.

npm install -g @xmemo/client
npx @xmemo/client setup --url https://xmemo.dev

Configuración de MCP #

XMemo MCP setup lives in Docs because auth differs by client. ChatGPT, VS Code / GitHub Copilot, and Gemini CLI use hosted OAuth; direct/headless clients use the hosted Streamable HTTP URL plus XMEMO_KEY from the local environment or secret store.

VS Code / GitHub Copilot

%APPDATA%\Code\User\mcp.json

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

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "cursor",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Codex

~/.codex/config.toml

[mcp_servers.XMemo]
url = "https://xmemo.dev/mcp"
bearer_token_env_var = "XMEMO_KEY"

[mcp_servers.XMemo.http_headers]
X-Memory-OS-Agent-ID = "codex"

[mcp_servers.XMemo.env_http_headers]
X-Memory-OS-Agent-Instance-ID = "XMEMO_AGENT_INSTANCE_ID"

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "gemini-cli",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-desktop",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Devin Desktop (formerly Windsurf)

~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "XMemo": {
      "serverUrl": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "windsurf",
        "X-Memory-OS-Agent-Instance-ID": "${env:XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Kiro

~/.kiro/settings/mcp.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "kiro",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      },
      "oauth": {
        "oauthScopes": [
          "memory:read",
          "knowledge:read"
        ]
      }
    }
  }
}

Muse Code

~/.config/muse/settings.json

{"schema_version": 1, "mcpServers": {"xmemo": {"type": "streamable-http", "url": "https://xmemo.dev/mcp", "mode": "optional"}}}

OpenClaw

~/.openclaw/openclaw.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Copilot CLI

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

ChatGPT / OpenAI Apps SDK

Panel de gestión de aplicaciones de OpenAI Platform

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "transport": "streamable-http",
      "auth": {
        "type": "oauth2",
        "resource": "https://xmemo.dev/mcp",
        "scopes": ["memory:read", "memory:write"]
      }
    }
  }
}

Autonomous agent

Configuración MCP del ejecutor del agente

{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "transport": "streamable-http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "autonomous-agent",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      },
      "auth": {
        "type": "oauth2",
        "flow": "authorization_code",
        "pkce_required": true,
        "resource": "https://xmemo.dev/mcp",
        "scopes": ["memory:read", "memory:write"]
      },
      "fallback": {
        "use_when": "headless runner cannot complete OAuth sign-in or persist OAuth tokens",
        "authorization_header": "Bearer ${XMEMO_KEY}"
      }
    }
  }
}

Otros

Cualquier agente con capacidad MCP

{
  "mcpServers": {
    "XMemo": {
      "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}"
      }
    }
  }
}

Kimi Code

~/.kimi-code/mcp.json

{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "bearerTokenEnvVar": "XMEMO_KEY",
      "headers": {
        "X-Memory-OS-Agent-ID": "kimi-code",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Claude Code

~/.claude.json

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-code",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-desktop",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Cline (VS Code)

~/Documents/Cline/MCP/cline_mcp_settings.json

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "cline",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Continue (VS Code / JetBrains)

~/.continue/config.json

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

Zed

Zed settings.json (varies by OS)

{
  "context_servers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:zed",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Trae

Trae user config mcp.json (varies by OS)

{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:trae",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Grok

~/.grok/config.toml

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

Antigravity 2.0

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "XMemo": {
      "serverUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "antigravity",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Qwen

~/.qwen/settings.json

{
  "mcpServers": {
    "XMemo": {
      "httpUrl": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "qwen",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

OpenCode

~/.config/opencode/opencode.json

{
  "mcp": {
    "XMemo": {
      "type": "remote",
      "url": "https://xmemo.dev/mcp",
      "enabled": true,
      "headers": {
        "X-Memory-OS-Agent-ID": "opencode",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}

Client capability matrix #

The canonical matrix is the source of truth for each client's OAuth mode, MCP transport, credential handling, readiness, evidence boundary, and marketplace state. This page only provides the setup console; do not copy a status into another page without checking the matrix.

Read CLIENT_CAPABILITY_MATRIX.md on GitHub ↗

Predefinido como agente autónomo #

Autonomous agents should fetch /api/v1/mcp/config/autonomous-agent instead of asking humans to choose identity fields.

Superficie de la herramienta MCP #

The discovery response lists the actual MCP transport as streamable-http and advertises tools implemented by the XMemo MCP server.

Recall tools - search_memory, recall, recall_plan, and recall_context.
Write tools - remember, store_memory, update_memory, and record_event.
Governance tools - forget_memory, redact_memory, explain_memory, and conflict/version helpers.

Ayudantes de flujo de trabajo SDK #

The TypeScript SDK exposes workflow helpers in packages/memory-os-js. These helpers route events through capture policy before writing memory.

Competencias y agentes #

Skills are the instruction-and-command lane for agents that do not mount a hosted MCP server directly.

Inicio rápido para XMemo

Introducción #

Persona onboarding flows #

Usuario de ChatGPT

Copiloto / Codex desarrollador

Equipo / propietario del piloto de la empresa

Operador de agente autónomo

Controles de la consola de memoria #

Memoria de vista y búsqueda

Editar o corregir entradas

Suprimir y exportar

Atribución del agente

Controles de privacidad y credenciales

Solicitud de acceso XMemo #

Guía rápida de XMemo alojado #

Pregunte a su agente

Clientes de OAuth

MCP directo con XMEMO_KEY

Controles de cuentas

Seguridad pública #

Fuente de pruebas #

Preguntas frecuentes / Solución de problemas #

Requisitos previos #

Conectar con XMemo #

Configuración de MCP #

VS Code / GitHub Copilot

Cursor

Codex

Gemini CLI

Claude Desktop

Devin Desktop (formerly Windsurf)

Kiro

Muse Code

OpenClaw

Copilot CLI

ChatGPT / OpenAI Apps SDK

Autonomous agent

Otros

Kimi Code

Claude Code

Claude Desktop

Cline (VS Code)

Continue (VS Code / JetBrains)

Zed

Trae

Grok

Antigravity 2.0

Qwen

OpenCode

Client capability matrix #

Predefinido como agente autónomo #

Superficie de la herramienta MCP #

Ayudantes de flujo de trabajo SDK #

Competencias y agentes #

Próximas medidas #