Onde cada credencial deve ficar
O limite de autenticação separa o consentimento OAuth, o armazenamento de tokens bearer, os cabeçalhos de identidade sem segredo e a própria decisão de acesso. Misturá-los é a causa mais comum de vazamento de token.
- O consentimento OAuth acontece no cliente; o XMemo nunca vê um token colado nesse caminho.
- XMEMO_KEY fica no ambiente ou em um armazenamento seguro compatível, nunca em um arquivo de configuração versionado no git.
- Cabeçalhos de identidade são rótulos simples e podem ser gravados com segurança na configuração.
- A descoberta pública é somente leitura e não contém segredos.
Configuração de cliente baseada em token
Faça referência à variável de ambiente na configuração do cliente para que o valor real nunca apareça no arquivo.
{
"mcpServers": {
"XMemo": {
"type": "http",
"url": "https://xmemo.dev/mcp",
"headers": {
"Authorization": "Bearer ${env:XMEMO_KEY}"
}
}
}
}Como é uma solicitação rejeitada
Uma credencial ausente ou insuficiente é rejeitada antes que qualquer memória seja lida. Um conjunto vazio de resultados é uma resposta válida de nenhuma correspondência e não indica um problema de autorização.
401 — no valid bearer token or API key was supplied.
403 — the credential is valid but lacks memory:read or memory:write.
200 with zero results — authorized, nothing matched.Controles do Console de Memória
O XMemo não é apenas um endpoint MCP. O Console de Memória é o espaço voltado ao usuário para revisar, corrigir, remover e exportar memórias, mantendo a atribuição do agente visível.
- Visualizar e pesquisar memórias — Abra o console para ver memórias salvas, inspecionar caminhos e tipos de memória, e confirmar se uma recuperação deveria ter retornado um item específico.
- Editar ou corrigir entradas — Corrija fatos desatualizados, mova itens para caminhos mais claros ou substitua anotações antigas para que assistentes futuros recuperem o contexto mais recente aprovado pelo usuário.
- Excluir e exportar — Use os fluxos da conta para remover memórias que não deseja mais e localizar caminhos de exportação para revisão de memórias no escopo da conta.
Origem: Segurança pública