書き込みが反映されたことを確認する
書き込み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も必要です。
パラメーター
| 名前 | 型 | 説明 |
|---|---|---|
content | string · 必須 | 永続メモリの本文です。事実に基づき、範囲を限定し、secretを含めないでください。 |
path | string · 必須 | メモリをprojectまたは永続namespaceに結び付ける論理的位置です。 |
create_project | boolean · デフォルト: false | Generic public profileでのみ使用します。pathがprojectを示す場合に所有projectを作成します。ChatGPTまたはClaude plugin profileでは受け付けません。 |
返却スキーマ
成功テキストには、保存されたメモリのreference/ID、論理path、writer identity、account、device labelが含まれます。Public clientはreferenceをopaque identifierとして扱ってください。
使用例
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ツールサーフェス