# Limite de autenticação

Separe o consentimento OAuth, o armazenamento de tokens bearer, os cabeçalhos de identidade e as decisões de acesso autenticado.

- Canonical: https://docs.xmemo.dev/pt-br/docs/security/authentication
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 7db78d94f9134263232f217ac1a0f2eb57b88ca22e0cf065f3048a20722fd448
- Edition-Digest: a26b135c1598fc53dc2259aae6caa541a4cd05512dc5e51e1a89d128830f9265
- Source-Revision: sha256:ee40679d8c2e2aed685ae161cfdb51750fe7be7d9ee62448f8afa4760b35e76c

## 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.

```json
{
  "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.

```text
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.

### Atribuição de agente

Revise qual cliente ou executor gravou uma memória, incluindo rótulos não secretos de agente e instância quando o cliente os envia.

### Controles de privacidade e credenciais

Mantenha o consentimento OAuth, o uso de tokens diretos, o repasse de segredos via ambiente e os limites de suporte visíveis antes de expandir um piloto pessoal ou em equipe.