O que é
O GW Server é um servidor MCP: você conecta um agente de IA (claude.ai, Claude Code, ChatGPT,
Codex, Cursor ou o nó AI Agent do n8n) ao painel e pede em português o que quer fazer. “Instala o
Mautic em mkt.meusite.com”, “o site está com erro de banco, verifica”, “migra este site da
Hostinger”. O agente descobre sozinho o que pode fazer, segue os roteiros do GW Server e executa
com as mesmas regras do painel: cada acesso usa uma chave com nível, sites e validade que você
escolhe, e tudo fica registrado.
O recurso fica em Configurações → Automação/MCP (Beta). A mesma área também oferece a API para automações, para o n8n e o Make chamarem as ações do painel sem IA no meio.
O Agente de IA está em beta e é recurso do GW Server Pro. No Free, o item do menu mostra o que o recurso faz e o botão Conhecer o Pro. Ver Free e Pro.
O que dá para pedir
O agente trabalha em três camadas:
- As ações do painel: instalar sites e aplicações, cache, PHP, SSL, backup, fail2ban, crons, SMTP, atualizações. São as mesmas ações dos botões, com os mesmos parâmetros e travas.
- Dentro de cada site: arquivos, WP-CLI, banco de dados, logs e comandos, sempre como o usuário Linux do próprio site (nunca como root), com desfazer e ponto de restauração.
- Dentro das aplicações: a API do n8n, da Evolution, do Qdrant, do Typebot, do Chatwoot e do Postiz (ver O agente dentro das aplicações).
Exemplos que a própria tela sugere:
- “Instala o Mautic em
mkt.meusite.come me passa o acesso” - “Instala o GTM Server-Side para o meu site e me diz o que configurar no Google”
- “O site
loja.com.brestá com erro de conexão com o banco, verifica” - “Meu site ficou lento depois da atualização, descobre o porquê”
- “Lista os sites sem backup e configura backup diário”
- “Alguém está atacando o login do WordPress? Bloqueia se estiver”
Também cabem tarefas inteiras: trazer um site de outra hospedagem pelo backup ou por SSH, comparar o site antigo com o novo antes de virar o DNS, procurar malware, publicar um site a partir do Git, montar um relatório de erros e abrir o chamado de suporte com ele, ou atualizar o GW Server e acompanhar até o fim. A lista completa está em O que o agente faz.
Como funciona por dentro
O agente conecta em https://<domínio do painel>/mcp. Ali o painel entrega a lista de ferramentas,
as instruções e os roteiros do GW Server. Cada pedido do agente passa pela mesma verificação da
API: chave válida e no prazo, origem permitida, nível suficiente e o site dentro do escopo da chave.
Parâmetro que a ação não conhece é recusado com a lista dos aceitos, para o agente não “chutar”.
Três garantias valem para tudo:
- Mudança tem volta. Arquivo alterado vira uma entrada que se desfaz; comando, WP-CLI ou SQL que muda algo só roda com um ponto de restauração recente (código + banco), que o servidor cria sozinho.
- O que é destrutivo espera você, se a chave pedir aprovação: o agente para, você aprova ou nega no painel.
- Conteúdo dos sites é dado, não ordem. Logs, páginas e arquivos voltam marcados como dado, e as instruções do agente mandam ignorar qualquer comando escrito neles.
Ativando
- Confirme a licença Pro ativa em Configurações → Licença.
- Configure o domínio do painel com SSL: os agentes recusam o certificado próprio da porta 22222.
- Em Configurações → Automação/MCP (Beta), clique em Ativar módulo.
- Conecte o agente (ver Conectando o agente).
O módulo começa desligado de propósito: nenhuma chave nem acesso existe no servidor até você ativar, e dá para desligar de volta a qualquer momento.
As abas da Automação
| Aba | Para quê |
|---|---|
| Agente de IA | Endereço do conector, conectar com um clique, chave para agente, Testar conexão, aplicações que o agente comanda |
| API para automações | Como chamar a API, exemplos, webhooks de eventos e a referência das ações |
| Chaves | Acesso de fora do servidor, criar, editar, renovar e revogar chaves |
| Atividade | Cada chamada do agente, da API e as recusas, com o motivo |
| Pontos de restauração | Os pontos que o agente criou, para você restaurar sem depender dele |
| Linha de comando | O comando gws, por SSH no próprio servidor |
Quando o agente pede uma aprovação, aparece no topo o cartão Aprovações pendentes.
Por que um servidor MCP e não um script
Um agente com acesso SSH de root faz qualquer coisa, inclusive o que não devia, e não deixa rastro organizado. Pelo MCP ele só alcança o que a chave libera, trabalha dentro do site como o dono do site, sem terminal root, e cada passo fica na Atividade. As instruções que ele recebe vêm dos casos reais de suporte e migração: é o mesmo caminho que eu faria, na mesma ordem.
Beta: como reportar
Enquanto estiver em beta, a tela mostra uma faixa com o link para o suporte: ele abre o chamado já com o assunto “[Beta]” e o roteiro (o que você fez, o que aconteceu, o que esperava). Ferramenta do GW que responde “Erro interno (ID …)” é defeito do GW Server: o próprio agente oferece abrir o chamado com o ID.