remember

Bestätigen, dass der Schreibvorgang erfolgreich war

Lesen Sie die Erinnerung über eine bereichsbezogene Suche zurück, anstatt sich ausschließlich auf die Schreibbestätigung zu verlassen.

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

Öffentliches MCP-Tool

remember

Zweck

Dauerhafte Informationen speichern, die ein autorisierter Agent später wieder abrufen kann. Dies ist die direkte API für persistente Schreibvorgänge; Ereignisströme sollten vor dem Aufruf die Erfassungsrichtlinie durchlaufen.

Wann zu verwenden

Ein Benutzer bittet ausdrücklich darum, einen dauerhaften Fakt, eine Präferenz, eine Entscheidung oder eine geprüfte Übergabenotiz zu speichern.
Die Information bleibt auch nach Beendigung der aktuellen Chat-Sitzung oder Aufgabe nützlich.
Der Aufrufer kann den zuständigen Pfad sowie einen autorisierten Projekt-, Scope- oder Team-Bereich angeben.

Wann NICHT zu verwenden

Speichern Sie keine flüchtigen Chat-Anweisungen, einmaligen Antworten oder unaufbereiteten Tool-Ausgaben in großem Umfang.
Speichern Sie keine Passwörter, Bearer-Tokens, API-Schlüssel oder privaten Schlüsseldaten; bereinigen oder weisen Sie Geheimnisse vorab zurück.
Verwenden Sie den generischen Speicher nicht für finanzielle Aufzeichnungen; nutzen Sie ledger für Transaktionen und Zahlungserinnerungen.
Die REST-API akzeptiert eine breitere Palette an Feldern als das öffentliche MCP-Tool; siehe /docs/api/memory für Bereichs-, Bucket-, Team- und Herkunftsfilter.

Erforderlicher Scope

memory:write ist für die öffentliche MCP-Schreiboberfläche erforderlich.
Der authentifizierte Eigentümer muss berechtigt sein, in den aufgelösten Pfad/Bereich zu schreiben; Team-Schreibvorgänge erfordern zudem eine Teammitgliedschaft.

Parameter

Name	Typ	Beschreibung
`content`	string · erforderlich	Hauptteil der dauerhaften Erinnerung. Halten Sie ihn sachlich, abgegrenzt und frei von Geheimnissen.
`path`	string · erforderlich	Logischer Ort, der verwendet wird, um die Erinnerung einem Projekt oder dauerhaften Namensraum zuzuordnen.
`create_project`	boolean · Standard: false	Nur generisches öffentliches Profil: Erstellt das zuständige Projekt, falls der Pfad eines impliziert. Wird in Plugin-Profilen für ChatGPT oder Claude nicht akzeptiert.

Rückgabeschema

Der Erfolgstext enthält die Referenz/ID der gespeicherten Erinnerung, den logischen Pfad, die Verfasseridentität, das Konto und die Gerätebezeichnung. Öffentliche Clients sollten die Referenz als opaken Bezeichner behandeln.

Beispiele

Eine explizite dauerhafte Entscheidung speichern

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

Fehler

401/403: Das MCP-Token fehlt oder enthält nicht memory:write.
Validierungsfehler: Inhalt oder Pfad ist leer, ungültiges JSON übergeben oder ein Wert verletzt den Speichervertrag.
Autorisierungsfehler: Der Aufrufer darf nicht in den angeforderten Bereich, das Projekt oder Team schreiben.
Sicherheitsablehnung: Geheimnisähnliche Inhalte oder reservierte Identitätsmetadaten werden blockiert oder bereinigt.

recall — Einige relevante Erinnerungen nach dem Speichern eines dauerhaften Fakts abrufen.
recall_context — Ein strukturiertes Kontextpaket vor einer komplexen Aufgabe abrufen.
ledger — Verwenden Sie ein strukturiertes Hauptbuch für Ausgaben und Finanztransaktionen anstelle von einfachem Speichertext.

Quelle: MCP-Tool-Oberfläche