Confirme que a gravação foi concluída
Leia a memória novamente por meio de uma busca com escopo, em vez de confiar apenas na resposta da gravação.
search_memory({
query: "OAuth for hosted ChatGPT connections",
limit: 3
})Ferramenta MCP pública
remember
Finalidade
Persista informações duradouras que um agente aprovado possa recuperar mais tarde. Esta é a API direta de gravação duradoura; fluxos de eventos devem passar pela política de captura antes de chamá-la.
Quando usar
- O usuário pede explicitamente para salvar um fato duradouro, preferência, decisão ou nota de handoff validada.
- A informação continuará útil depois que o chat ou a tarefa atual terminarem.
- O chamador consegue informar o path proprietário e um limite autorizado de projeto, escopo ou equipe.
Quando NÃO usar
- Não armazene instruções temporárias do chat, uma resposta pontual ou saída bruta de ferramenta em grande volume.
- Não persista senhas, bearer tokens, API keys ou material de chave privada; mascare ou rejeite segredos antes.
- Não use memória genérica para registros financeiros; use ledger para transações e lembretes.
- A API REST aceita um conjunto de campos mais amplo que a ferramenta MCP pública; consulte /docs/api/memory para os filtros de scope, bucket, team e provenance.
Escopo necessário
- memory:write é obrigatório para a superfície pública de gravação MCP.
- O owner autenticado precisa poder gravar no path/scope resolvido; gravações de equipe também exigem participação na equipe.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
content | string · obrigatório | Corpo da memória duradoura. Mantenha-o factual, limitado e sem segredos. |
path | string · obrigatório | Local lógico usado para vincular a memória a um projeto ou namespace duradouro. |
create_project | boolean · padrão: false | Somente no perfil público genérico: cria o projeto proprietário se o path indicar um. Não é aceito nos perfis de plugin do ChatGPT ou Claude. |
Esquema de retorno
O texto de sucesso inclui a referência/ID da memória gravada, o path lógico, a identidade do autor, a conta e o rótulo do dispositivo. Clientes públicos devem tratar a referência como identificador opaco.
Exemplos
remember({
content: "Use OAuth for hosted ChatGPT connections.",
path: "projects/memory-os/decisions"
})Erros
- 401/403: o token MCP está ausente ou não inclui memory:write.
- Falha de validação: content ou path está vazio, foi fornecido JSON malformado ou algum valor viola o contrato de armazenamento.
- Falha de autorização: o chamador não pode gravar no escopo, projeto ou equipe solicitados.
- Rejeição de segurança: conteúdo semelhante a segredo ou metadados de identidade reservados foi bloqueado ou sanitizado.
Ferramentas relacionadas
- recall — Busque algumas memórias relevantes depois de salvar um fato duradouro.
- recall_context — Monte um pacote de contexto limitado antes de uma tarefa posterior.
- ledger — Armazene registros financeiros governados em vez de usar memória genérica.
Origem: Superfície de ferramentas MCP