Tokens de conta fornecem uma maneira simples de autenticar solicitações de API sem passar pelo fluxo completo de OAuth. Eles são ideais para scripts, pipelines CI/CD e automação pessoal.

## Criando um token

1. Faça login no Glossia e navegue até o painel da sua conta.
2. Abra a **API** seção na barra lateral.
3. Clique **Tokens de conta**, depois **Novo token**.
4. Dê ao token um descritivo **nome** (por exemplo, "CI deploy" ou "CLI access").
5. Escolha os **escopos** que o token precisa. Conceda apenas as permissões mínimas necessárias.
6. Defina uma **data de expiração** ou deixe-a em branco para um token que nunca expira.
7. Clique **Criar token**.

Após a criação, o valor completo do token é exibido **uma vez.**Copie-o imediatamente e armazene-o com segurança. Você não verá o valor completo novamente.

## Usando um token

Inclua o token no `Authorization` cabeçalho de suas solicitações HTTP:

    Authorization: Bearer glsa_abc123def456...

Por exemplo, usando `curl`:

```bash
curl -H "Authorization: Bearer glsa_abc123def456..." \
  https://glossia.ai/api/projects
```

Os tokens de conta seguem o mesmo [modelo de autorização](/docs/reference/apis/authentication) como tokens OAuth. Os escopos do token definem o conjunto máximo de ações que ele pode executar, e as políticas de nível de recurso ainda se aplicam com base nos relacionamentos da sua conta.

## Formato do token

Todos os tokens de conta começam com o `glsa_` prefixo seguido por uma string hexadecimal aleatória. Esse prefixo facilita a identificação dos tokens do Glossia em logs e varredores de segredos.

## Escopos

Tokens de conta suportam os mesmos escopos que os tokens OAuth. Consulte o [referência de escopos](/docs/reference/apis/authentication) para a lista completa.

Ao criar um token, selecione apenas os escopos que seu caso de uso requer. Por exemplo:

- Uma integração somente leitura requer `project:read` e `voice:read`.
- Uma pipeline de CI que cria projetos requer `project:read` e `project:write`.
- Um script que gerencia membros da organização precisa `members:read` e `members:write`.

## Gerenciamento de tokens

### Visualização de tokens

A **Tokens da conta** página lista todos os tokens ativos com nome, escopos, data de última utilização e validade. Tokens que nunca foram usados mostram "Nunca" na coluna de última utilização.

### Editando tokens

Clique no nome do token para editar o **nome** e **descrição**. Os escopos e a expiração não podem ser alterados após a criação. Se precisar de diferentes escopos, crie um novo token e revogue o antigo.

### Revogando tokens

Para revogar um token, clique **Revogar** na lista de tokens ou abra a página de edição do token e use o **Revogar token** botão na zona de perigo. Tokens revogados param de funcionar imediatamente e não podem ser restaurados.

## Melhores práticas de segurança

- **Armazene os tokens com segurança.** Use variáveis de ambiente ou um gerenciador de segredos. Nunca faça commit de tokens no controle de versão.
- **Use tokens de curta duração.** Defina uma data de expiração sempre que possível.
- **Minimize os escopos.** Conceda apenas as permissões que o token realmente precisa.
- **Renove periodicamente.** Crie novos tokens e revogue os antigos em um cronograma.
- **Monitore o uso.** Verifique a data "último uso" periodicamente. Revogue os tokens que não estão mais em uso.
- **Use um token por integração.** Dessa forma, revogar um token não quebra outros fluxos de trabalho.

## Gerenciamento de API

Você também pode gerenciar tokens de conta através da REST API e do servidor MCP.

### REST API

| Método | Endpoint | Descrição |
|--------|----------|-------------|
| `GET` | `/api/tokens` | Listar tokens ativos |
| `POST` | `/api/tokens` | Criar um novo token |
| `DELETE` | `/api/tokens/:id` | Revogar um token |

### MCP

O servidor MCP expõe `list_tokens`, `create_token`e `revoke_token` ferramentas que espelham a API REST.