Automatizar não é pular a verificação

Automatizar o deploy de sites com Claude Code via MCP funciona melhor quando o pedido descreve o contrato inteiro: qual pasta publicar, qual slug usar, qual arquivo vira a home e como conferir a URL final.

O ganho não está em fingir que a publicação virou mágica. O ganho está em transformar uma sequência repetitiva em um fluxo que o agente consegue executar dentro do próprio projeto: preparar a saída, enviar arquivos, acompanhar o deploy e devolver evidência do que ficou no ar.

Se o MCP ainda não estiver conectado, comece pela configuração geral ou pelo guia específico de Claude Code. A automação só deve entrar depois que autenticação e checagem de conexão estiverem resolvidas.

O que precisa estar decidido antes do deploy

Antes de pedir para o Claude Code automatizar o deploy, defina as decisões que normalmente geram ambiguidade:

Decisão Exemplo claro
Arquivos publicáveis conteúdo estático mantido sob public/
Página inicial index.html como home obrigatória
Slug lancamento-consultoria ou outro nome aprovado
Escopo do envio apenas arquivos da build, sem pastas temporárias
Critério de sucesso URL abre, home carrega, CSS e imagens aparecem
Critério de bloqueio autenticação, plano, slug ocupado ou asset ausente

Esse checklist evita que o agente publique a pasta errada ou crie um Site novo quando a intenção era atualizar um endereço existente.

Deixe o MCP pronto no Claude Code

O comando de configuração é direto:

Terminal window
claude mcp add --transport http sitenoar https://mcp.sitenoar.dev

Depois, dentro do Claude Code, rode:

/mcp

Selecione sitenoar e entre no Site no Ar quando o Claude pedir. Se o servidor não aparecer na sessão atual, rode /reload-plugins e abra /mcp novamente.

Vale testar a conexão antes do primeiro deploy automatizado:

Use o MCP do Site no Ar e teste a conexão.

O resultado esperado é simples: o Claude Code confirma que consegue usar o MCP ou aponta a próxima ação de login/configuração.

Prompt para automatizar o deploy

Depois que o site estiver pronto ou a build estiver atualizada, use um prompt fechado:

Automatize o deploy deste site pelo MCP do Site no Ar.


1. Revise o projeto e confirme qual pasta é publicável.
2. Rode o build padrão somente se for necessário.
3. Edite os arquivos sob `public/` e publique pelo MCP do Site no Ar.
4. Slug desejado: lancamento-consultoria
5. Use index.html como página inicial.
6. Depois acompanhe o deploy e abra a URL final.


Ao responder, informe arquivos alterados, slug usado, URL final,
status do deploy e resultado da verificação.
Se algo bloquear, pare e explique a próxima ação.

Esse prompt dá autonomia suficiente para o agente completar a tarefa, mas mantém os limites importantes explícitos. Ele também obriga a resposta final a trazer evidência, não só uma frase dizendo que publicou.

O que acontece durante a publicação

O fluxo segue o contrato de publicação:

  1. O agente cria ou escolhe um Site.
  2. O MCP mantém as alterações em uma Session.
  3. O Claude Code cria ou atualiza os arquivos do Site com as file tools.
  4. O Site no Ar publica quando todos os envios terminam.
  5. O agente acompanha o deploy e retorna a URL final.

Arquivos .html viram páginas. index.html vira /. CSS, JavaScript, imagens e fontes continuam como assets no caminho enviado.

Esse ponto é importante para automação: o Claude Code deve trabalhar no repositório do Site pelas file tools, mantendo o conteúdo público em public/ e evitando base64 ou blobs grandes no texto das chamadas.

Como lidar com falhas

Automação boa não ignora erro. Ela transforma erro em próxima ação clara.

Sintoma Próxima ação esperada
401 refazer login pelo /mcp no Claude Code
402 verificar assinatura ativa antes de tentar novamente
Slug ocupado pedir aprovação para usar sugestão da API ou escolher outro slug
Home não encontrada confirmar se public/index.html existe
Página sem estilos conferir caminhos e assets sob public/
Deploy ainda pendente aguardar ou acompanhar até estado final antes de compartilhar

Se o agente responder apenas com um erro bruto, peça para classificar o bloqueio: autenticação, limite da conta, edição de arquivos, deploy ou verificação da URL.

Quando pedir aprovação antes de publicar

Nem todo deploy deve ser automático até o fim. Para rascunhos internos, faz sentido deixar o Claude Code publicar, verificar e devolver a URL. Para páginas de cliente, campanhas pagas ou conteúdo sensível, coloque uma trava antes do deploy:

Mostre os arquivos que serão alterados e o plano de deploy.
Não envie os arquivos ainda.
Depois que eu aprovar, publique pelo MCP do Site no Ar.

Essa variação mantém a automação sem abrir mão de revisão humana. O agente continua fazendo o trabalho repetitivo, mas você decide quando o link público deve mudar.

Como republicar a mesma URL

Depois que o primeiro deploy funciona, a automação fica ainda mais útil para iteração:

Mantenha o mesmo Site e o mesmo slug.
Atualize os arquivos com a nova versão da landing.
Publique de novo pelo MCP do Site no Ar e confira a URL final.

Isso evita criar um Site novo a cada ajuste. Para uma página de campanha, proposta comercial ou protótipo navegável, o ideal é que o link continue estável enquanto o conteúdo evolui.

Se você ainda está começando, leia também Como publicar um site feito no Claude Code em segundos e Do prompt à URL: publicando sites com Claude Code em tempo real. O primeiro mostra o publish básico; o segundo encaixa criação, publicação e verificação no mesmo ciclo de trabalho.

O próximo deploy

O melhor pedido para automatizar deploy no Claude Code não é “coloca isso no ar” de forma genérica. É um contrato curto: Site, slug, public/index.html, arquivos, status e verificação.

Com esse formato, o MCP do Site no Ar vira uma ferramenta operacional dentro do projeto. O Claude Code continua criando e revisando arquivos, mas o fim da tarefa passa a ser uma URL pública verificável, não uma lista de instruções para você hospedar manualmente.