リファレンスMCP ツールremember

Tool Reference

remember

capture policy、scope、secret-redactionの境界を満たした後にだけ、永続memoryを書き込みます。

書き込みが反映されたことを確認する

書き込みresponseだけを信頼せず、scopeを指定したsearchでmemoryを読み戻します。

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

公開 MCP ツール

remember

用途

承認済みのagentが後でrecallできるよう、永続的な情報を保存します。これは直接的なdurable-write APIです。event streamは呼び出す前にcapture policyを通す必要があります。

適用シーン

  • ユーザーが永続的なfact、preference、decision、または検証済みのhandoff noteの保存を明示的に依頼した場合。
  • 現在のchatやtaskが終わった後も情報が役立つ場合。
  • callerが所有pathと、認可されたproject、scope、またはteam boundaryを指定できる場合。

非推奨シーン

  • 一時的なchat instruction、一度きりの回答、または容量の大きいraw tool outputを保存しないでください。
  • password、bearer token、API key、private-key materialを永続化しないでください。先にsecretをredactするか拒否してください。
  • financial recordにgeneric memoryを使わないでください。transactionとreminderにはledgerを使います。
  • REST APIはpublic MCP toolより広いfield setを受け付けます。scope、bucket、team、provenance filterについては/docs/api/memoryを参照してください。

必須スコープ

  • public MCP write surfaceにはmemory:writeが必要です。
  • 認証済みownerはresolved path/scopeへの書き込みを許可されている必要があります。team writeにはteam membershipも必要です。

パラメーター

名前型説明
contentstring · 必須永続メモリの本文です。事実に基づき、範囲を限定し、secretを含めないでください。
pathstring · 必須メモリをprojectまたは永続namespaceに結び付ける論理的位置です。
create_projectboolean · デフォルト: falseGeneric public profileでのみ使用します。pathがprojectを示す場合に所有projectを作成します。ChatGPTまたはClaude plugin profileでは受け付けません。

返却スキーマ

成功テキストには、保存されたメモリのreference/ID、論理path、writer identity、account、device labelが含まれます。Public clientはreferenceをopaque identifierとして扱ってください。

使用例

明示的な永続decisionを保存する
remember({
  content: "Use OAuth for hosted ChatGPT connections.",
  path: "projects/memory-os/decisions"
})

エラー

  • 401/403: MCP tokenがない、またはmemory:writeを含んでいません。
  • Validation failure: contentまたはpathが空、malformed JSONが指定された、または値がstorage contractに違反しています。
  • Authorization failure: callerは要求されたscope、project、teamに書き込めません。
  • Safety rejection: secretのようなcontent、または予約済みidentity metadataがブロックまたはsanitizationされました。
  • recall — 永続factを保存した後、関連するメモリを少数取得します。
  • recall_context — 後続のtaskの前に、範囲を限定したcontext packを作成します。
  • ledger — generic memoryではなく、管理対象のfinancial recordを保存します。

出典: MCPツールサーフェス