Tokens de agente
Um token permite que um agente aja por si, nunca com mais do que a sua função.
A maioria dos agentes inicia sessão no navegador e não precisa de token (veja Ligar o seu agente). Use um token para CI, máquinas remotas e agentes que não conseguem abrir um navegador.
- Um token por dispositivo ou agente, com uma etiqueta como
cioucursor-work. Os tokens começam porsst_. - É mostrado uma única vez, ao ser criado. O SDD Vault guarda apenas um hash.
- Os tokens só de leitura agem como leitor em todos os projetos; os de leitura e escrita agem com a sua função. Nenhum pode mais do que você, e a constituição continua reservada aos proprietários.
- Um token abrange toda a organização ou os projetos que escolher.
- Os tokens expiram: a duração é obrigatória e a organização pode definir um máximo (
sddvault org security set <ORG> --token-max-days <DAYS>). - Podem ser revogados a qualquer momento; os agentes que os usam ficam desligados na chamada seguinte.
Criar um
Na aplicação, abra Tokens de agente. Ou use a CLI:
O sddvault tokens list lista os seus tokens e o sddvault tokens revoke <ID> revoga um. A aplicação mostra quando, de onde e com que cliente cada token foi usado pela última vez.
Usá-lo
Envie-o como Authorization: Bearer sst_…, ou guarde-o na variável de ambiente SDD_VAULT_TOKEN e referencie-a na sua configuração MCP.
O sddvault init --token escreve um token na configuração dos agentes que não conseguem iniciar sessão no navegador; acrescente --read para o tornar só de leitura.