remember

Confirma que la escritura se ha guardado

Lee de nuevo la memoria mediante una búsqueda con alcance definido en lugar de confiar únicamente en la respuesta de escritura.

search_memory({
  query: "OAuth for hosted ChatGPT connections",
  limit: 3
})

Herramienta MCP pública

remember

Propósito

Conserva información duradera que un agente autorizado pueda recuperar más adelante. Es la API directa de escritura duradera; los flujos de eventos deben pasar por la política de captura antes de llamarla.

Cuándo usar

Un usuario pide explícitamente guardar un hecho duradero, una preferencia, una decisión o una nota de traspaso revisada.
La información seguirá siendo útil después de que termine el chat o la tarea actual.
El llamador puede proporcionar el path propietario y un límite autorizado de proyecto, alcance o equipo.

Cuándo NO usar

No guardes instrucciones temporales del chat, una respuesta puntual ni una salida de herramienta sin filtrar y de gran volumen.
No conserves contraseñas, bearer tokens, API keys ni material de claves privadas; primero redacta los secretos o recházalos.
No uses la memoria genérica para registros financieros; usa ledger para transacciones y recordatorios.
La API REST acepta un conjunto de campos más amplio que la herramienta MCP pública; consulta /docs/api/memory para los filtros de scope, bucket, team y provenance.

Ámbito requerido

El scope memory:write es obligatorio para la superficie pública de escritura MCP.
El owner autenticado debe tener permiso para escribir en el path/scope resuelto; las escrituras de equipo también requieren pertenencia al equipo.

Parámetros

Nombre	Tipo	Descripción
`content`	string · obligatorio	Cuerpo de la memoria duradera. Mantenlo factual, acotado y sin secretos.
`path`	string · obligatorio	Ubicación lógica que vincula la memoria a un proyecto o namespace duradero.
`create_project`	boolean · predeterminado: false	Solo para el perfil público genérico: crea el proyecto propietario si el path implica uno. No se acepta en los perfiles de plugin de ChatGPT o Claude.

Esquema de retorno

El texto de éxito incluye la referencia/ID de la memoria guardada, el path lógico, la identidad del escritor, la cuenta y la etiqueta del dispositivo. Los clientes públicos deben tratar la referencia como un identificador opaco.

Ejemplos

Guarda una decisión duradera explícita

remember({
  content: "Use OAuth for hosted ChatGPT connections.",
  path: "projects/memory-os/decisions"
})

Errores

401/403: falta el token MCP o no incluye memory:write.
Error de validación: content o path está vacío, se proporcionó JSON mal formado o un valor incumple el contrato de almacenamiento.
Error de autorización: el llamador no puede escribir en el scope, proyecto o equipo solicitado.
Rechazo de seguridad: se bloqueó o saneó contenido parecido a un secreto o metadatos de identidad reservados.

recall — Obtén algunas memorias relevantes después de guardar un hecho duradero.
recall_context — Construye un paquete de contexto acotado antes de una tarea posterior.
ledger — Guarda registros financieros sujetos a control en lugar de memoria genérica.

Fuente: Superficie de herramientas MCP