참조MCP 도구remember

Tool Reference

remember

capture policy, scope 및 secret-redaction 경계를 충족한 후에만 영구 memory를 저장합니다.

쓰기 완료 확인

쓰기 응답만 믿지 말고 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도 필요합니다.

매개변수

이름타입설명
contentstring · 필수영구 memory 본문입니다. 사실에 기반하고 범위를 제한하며 secret이 없도록 유지합니다.
pathstring · 필수memory를 project 또는 영구 namespace에 연결하는 데 사용하는 논리적 위치입니다.
create_projectboolean · 기본값: falseGeneric 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로 처리해야 합니다.

예제

명시적인 영구 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: 호출자가 요청한 scope, project 또는 team에 쓸 수 없습니다.
  • Safety rejection: secret처럼 보이는 content 또는 예약된 identity metadata가 차단되거나 sanitized됩니다.
  • recall — 영구 fact를 저장한 뒤 관련 memory 몇 개를 가져옵니다.
  • recall_context — 이후 task 전에 범위가 제한된 context pack을 만듭니다.
  • ledger — generic memory 대신 관리되는 financial record를 저장합니다.

출처: MCP 도구 표면