Memori MCP

Memori MCP

Memoria persistente de IA para cualquier agente compatible con MCP — sin necesidad de SDK.

memori-mcp es el servidor MCP oficial de Memori. Conéctalo a tu agente de IA para dotarlo de memoria a largo plazo: recupera hechos relevantes, obtén resúmenes amplios del estado, restaura el estado de trabajo tras la compactación de contexto, almacena preferencias duraderas después de responder y mantén el contexto entre sesiones.

---

¿Por qué Memori MCP?

Memori convierte agentes sin estado en sistemas con estado al proporcionar memoria estructurada y persistente que funciona entre sesiones y flujos de trabajo.

1. Estado persistente más allá de los prompts — La mayoría de los agentes dependen del contexto del prompt y pierden estado entre ejecuciones. Memori proporciona memoria estructurada y duradera para que los agentes puedan retener hechos, decisiones y resultados a lo largo del tiempo.
2. Memoria desde la ejecución (no solo desde el lenguaje natural) — Los sistemas tradicionales extraen memoria del chat. Memori construye memoria a partir de la propia ejecución del agente — incluyendo llamadas a herramientas, decisiones y resultados. Esto permite una memoria verdaderamente nativa del agente, no solo un recuerdo conversacional.
3. Menor costo, mayor precisión — En lugar de expandir el contexto del prompt, Memori recupera solo lo que importa.
   • Reducción significativa del uso de tokens
   • Respuestas más rápidas
   • Precisión mejorada frente a enfoques de contexto largo
4. Funciona con cualquier cliente MCP y está listo para producción — Sin SDK, sin cambios de código, solo configuración

Memori es infraestructura de estado para agentes de producción — que permite memoria persistente, recuperación eficiente y contexto estructurado tanto en lenguaje natural como en ejecución de agentes.

---

Benchmark LoCoMo

Memori fue evaluado en el benchmark LoCoMo para memoria de conversaciones largas y logró una precisión general del 81.95% mientras usaba un promedio de 1,294 tokens por consulta. Eso es solo el 4.97% de la huella de contexto completo, lo que demuestra que la memoria estructurada puede preservar la calidad del razonamiento sin forzar prompts grandes en cada solicitud.

En comparación con otros sistemas de memoria basados en recuperación, Memori superó a Zep, LangMem y Mem0, reduciendo el tamaño del prompt en aproximadamente 67% frente a Zep y reduciendo el costo de contexto en más de 20x frente al prompting de contexto completo.

Lee la descripción general del benchmark o descarga el artículo.

---

Cómo Funciona

El servidor expone siete herramientas:

Herramienta	Cuándo llamarla	Qué hace
memori_recall	Al inicio de cada turno del usuario	Recupera recuerdos relevantes al inicio de un turno del usuario
memori_recall_summary	Inicio de sesión, resúmenes diarios, actualizaciones de estado, resúmenes de proyectos	Recupera el estado amplio de memoria para inicios de sesión, resúmenes diarios, actualizaciones de estado y resúmenes de proyectos
memori_compaction	Después de la compactación de contexto	Recupera un resumen estructurado posterior a la compactación para que un agente pueda reanudar el trabajo operativo
memori_advanced_augmentation	Después de redactar una respuesta	Almacena memoria duradera después de que el agente haya redactado una respuesta
memori_feedback	Cuando el usuario señala un problema de memoria o elogia un resultado	Reporta comportamiento de memoria irrelevante, faltante, desactualizado o especialmente útil
memori_signup	Cuando el usuario lo solicita explícitamente y proporciona un correo electrónico	Solicita una cuenta/clave API de Memori cuando el usuario lo pide explícitamente
memori_quota	Cuando el usuario pregunta sobre el uso o aparecen errores de cuota	Verifica el uso y los límites actuales de memoria cuando el usuario lo pregunta o aparecen errores de cuota

Flujo de Ejemplo del Agente

Dado el mensaje del usuario: "Prefiero Python y uso uv para la gestión de dependencias."

1. El agente llama a memori_recall con el mensaje del usuario como query
2. El agente redacta una respuesta usando cualquier hecho devuelto
3. El agente envía la respuesta al usuario
4. El agente llama a memori_advanced_augmentation con el user_message y el assistant_response

En un turno posterior como "Escribe un script de hello world", el agente recuerda la preferencia de Python + uv y personaliza su respuesta.

---

Requisitos Previos

• Una clave API de Memori desde app.memorilabs.ai
• Un entity_id para identificar al usuario final (por ejemplo, user_123)
• Un process_id opcional para identificar al agente o flujo de trabajo (por ejemplo, my_agent)

Exporta estos en tu shell o reemplaza los marcadores de posición directamente en tu configuración:

export MEMORI_API_KEY="your-memori-api-key"
export MEMORI_ENTITY_ID="user_123"
export MEMORI_PROCESS_ID="my_agent"   # optional

---

Detalles del Servidor

Propiedad	Valor
Servidor	Memori MCP
Endpoint	https://api.memorilabs.ai/mcp/
Transporte	HTTP sin estado
Autenticación	Clave API mediante cabeceras de solicitud

Cabeceras

Cabecera	Requerida	Descripción
X-Memori-API-Key	Sí	Tu clave API de Memori desde app.memorilabs.ai
X-Memori-Entity-Id	Sí	Identificador estable del usuario final o entidad (por ejemplo, user_123)
X-Memori-Process-Id	No	Identificador opcional de proceso, aplicación o flujo de trabajo (por ejemplo, my_agent) para aislamiento de memoria

session_id se deriva automáticamente como <entity_id>-<UTC year-month-day:hour>. No necesitas proporcionarlo.

---

Verificación de la Conexión

Después de configurar tu cliente, verifica la instalación:

• El servidor MCP aparece como conectado y saludable en la interfaz de tu cliente
• La lista de herramientas incluye memori_recall, memori_recall_summary, memori_compaction y memori_advanced_augmentation
• Las llamadas devuelven respuestas que no son 401
• memori_recall devuelve recuerdos para entidades conocidas
• memori_advanced_augmentation acepta datos duraderos de turnos de usuario/asistente

Si recibes errores de 401, verifica dos veces tu valor de X-Memori-API-Key. Consulta la guía de solución de problemas para obtener más ayuda.

---

Enlaces

• Memori Cloud
• Obtén una clave API
• Documentación general de MCP
• Documentación de configuración del cliente
• Documentación de habilidades del agente