O que é
Todo acesso do agente de IA ou de uma automação usa uma chave (começa com gwm_) ou uma
conexão feita com um clique pelo claude.ai ou pelo ChatGPT. A chave define o que pode ser
feito (nível), onde (sites e aplicações), de onde (dentro do servidor, de fora, lista de IPs)
e até quando (validade). Tudo fica em Configurações → Automação/MCP (Beta) → Chaves.
Dê a cada agente ou automação uma chave própria, com o mínimo de que ela precisa: assim a Atividade mostra quem fez o quê, e revogar uma não derruba as outras.
Para que é a chave
Ao criar, você escolhe o uso: Agente de IA (Claude Code, Codex, Cursor…), Automação (n8n,
Make, sistemas) ou Linha de comando (gws, no próprio servidor). O uso muda o que a tela mostra
depois de criar: o comando pronto de cada agente, o exemplo do n8n ou o comando do gws.
Os três níveis
| Nível | O que libera |
|---|---|
| Somente leitura | Consultas: ver sites, aplicações, logs, configurações sem segredo. Não muda nada |
| Operar | Leitura + tarefas do dia a dia: limpar cache, backup, trocar PHP, crons, SSL, ligar e desligar site. Também arquivos, WP-CLI, SQL e comandos dentro dos sites |
| Acesso total | Tudo, inclusive instalar sites e aplicações, configurar o servidor e ver segredos |
No Acesso total aparece a opção Permitir ações destrutivas (excluir site, restaurar backup, importar banco, virar DNS…). Sem ela marcada, essas ações são recusadas mesmo no nível mais alto.
Aprovação do dono
A opção Exigir a minha aprovação (níveis Operar e Acesso total) faz o agente parar e esperar antes de ações destrutivas e de mudanças sem desfazer simples (comando, WP-CLI e SQL que alteram o site, restaurar ponto). Você aprova ou nega no painel. Detalhes em Desfazer, pontos de restauração e aprovação.
Sites e aplicações
- Todos (inclusive os criados depois).
- Só os que eu escolher: marque os sites e aplicações. Com Incluir automaticamente os sites e aplicações criados depois, entra todo recurso que não existia na hora em que você salvou; o que já existia e ficou de fora continua de fora.
Uma chave com lista não vê nem o nome dos recursos de fora: a lista de sites, a visão geral e o relatório de erros vêm filtrados.
Onde a chave é usada
- De fora do servidor (seu computador, o n8n, seus sistemas): exige o Acesso de fora do servidor ligado no topo da aba Chaves.
- Só dentro deste servidor: para agente ou script rodando na própria VPS.
IPs de origem
Para uso de fora, você pode informar IPs de origem (um por linha, IP ou CIDR). Só essas origens entram. É o mais seguro para o n8n e servidores com IP fixo.
Sem lista de IPs a chave entra de qualquer lugar (o caso do agente no notebook, com IP que muda), com travas conferidas a cada chamada:
- validade de até 30 dias;
- um e-mail para você a cada IP novo (exige o SMTP do painel);
- nível no máximo Operar: Acesso total e destrutivas só com a aprovação ligada.
Editar o arquivo de configuração na mão não afrouxa essas travas: o painel confere de novo em toda chamada.
Validade
As opções são 7 dias, 30 dias, 90 dias, 1 ano e Sem validade; sem lista de IPs, só até 30 dias. Vencida, a chave para de funcionar até ser renovada (botão de renovar na lista; mudar a validade na edição renova a partir do dia).
As conexões feitas com um clique (claude.ai, ChatGPT, Claude Code) ficam ativas enquanto usadas: cada uso empurra o prazo, e só vencem depois de 30 dias paradas. Elas aparecem na lista de chaves com o selo de quem conectou e quem autorizou.
Revogar
Revogar corta na hora: a próxima chamada daquela chave ou conexão já é recusada. Numa conexão com um clique, se alguém reaproveitar um token antigo (sinal de que o segredo vazou), o painel derruba a conexão inteira e avisa você por e-mail.
A chave cli-root é a do próprio servidor (root via SSH), usada pelo comando gws.
Atividade
A aba Atividade junta as chamadas do agente (MCP), da API e da linha de comando, as recusas com o motivo em português (chave vencida, origem fora da lista, fora do escopo, proxy não reconhecido) e os avisos de IP novo. É o primeiro lugar para olhar quando um agente “não conecta”.
Limites por chave
No MCP, cada chave tem no máximo 2 chamadas ao mesmo tempo (a terceira recebe “ocupado” na hora) e 120 chamadas por minuto. Ação longa (instalação, backup, atualização) devolve um job, que o agente acompanha até o fim sem segurar a conexão.