Chaves e segurança

O agente só faz o que a chave dele permite, nada é liberado sem a sua confirmação, e as suas chaves de outros serviços nunca entram na box

Usar a sua chave do ElevenLabs (ou qualquer outra) na box

Terminal

$ puxadinho secrets set ELEVENLABS_API_KEY --host api.elevenlabs.io <<< "$ELEVENLABS_API_KEY"$ puxadinho secrets select minha-box ELEVENLABS_API_KEY

O valor fica cifrado no servidor. A box vê só um apelido, pxd_secret_ELEVENLABS_API_KEY, e o puxadinho troca pelo valor de verdade na hora de enviar, e só para os hosts que você liberou.
Hosts são nomes exatos, sem curinga (*), até 32 por chave. Repita --host para mais de um.
O valor entra pelo stdin ou por um campo sem eco, nunca como argumento, para não ficar no histórico do terminal. Ele nunca volta: nem a API, nem o painel, nem a box mostram.
Cada box usa só as chaves escolhidas para ela: secrets select, ou --secret NOME no create.
Pelo painel: Chaves.

O agente faz o pedido
Terminal
```
$ puxadinho login --agent
```
Ele recebe um código de 8 letras e números e um link https://www.usepuxadinho.com.br/claim?code=XXXX-XXXX. O setup faz isso sozinho quando roda sem terminal.
Você confere e libera
Abra o link, confira se o código é o mesmo do chat e toque em Liberar. Não foi você? Não fui eu recusa o pedido. Pelo terminal: puxadinho claim XXXX-XXXX.
O agente recebe a chave dele
Uma chave só daquele agente, no seu workspace ativo. Ele aparece em Conectar → Agentes conectados, de onde você pode desconectar.

Terminal

$ puxadinho keys create --name automacao --scope boxes:read --scope boxes:exec$ puxadinho keys ls$ puxadinho keys rm ID_DA_CHAVE

Começam com pxd_live_ e pertencem a um workspace. O valor aparece uma vez só, na criação.
Sem --scope, a chave sai com boxes:read, boxes:write e boxes:exec. Dê só o que a automação precisa.
--expires-in-days faz a chave vencer sozinha (de 1 a 365 dias). Sem isso, ela vale até ser revogada.
Criar e revogar chaves, e mexer nos Secrets, pede papel de dono ou admin.

Escopo	Libera	Ferramentas do MCP
`boxes:read`	Ver boxes, ler arquivos e acompanhar jobs.	list_boxes, get_box, job_logs, job_wait, read_file, get_download_url
`boxes:write`	Criar, pausar, retomar e copiar boxes, gravar arquivos e publicar portas.	create_box, suspend_box, resume_box, fork_box, write_file, get_upload_url, publish_port
`boxes:exec`	Rodar comandos e jobs dentro da box.	exec, start_job
`boxes:ssh`	Entrar na box por SSH.	—
`boxes:delete`	Apagar boxes.	delete_box
`images:read`	Ver snapshots.	list_snapshots
`images:write`	Salvar e apagar snapshots.	save_snapshot
`workspace:admin`	Pessoas, plano, limite de gasto, chaves de API, Secrets e desconectar agentes.	—

Papel	Pode
Dono	Tudo, inclusive plano, pessoas e chaves.
Admin	Tudo, inclusive plano, pessoas e chaves.
Membro	Criar, usar e apagar boxes e snapshots.
Leitor	Só ver boxes e snapshots.

O SSH usa certificados de vida curta: 1 hora por padrão, de 1 minuto a 24 horas com --ttl.
Porta publicada é privada por padrão e exige o token que aparece na hora. --public abre para qualquer um: use só para o que pode ser público.

Desconfiou de alguma coisa? Revogue a chave em Conectar e apague a box. A box apagada some com todos os arquivos.