Un desarrollador trabaja de noche con dos monitores en un escritorio ordenado, con luz cálida de lámpara

Memoria para Claude Code y agentes de programación: MCP, hooks y límites

Producto8 min de lectura

Cómo dar memoria persistente a Claude Code con MCP y hooks: instalación paso a paso, qué se envía a MemoryFirst, qué recupera cada sesión y sus límites.

por Equipo MemoryFirst

Índice del artículo
  1. Dos puertas: MCP y hooks
  2. Qué hacen exactamente los hooks
  3. Instalación paso a paso
  4. Una sesión real, de principio a fin
  5. Control de permisos
  6. Límites honestos
  7. Siguientes pasos
  8. Fuentes

Abres Claude Code un lunes y le pides que retome la migración de la semana pasada. Responde con educación y sin ninguna pista: no sabe qué tabla se descartó, por qué elegisteis una librería y no otra, ni que el viernes se acordó dejar un endpoint sin tocar. Empieza en frío. Lo contamos como problema en tus agentes de IA empiezan en frío cada sesión; esta guía es la solución práctica.

Hay dos puertas para darle memoria a un agente de programación, y conviene entender la diferencia antes de instalar nada.

Manos de un desarrollador sobre un teclado mecánico con una terminal desenfocada al fondo

Dos puertas: MCP y hooks

MCP convierte la memoria en una herramienta más. El agente decide cuándo consultarla (mf_query, mf_recall) y cuándo registrar algo (mf_record). Funciona con Claude Code, pero también con Claude Desktop, ChatGPT, Cursor o VS Code, porque el servidor es remoto y habla el protocolo estándar. Son 15 herramientas en total; las que más se usan en programación son recordar el estado de un proyecto, preguntar con citas, registrar una decisión y ver el estado vigente.

Los hooks son comandos que Claude Code ejecuta en momentos del ciclo de vida de la sesión. Aquí no decide el agente, decide el sistema: al empezar, inyectan contexto; al terminar, devuelven lo aprendido. Es la parte que no depende de que el modelo se acuerde de pedir memoria.

La combinación es la buena: los hooks cubren lo automático y MCP cubre lo deliberado. Si solo quieres una de las dos, empieza por MCP; si quieres la que menos esfuerzo diario exige, los hooks.

Qué hacen exactamente los hooks

Esto es lo que hace el paquete de hooks, verificado contra su código el 13 de noviembre de 2026:

Evento de Claude CodeQué ocurre
SessionStartPide a MemoryFirst el contexto del proyecto (por defecto, hasta 2.500 tokens) y lo inyecta como contexto adicional. Si el proyecto aún no tiene eventos, no inyecta nada
StopEnvía una instantánea del texto de la conversación, como mucho una cada 3 horas por sesión por defecto
SessionEndEnvía la conversación final, sin límite de frecuencia

El proyecto se identifica por el nombre del repositorio de git (o, si no hay, el de la carpeta), de modo que una sesión en un worktree cuenta contra su repositorio. Cada proyecto tiene su propia memoria dentro de tu espacio.

Lo que el servidor hace con la conversación: no guarda el volcado tal cual, la destila en eventos (decisiones, bloqueos, estado) y retira las instantáneas anteriores de la misma sesión para no duplicar. Si envías dos veces el mismo texto, la segunda es un no-op.

Instalación paso a paso

Paso 1: cuenta y clave

Crea tu cuenta y tu espacio en el registro; los datos se guardan en la UE (Alemania). Después genera una clave de API en Ajustes, claves de API. Se muestra una sola vez: guárdala en un gestor de contraseñas.

Paso 2: conecta el servidor MCP

Con una clave de API:

claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai --header "Authorization: Bearer mf_live_…"

Si prefieres iniciar sesión con tu cuenta en lugar de usar una clave, añade el servidor sin la cabecera y autoriza con /mcp dentro de Claude Code. No pongas la cabecera Authorization si quieres OAuth: Claude Code usaría la cabecera y no pasaría a OAuth.

Paso 3: instala los hooks

El asistente de incorporación del panel muestra los dos comandos exactos: clonar el repositorio de hooks que te indica y ejecutar ./install.sh --credentials. Piden bash, jq y curl, y funcionan en macOS y Linux. Cuando el instalador pida la dirección y la clave, en macOS van al llavero del sistema; en Linux, a ~/.config/memoryfirst/hooks.env con permisos 600. Nunca se escriben en el repositorio ni en los hooks.

El instalador es idempotente: puedes volver a ejecutarlo para actualizar. Edita ~/.claude/settings.json fusionando solo lo suyo, deja intactos los hooks de otras herramientas y guarda una copia de seguridad antes de cada cambio. ./install.sh --uninstall lo deshace.

Paso 4: comprueba que funciona

Abre una sesión nueva en un proyecto que ya tenga algún evento y comprueba que arranca con contexto. Cada envío queda registrado, sin contenido ni credenciales, en ~/.claude/hooks/memoryfirst-ingest.log.

Una libreta con una lista de comprobación dibujada a mano junto a un portátil

Una sesión real, de principio a fin

Esto es un ejemplo de flujo, no una medición. Retomas el proyecto de facturación el lunes. Al abrir Claude Code, el hook de arranque inyecta un resumen: la decisión del viernes de no tocar el endpoint de exportación, el bloqueo abierto con la pasarela de pago y el último despliegue. Tú escribes «sigue con la migración» y el agente ya sabe qué tabla se descartó. Cuando surge una decisión nueva, el agente la registra con mf_record. Si trabajáis con memoria de equipo (plan Team) y un compañero pregunta al día siguiente, desde Cursor, por qué se eligió esa librería, mf_query responde con una cita a la sesión donde se decidió.

Para la parte de consulta con citas, memoria que puedes auditar explica qué guarda cada cita; para conectar otros clientes, conecta memoria a cualquier agente.

Control de permisos

Cuando conectas un cliente por OAuth, tú decides cuánto puede hacer. Hay dos niveles de acceso: solo lectura (recordar, consultar, ver proyectos y estado) y lectura y escritura (además registra eventos y gestiona tareas). Puedes limitar la conexión a proyectos concretos, ponerle fecha de caducidad y revocarla desde el panel.

Un riesgo que conviene tener presente: un agente con escritura que lee algo malicioso (una página web, un correo) podría escribir datos falsos en tu memoria. Da escritura solo a la aplicación que de verdad la necesita.

Límites honestos

  • Mejor esfuerzo y en silencio. Si faltan credenciales, falla la red o cae la API, los hooks no dicen nada y no rompen la sesión. La contrapartida es que un fallo se nota por ausencia: una sesión que arranca sin contexto. Un hook vigía avisa en una línea si la clave de MCP configurada fue rotada, porque Claude Code lee esa configuración una sola vez al arrancar.
  • Solo texto de conversación. Se envían tus mensajes y las respuestas de texto de Claude. No se extraen las salidas de herramientas, el contenido de los ficheros leídos ni los bloques de razonamiento. Las sesiones de menos de 400 caracteres se omiten y cada captura se limita a los últimos 200.000 caracteres.
  • La destilación pasa por un modelo de lenguaje. Ese texto se procesa con la cadena de inferencia de la plataforma, cuyo proveedor por defecto es estadounidense; la clave propia (BYOK) cubre las consultas, no la extracción. Si tu código o tus conversaciones tienen restricciones de cumplimiento, léelo antes de instalar.
  • Los secretos no deberían estar en la conversación. El servidor redacta formas de credencial al ingerir, pero no es una garantía: no pegues claves en una sesión.
  • No es memoria del código. No indexa tu repositorio ni lo entiende; guarda decisiones, estado y contexto de las conversaciones. Para el código, tu agente sigue leyendo los ficheros.
  • Plan Free. 1 proyecto y retención de 30 días. Si trabajas en varios repositorios, necesitarás Pro (12 €/mes con facturación anual, proyectos ilimitados y retención ilimitada).

Y un detalle opcional: si envías la cabecera X-MemoryFirst-Session con el identificador de sesión de Claude Code, las consultas excluyen la transcripción de esa misma sesión y no te devuelven tu propia pregunta como respuesta. Depende de que tu versión de Claude Code exponga ese identificador; si no, la cabecera se ignora.

Cuándo no te hace falta

Si trabajas solo, en un único repositorio y lo único que quieres es que Claude recuerde tus preferencias de estilo, un plugin local de memoria te basta y no necesita cuenta. MemoryFirst compensa cuando la memoria debe cruzar proyectos, máquinas, herramientas o personas, o cuando quieres citas verificables. Hay más en la comparativa con Mem0 y en cómo elegir una capa de memoria.

Dos desarrolladores revisan un problema juntos en una mesa compartida de un estudio pequeño

Siguientes pasos

Si trabajas en equipo, lee el escenario simulado de un equipo de software con agentes. Para entender el producto completo, qué es un cerebro de empresa. La referencia técnica está en la documentación.

Fuentes

  • Documentación de hooks de Claude Code (eventos SessionStart, Stop, SessionEnd y contexto adicional al iniciar): https://code.claude.com/docs/en/hooks (consultado el 14-11-2026)
  • Documentación de MCP en Claude Code (claude mcp add --transport http, cabeceras y autorización con /mcp): https://code.claude.com/docs/en/mcp (consultado el 14-11-2026)
  • Comportamiento de los hooks y límites de datos: documentación y código del paquete de hooks de MemoryFirst, verificados el 13-11-2026. Precios y planes: página de precios de MemoryFirst (consultado el 14-11-2026).

Instala los hooks en 10 minutos

El plan Free incluye 1 proyecto, la memoria por MCP y los hooks de Claude Code. Genera tu clave y prueba una sesión.

Empieza gratis

Sigue leyendo