remember

Confirmer l'enregistrement de l'écriture

Relisez la mémoire via une recherche avec périmètre plutôt que de vous fier uniquement à la réponse d'écriture.

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

Outil MCP public

remember

Objectif

Persister des informations durables qu'un agent approuvé pourra rappeler ultérieurement. Il s'agit de l'API directe d'écriture durable ; les flux d'événements doivent passer par la politique de capture avant de l'appeler.

Quand l'utiliser

Un utilisateur demande explicitement d'enregistrer un fait durable, une préférence, une décision ou une note de passation validée.
L'information restera utile après la fin de la session de chat ou de la tâche en cours.
L'appelant peut fournir le chemin propriétaire ainsi qu'un périmètre de projet, de scope ou d'équipe autorisé.

Quand NE PAS l'utiliser

Ne stockez pas d'instructions de chat éphémères, de réponse ponctuelle ou de sorties brutes volumineuses d'outils.
Ne persistez pas de mots de passe, jetons porteurs, clés d'API ou éléments de clés privées ; caviardez ou rejetez d'abord les secrets.
N'utilisez pas la mémoire générique pour les enregistrements financiers ; utilisez ledger pour les transactions et les rappels.
L'API REST accepte un ensemble de champs plus large que l'outil MCP public ; consultez /docs/api/memory pour les filtres de périmètre, bucket, équipe et provenance.

Périmètre requis

memory:write est requis pour la surface d'écriture MCP publique.
Le propriétaire authentifié doit être autorisé à écrire dans le chemin/périmètre résolu ; les écritures d'équipe nécessitent également l'appartenance à l'équipe.

Paramètres

Nom	Type	Description
`content`	string · requis	Corps de la mémoire durable. Gardez-le factuel, délimité et exempt de secrets.
`path`	string · requis	Emplacement logique utilisé pour associer la mémoire à un projet ou à un espace de noms durable.
`create_project`	boolean · par défaut : false	Profil public générique uniquement : crée le projet propriétaire si le chemin en implique un. Non accepté sur les profils de plugins ChatGPT ou Claude.

Schéma de retour

Le texte de succès comprend la référence/l'ID de la mémoire stockée, le chemin logique, l'identité du rédacteur, le compte et le libellé de l'appareil. Les clients publics doivent traiter la référence comme un identifiant opaque.

Exemples

Enregistrer une décision durable explicite

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

Erreurs

401/403 : le jeton MCP est manquant ou ne contient pas memory:write.
Échec de validation : le contenu ou le chemin est vide, un JSON malformé est fourni, ou une valeur enfreint le contrat de stockage.
Échec d'autorisation : l'appelant ne peut pas écrire dans le périmètre, le projet ou l'équipe demandé.
Rejet de sécurité : un contenu semblable à un secret ou des métadonnées d'identité réservées sont bloqués ou aseptisés.

recall — Récupérer quelques mémoires pertinentes après avoir stocké un fait durable.
recall_context — Construire un pack de contexte délimité avant une tâche ultérieure.
ledger — Stocker des enregistrements financiers régis au lieu d'une mémoire générique.

Source : Surface des outils MCP