쓰기 완료 확인
쓰기 응답만 믿지 말고 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가 끝난 뒤에도 정보가 유용한 경우.
- 호출자가 owner path와 승인된 project, scope 또는 team boundary를 제공할 수 있는 경우.
사용하지 않을 시점
- 일시적인 chat 지시, 일회성 답변 또는 대량의 원시 tool output을 저장하지 않습니다.
- password, bearer token, API key 또는 private-key material을 저장하지 않습니다. 먼저 secret을 redact하거나 거부합니다.
- 금융 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 · 필수 | 영구 memory 본문입니다. 사실에 기반하고 범위를 제한하며 secret이 없도록 유지합니다. |
path | string · 필수 | memory를 project 또는 영구 namespace에 연결하는 데 사용하는 논리적 위치입니다. |
create_project | boolean · 기본값: false | Generic public profile 전용입니다. path가 project를 암시하면 owner project를 생성합니다. ChatGPT 또는 Claude plugin profile에서는 허용되지 않습니다. |
반환 스키마
성공 text에는 저장된 memory 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: 호출자가 요청한 scope, project 또는 team에 쓸 수 없습니다.
- Safety rejection: secret처럼 보이는 content 또는 예약된 identity metadata가 차단되거나 sanitized됩니다.
관련 도구
- recall — 영구 fact를 저장한 뒤 관련 memory 몇 개를 가져옵니다.
- recall_context — 이후 task 전에 범위가 제한된 context pack을 만듭니다.
- ledger — generic memory 대신 관리되는 financial record를 저장합니다.
출처: MCP 도구 표면