Deixar um agente fazer deploy

A resposta curta

O risco é a credencial, não o agente. Um token de leitura de uma única organização pode inspecionar o projeto. Ele não cria nem altera nada até você emitir um token mais amplo.

Deploy com Claude Code, ou com outro agente, pede esse token, uma organização, um projeto e um serviço nomeados, e um deploy que chegue a um estado terminal. A Unbroker é o exemplo. A mesma divisão vale para Claude Code, Codex e Cursor.

O que um agente de código faz quando faz deploy

Ele executa o ubctl, a mesma CLI que você usaria num terminal. Ele não hospeda a aplicação.

As permissões agente de IA são o escopo do token mais o seu papel nessa organização. Instalar o ubctl-ops não cria uma conta, não emite um token e não faz deploy só por estar instalado. Instale a skill depois do ubctl login e leia agentes de código. O Claude Code usa /ubctl-ops. O Codex usa $ubctl-ops.

Comece somente leitura

Comece com um token de leitura e uma tarefa que só liste projetos. Esse token basta para inspecionar. Ele não cria nem altera recursos.

O primeiro prompt do guia de instalação pede a organização ativa e os projetos dela, e diz para não criar nem modificar nada. Confira se ubctl whoami nomeia essa organização. No MCP, um token de leitura pode conectar e listar ferramentas, e uma chamada de escrita devolve um erro de somente leitura. O escopo do token do servidor MCP é esse mesmo escopo de leitura ou de leitura e escrita. A referência está na documentação de MCP.

Um token por agente e por organização

Cada token de API pertence a exatamente uma organização, a que estava selecionada no Cloud quando o token foi criado. Um token de uma organização não entra em outra.

Crie um token separado para cada agente, nessa organização, para revogar um cliente sem mexer nos outros. O Cloud mostra o segredo uma única vez. ubctl login guarda o token localmente com permissão só do dono do arquivo. Não use ubctl login --token num computador compartilhado: o valor pode ficar no histórico do shell. No MCP do Codex, a configuração guarda o nome da variável de ambiente, não o valor do token. Os papéis owner e admin ativam o MCP por organização em Settings, depois Integrations, em https://api.unbroker.cloud/mcp. Veja a documentação de MCP e o registro do MCP.

Deixe os segredos fora da conversa

Carregue os valores secretos no Cloud. Diga ao agente quais chaves o serviço precisa, e não cole os valores no chat, num repositório, num print ou numa issue.

A inspeção de serviços via MCP não devolve credenciais nem valores de variáveis de ambiente. Cada variável tem escopo All, Production ou Preview, e um valor com escopo substitui o All naquele ambiente. Um preview pode usar uma chave de teste sem ler o valor de produção. Isso está em variáveis por ambiente.

Limites antes de mexer em produção

Nomeie a organização, o projeto e o serviço, e espere o deploy terminar. Um deploy na fila não é um release concluído.

O acesso de produção vem depois do passo somente leitura. Previews de pull request exigem Pro, e fechar o pull request remove esse preview. Diga se o agente pode criar recursos. Criar um serviço não faz o deploy dele, e criar recursos ou deixar um serviço rodando pode gerar cobrança. A espera documentada é ubctl apps deploy <serviceId> --wait, que sai com erro se o deploy falhar. O prompt está em Deploy de uma aplicação com Claude Code. O glossário do NIST descreve o menor privilégio como restringir o acesso ao mínimo necessário para a tarefa.

Quando o deploy dá errado

Leia o log do deploy e os logs de runtime, e corrija essa causa antes de tentar de novo. Um rollback é outro deploy, e ele não executa de novo o comando pre-deploy.

ubctl apps rollback promove um deploy anterior. Ele mostra progresso e logs, pode ser cancelado e aparece no histórico. Ele não reconstrói o commit e não restaura um banco nem um volume. Como o pre-deploy é pulado, mantenha as migrações compatíveis com a versão anterior. A CLI também expõe métricas do serviço. Um comando manual avulso, ou uma execução de job, registra quem iniciou e a qual serviço pertence. O texto do comando fica nessa execução, não no feed de atividade de toda a organização. Veja comandos auditados.

Lista antes de deixar o agente fazer deploy

Termine esta lista antes de o token poder alterar a produção. A lista é o limite. Ela não substitui o log do deploy.

1. Crie o token com a organização certa selecionada no Cloud.
2. Use escopo de leitura até ubctl whoami e a lista de projetos coincidirem.
3. Emita um token para este agente, e outro token para cada outra organização.
4. Deixe o segredo fora do prompt, do repositório e do histórico do shell.
5. Nomeie a organização, o projeto e o serviço na tarefa.
6. Carregue os valores secretos no Cloud. Passe ao agente só os nomes das chaves.
7. Espere um estado terminal. Não trate enfileirado como no ar.
8. Use um preview de pull request no Pro, com variáveis de escopo Preview, antes da produção.
9. Se fizer rollback, espere um deploy que pula o pre-deploy. Mantenha as migrações compatíveis com a versão anterior.

Perguntas frequentes

É seguro deixar o Claude Code ou o Codex fazer deploy do meu app?

Só até o limite do token que você deu a esse agente. Um token de leitura lista e inspeciona. Um de leitura e escrita pode criar e alterar recursos, e essas mudanças podem gerar cobrança. Comece pela tarefa somente leitura.

Quais permissões um agente de código precisa?

Inspecionar pede um token de leitura. Criar, fazer deploy ou alterar um recurso pede escopo de leitura e escrita, e as permissões da organização para essa ação. A skill não adiciona permissões próprias. Cada token de API pertence a uma organização.

Devo dar ao meu agente de IA um token de API de produção?

Não na primeira tarefa. Use um token de leitura, confirme a organização com ubctl whoami e use um preview antes da produção. O acesso de produção pode esperar até o projeto e o serviço estarem nomeados.

Como impeço um agente de IA de ver meus segredos?

Carregue os valores no Cloud e passe ao agente só os nomes das chaves. Não cole tokens nem valores de variáveis no chat, no repositório ou num print. A inspeção de serviços via MCP não devolve credenciais nem valores de variáveis.

Posso revogar o acesso de um agente sem quebrar outras integrações?

Sim, se esse agente tiver o próprio token. Revogue esse token em API Tokens. Os outros tokens continuam válidos, e desligar o MCP na organização bloqueia o MCP sem revogar tokens nem o acesso REST.

Se o deploy falhar, dá para voltar atrás?

Sim. ubctl apps rollback promove um deploy anterior. É um deploy de verdade, com progresso e logs, e não executa de novo o comando pre-deploy. Ele não reconstrói o commit e não restaura um banco nem um volume.

O Claude Code hospeda meu app?

Não. O Claude Code executa o ubctl. A hospedagem, o build e a URL pública são Cloud Apps da Unbroker. O mesmo vale para o Codex e para o Cursor quando chamam a mesma API.