# Migração

Migre de uma configuração legada ou de cliente direto preservando os limites de escopo, identidade e exclusão.

- Canonical: https://docs.xmemo.dev/pt-br/docs/migration
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: fb66f83d45da488fee5cccfe9563c1ab56211a358d339b0f73df16cfed352b5f
- Edition-Digest: fc9a4e3ddaba31fb69d06bb063e207cc4865836945c6ca1722c6acf6775e4bdb
- Source-Revision: sha256:a9d9383136b66e379e92a66eabd971c6ca172b426fff3067024039b4e2ec6f2e

## Migre de um cliente com token direto para OAuth

Quando um cliente oferecer suporte a OAuth, a troca remove o token bearer armazenado da configuração local. Memória, escopo e atribuição não mudam com a troca — somente o caminho da credencial muda.

- Confirme que o cliente aparece como compatível com OAuth antes de remover XMEMO_KEY.
- Reconecte e aprove memory:read e memory:write.
- Execute um recall inofensivo antes de gravar qualquer coisa.
- Remova o token do arquivo de configuração antigo e do ambiente.

## Antes: configuração com token direto

```json
{
  "mcpServers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:XMEMO_KEY}" }
    }
  }
}
```

## Depois: configuração OAuth

A URL do servidor hospedado é tudo que permanece; a concessão fornece os escopos.

```json
{
  "servers": {
    "XMemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp"
    }
  }
}
```

## Verifique a migração

Leia antes de gravar para que uma credencial quebrada apareça sem alterar a memória armazenada.

```ts
await client.recallContext('current task and recent decisions', {
  preferWorking: true,
});
```