# Chaves e tokens

URL: /administrar/chaves

Tokens pessoais, chaves de ingestão de erros e credenciais de serviço: para que serve cada uma.

O Mira usa quatro tipos de credencial no dia a dia, e o token de migração, que só existe durante uma [migração entre instâncias](/administrar/migracoes).

| Credencial | Para quê | Quem gerencia | Onde |
| --- | --- | --- | --- |
| **Token pessoal** | Seu acesso à API e à CLI | Cada pessoa | **Configurações do Mira → Tokens pessoais** |
| **Token de agente** | Um agente de IA ler e comentar reports pelo MCP | Cada pessoa | **Conectar agente**, no menu do perfil |
| **Chave de ingestão** | Aplicação enviar erros ao Mira | Admin ou Mantenedor | **Configurações do projeto → Erros** |
| **Credencial de serviço** | Sistema externo consultar o Mira sem login humano | Administrador | **Administração do Mira → Serviços de API** |

## Tokens pessoais [#tokens-pessoais]

Em **Tokens pessoais**, a tabela mostra o nome, o prefixo, o último uso e a data de criação. Para criar:

1. Clique em **Novo token** e informe um nome.
2. Confirme a senha da sua conta.
3. Copie o segredo. Ele aparece uma única vez.

Para revogar, abra o menu **…** do token e confirme. Um token herda seu acesso: trate como uma senha. Para usar tokens na CLI, no MCP ou na API, veja [Tokens e escopos](/desenvolvedores/tokens).

## Chaves de ingestão [#chaves-de-ingestão]

Cada ambiente gera as próprias chaves de ingestão, que permitem à aplicação enviar erros. Elas só escrevem: não leem nada do Mira.

<Steps>
<Step>

### Abrir a seção Erros [#abrir-a-seção-erros]

Em **Configurações do projeto → Erros**, escolha o ambiente no seletor do topo.

</Step>
<Step>

### Gerar a chave [#gerar-a-chave]

Dê um nome à chave, como `web`, e clique em **Gerar chave**. A tabela mostra o DSN.

<Figure src="/images/integrate-ingest-key.png" alt="Tabela de chaves de ingestão com o DSN da chave web" caption="O DSN vem da chave gerada." />

</Step>
<Step>

### Entregar ao time de desenvolvimento [#entregar-ao-time-de-desenvolvimento]

Copie o DSN pelo botão da linha e passe para quem integra a aplicação.

</Step>
</Steps>

Cada chave vale só para o ambiente em que foi gerada. **Revogar** pede confirmação, não tem volta, e faz as aplicações que usam aquele DSN pararem de enviar ocorrências. As chaves revogadas continuam na tabela, riscadas.

## Credenciais de serviço [#credenciais-de-serviço]

Em **Administração do Mira → Serviços de API**, administradores criam identidades para sistemas externos, definem os projetos permitidos, o acesso a evidências e a quota. Em **Chaves**, emitem credenciais com validade e as revogam uma a uma. Desativar a identidade revoga todas as chaves dela. O uso técnico está em [API](/desenvolvedores/api).

## Próximos passos [#próximos-passos]

- [Ambientes e origens](/administrar/ambientes)
- [Tokens e escopos](/desenvolvedores/tokens)