Token pessoal (PAT)

O token pessoal de acesso (PAT) é a credencial para clientes MCP que aceitam um cabeçalho Authorization — Claude Code, scripts, agentes próprios. Ele age em nome de quem o criou, com exatamente as permissões dessa pessoa.

Cuidado

O token pessoal autentica somente o servidor MCP (POST https://api.taitecnologia.com/mcp). Ele não é aceito nas rotas da API REST — para um sistema chamar a API, use o token de integração.

Criar um token

1. Na plataforma, abra Perfil → Meu Perfil e a aba Agentes de IA. A aba aparece para quem tem a permissão de gerenciar tokens.
2. Clique em Novo token, dê um nome que lembre onde ele será usado e escolha a validade (30, 90, 180 ou 365 dias).
3. Marque Permitir escrita se o agente puder criar e alterar registros. Sem a marca, o token é somente leitura.
4. Clique em Criar token e copie o valor na hora — ele aparece uma única vez.

Formato

tai_pat_<12 caracteres>_<43 caracteres>

São 64 caracteres no total. A TAI guarda apenas um hash do segredo: um token perdido não pode ser recuperado, só revogado e substituído.

Usar o token

curl https://api.taitecnologia.com/mcp \
  -H "Authorization: Bearer tai_pat_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Veja Conectar um agente para a configuração no Claude Code e em outros clientes.

Escopos

Escopo	O que permite
mcp:read	Consultar dados. É o padrão de todo token.
mcp:write	Também criar e alterar registros, com confirmação no seu cliente de IA. Ações irreversíveis continuam bloqueadas — veja Escrita e segurança.

Limites

Limite	Valor
Tokens ativos por pessoa	5
Validade padrão	90 dias
Validade máxima	365 dias

Revogar

Na mesma aba, clique em Revogar. O efeito é imediato e não pode ser desfeito. A lista mostra quando cada token foi usado pela última vez — a forma de perceber um token esquecido.

Gerenciar pela API

As mesmas ações existem na API REST, autenticadas com o token JWT da pessoa:

Operação	Rota
Criar	POST /mcp/token
Listar	GET /mcp/token
Revogar	DELETE /mcp/token/{id}

Detalhes na referência de MCP e OAuth.