Conectar Claude a Mnemosyne OS (MCP)

Tu memoria puede ser una herramienta que usan tus herramientas de IA. El paquete @mnemosyne_os/mcp (MIT) es un servidor Model Context Protocol que convierte tu instalación local de Mnemosyne OS en una capa de memoria consultable para Claude Desktop, Claude Code, Cursor, Hermes Agent, y cualquier otro agente que hable MCP.

Una vez conectado, tu agente puede:

Consultar tu código, decisiones, notas de arquitectura e historial git con verdadero ranking semántico.
Persistir nuevas decisiones e ideas, que las sesiones futuras recuperarán.
Retomar un proyecto exactamente donde lo dejaste.
Filtrar por la naturaleza de las memorias (ARCHITECTURE, SOURCE_CODE, GIT, BUGFIX…).

Todo queda en tu máquina. El MCP es un puente delgado que no almacena nada por sí mismo. Todos los datos viven en tus bóvedas de Mnemosyne OS, y el agente solo ve las bóvedas que tú autorizas.

Corre sobre sí mismo

El vídeo del Neural Map de este wiki es Mnemosyne OS recordando su propio desarrollo, y este mismo wiki está escrito por un agente conectado a través de este mismo MCP.

Requisitos

Mnemosyne OS en marcha, para las herramientas de memoria. La app posee tus bóvedas y expone la pasarela local con la que habla el MCP. Tres herramientas funcionan con la app cerrada: las que leen lo que otros agentes de código escribieron en esta máquina (ver más abajo).
Node.js ≥ 18.

Claude Desktop, con un clic

Descarga Mnemosyne-OS-MCP-2.1.0.mcpb (4.1 MB, o la más reciente en la página de versiones), abre Claude Desktop → Ajustes → Extensiones y suelta el archivo en ese panel. Eso es toda la instalación. Las herramientas aparecen de inmediato, y el mismo panel ofrece tres ajustes opcionales: bóveda por defecto, otras bóvedas y el puerto en el que escucha la aplicación.

Claude Desktop muestra primero un aviso rojo de desarrollador no verificado. Todo paquete sin firmar lo provoca.

El doble clic no hace nada en una instalación de Microsoft Store

Una aplicación de la Store no registra la extensión .mcpb en Windows, así que el archivo no se abrirá por sí solo. Suéltalo en el panel de Extensiones.

Claude Desktop, por archivo de configuración

Si prefieres no instalar una extensión:

Settings → Developer → Edit config (claude_desktop_config.json), añade:

{
  "mcpServers": {
    "mnemosyne": {
      "command": "npx",
      "args": ["-y", "@mnemosyne_os/mcp"],
      "env": {
        "MNEMO_DEFAULT_VAULT": "DEV",
        "MNEMO_VAULTS": "DEV,PERSONAL,SOCIAL"
      }
    }
  }
}

Cierra Claude Desktop por completo y relánzalo (desde el icono de la bandeja, no solo la ventana). El servidor mnemosyne aparece en Settings → Developer → Local MCP Servers con la insignia running.

Claude Code

Añade .mcp.json en la raíz de tu proyecto con el mismo bloque más una línea, y recarga la sesión:

{
  "mcpServers": {
    "mnemosyne": {
      "command": "npx",
      "args": ["-y", "@mnemosyne_os/mcp"],
      "env": {
        "MNEMO_DEFAULT_VAULT": "DEV",
        "MNEMO_VAULTS": "DEV,PERSONAL,SOCIAL",
        "CLAUDE_CODE_SESSION_ID": "${CLAUDE_CODE_SESSION_ID}"
      }
    }
  }
}

La última línea entrega al servidor el id de tu propia sesión. Un servidor MCP stdio solo recibe el env que declara su config: sin ella, las herramientas que listan los agentes de esta máquina no pueden marcar qué línea eres tú, y lo dicen en una frase en vez de adivinar.

Cursor

El mismo bloque otra vez, en .cursor/mcp.json.

Hermes Agent

Hermes trae soporte MCP de serie, así que no hay nada más que instalar. La receta vive en el README del paquete.

Lo que obtiene tu agente

Veintinueve herramientas, en siete familias. Veinticinco llegan en una instalación por defecto; las herramientas de voz y la de borrado se arman a mano con una variable de entorno. La referencia completa de parámetros está en el README del paquete, y la versión corta de esta tabla vive en mnemosyne-os.io/mcp.

Familia	Herramientas	Necesita la app abierta
Memoria	`mnemosyne_memory_query`, `mnemosyne_memory_ask`, `mnemosyne_vault_list`, `mnemosyne_memory_ingest`, `mnemosyne_resonance_list`, `mnemosyne_dream_bridges`, `mnemosyne_spine_assignments`, `mnemosyne_git_log`, `mnemosyne_position_get`, `mnemosyne_position_update`, `mnemosyne_about`	sí
To-do y Agenda	`mnemosyne_todo_add`, `mnemosyne_todo_list`, `mnemosyne_todo_update`, `mnemosyne_todo_categories`, `mnemosyne_agenda_add`, `mnemosyne_agenda_list`, `mnemosyne_agenda_update`, `mnemosyne_agenda_remove`	en una instalación dev, el demonio sin ventana las sirve con la app cerrada; una instalación npm necesita la app
Los otros agentes de esta máquina	`mnemosyne_agent_list`, `mnemosyne_agent_collisions`, `mnemosyne_agent_files`	no: leen las transcripciones que tu arnés ya escribe, nunca su contenido
Cockpit	`mnemosyne_cockpit_update`	sí: una tarjeta de estado de esta sesión en tu lienzo
Pheme	`mnemosyne_pheme_watch`, `mnemosyne_pheme_radar`	sí: el radar es tan fresco como el último escaneo que lanzaste, nunca más
Voz	`mnemosyne_voice_list`, `mnemosyne_voice_speak`, `mnemosyne_voice_status`	sí, tras `MNEMO_VOICE=1`
Borrado	`mnemosyne_memory_forget`	sí, tras `MNEMO_FORGET=1`: definitivo, sin papelera y sin copia guardada

mnemosyne_agent_collisions es la que conviene llamar antes de un commit: dice si otra sesión de agente está viva en el mismo proyecto y la misma rama, porque el índice de git lo comparten todos los procesos de un mismo árbol.

Tú sigues siendo la puerta

MNEMO_VAULTS nombra las bóvedas que el agente puede ver. Nada más es alcanzable, y las bóvedas con protección Maximum conservan sus garantías. Las escrituras pasan por las mismas puertas gobernadas que todo lo demás. La sesión de tu agente solo ve las crónicas que autorizas.

El otro sentido

Esta página le da a tu agente permiso para leer tu memoria. A partir de la 1.4.3 también puedes alimentarla: apunta una bóveda a las notas que tu agente escribe para sí mismo, y pregúntale a tu memoria lo que sabe. Mira conectar la memoria de tu agente de código.

Y el mismo puente llega a tu To-do y tu Agenda: desde la 1.4.4 el agente archiva las tareas que acordasteis, y desde la 1.4.5 las relee, las cambia, las marca o las quita, y hace lo mismo con tus citas, incluso con la app cerrada. Mira tareas desde tu agente de código.

Requisitos​

Claude Desktop, con un clic​

Claude Desktop, por archivo de configuración​

Claude Code​

Cursor​

Hermes Agent​

Lo que obtiene tu agente​

Tú sigues siendo la puerta​

El otro sentido​