# Tokens de conexão

> Como gerar, usar e revogar a credencial que conecta a sua IA.

## Gerando um token

1. **Abra Integrações**
   No app, vá em Perfil → Integrações, ou abra [a página direto](https://www.app.path-trader.com.br/profile/settings/integrations).
2. **Crie uma nova conexão**
   Dê um nome que identifique onde o token será usado — “Claude no notebook”, “Cursor do trabalho”. Um token por lugar facilita revogar só o que vazou.
3. **Escolha o nível de acesso**
   Somente leitura, ou leitura e edição. Comece pelo primeiro se estiver só experimentando.
4. **Copie o token**
   Ele aparece uma única vez.

> **O token não é recuperável:** Guardamos apenas um hash criptográfico dele. Se você perder o valor, não há como exibi-lo de novo — revogue e gere outro.

## Formato

Todo token começa com o prefixo `ptmcp_` seguido de uma sequência aleatória. Ele é enviado no cabeçalho `Authorization` como um Bearer token.

```http
Authorization: Bearer ptmcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

## Níveis de acesso

| Nível | Escopos | Uso recomendado |
| :-- | :-- | :-- |
| Somente leitura | `trades:read` | Análise e consulta. O assistente não consegue alterar nada. |
| Leitura e edição | `trades:read` + `trades:write` | Registrar operações por conversa. |

## Revogando

Na mesma tela você vê todos os tokens ativos, quando cada um foi usado pela última vez, e pode revogar qualquer um. A revogação é imediata: a próxima requisição daquele token é recusada.

## Boas práticas

- Um token por dispositivo ou aplicativo, nunca um token compartilhado.
- Prefira somente leitura quando você não pretende registrar operações por ali.
- Revogue ao trocar de máquina ou ao parar de usar um cliente.
- Nunca cole o token em um repositório, num print ou numa conversa pública.

> **Quem tem o token acessa sua conta:** O token vale pelo seu acesso às operações. Trate-o como uma senha.

---

Página original: https://www.path-trader.com.br/docs/ia/mcp/tokens