O ponto de partida

Claude Code consegue gerar uma landing page, um site institucional simples ou um protótipo navegável sem que você saia do editor. O Site no Ar mantém esses arquivos em um workspace git acessível pelas tools MCP e os transforma em uma URL pública.

Esse é o espaço onde o Site no Ar entra. Em vez de abrir um painel de hospedagem, criar projeto, arrastar arquivos e repetir tudo quando o agente muda um asset, você dá uma instrução objetiva para o Claude Code publicar pelo MCP.

A promessa correta não é que todo site fica pronto magicamente sem revisão. O ganho está em tirar o deploy manual do caminho. O agente edita os arquivos, publica uma Version, acompanha o status e devolve a URL para você conferir.

Antes de pedir o publish

O publish fica rápido quando o pedido já traz as decisões que normalmente virariam perguntas no meio do caminho:

  • qual Site deve ser alterado;
  • se a página inicial está em public/index.html;
  • qual slug você quer usar para a URL pública;
  • se o site precisa de domínio próprio agora ou se isso fica para uma segunda etapa;
  • se o agente deve abrir a URL final e conferir o resultado.

Se o MCP ainda não estiver conectado, comece pela configuração geral ou pelo guia de Claude Code. Depois disso, o publish vira uma etapa natural dentro da própria conversa.

Prompt pronto para usar no Claude Code

Depois da conexão, use um pedido curto e verificável:

Chame get_context e crie ou atualize os arquivos deste Site em public/.
Slug: minha-landing
Use public/index.html como página inicial e publique com deploy.
Depois abra a URL publicada e confira se a página inicial carregou corretamente.

O importante é não deixar o agente adivinhar o Site e garantir que o conteúdo servido permaneça sob public/.

O que acontece por trás do pedido

O fluxo usado pelo agente segue o mesmo contrato descrito na documentação de publicação:

Etapa O que o agente faz O que você deve observar
Escolher ou criar o Site Define onde os arquivos serão publicados O slug precisa representar o projeto certo
Inspecionar o Site Chama get_context e lista os arquivos O Site ID precisa ser o destino aprovado
Editar arquivos Usa as file tools no workspace do Site public/index.html vira a rota /
Acompanhar o deploy Espera a publicação terminar Erros devem voltar com próxima ação clara
Entregar a URL Retorna o link final A página precisa abrir fora do ambiente local

Arquivos .html sob public/ viram páginas. Outros assets continuam em seus caminhos. Assim, public/assets/hero.png é servido como asset, enquanto public/sobre.html vira /sobre.

Verifique antes de compartilhar

Mesmo quando o publish é automático, a validação continua sendo parte do trabalho. Peça para o Claude Code abrir a URL final e conferir pelo menos:

  • se a home carrega a partir de public/index.html;
  • se imagens, fontes e folhas de estilo aparecem corretamente;
  • se links internos importantes apontam para rotas existentes;
  • se o slug publicado e o slug pedido são o mesmo;
  • se algum formulário, script ou integração precisa de variáveis de ambiente fora do site estático.

Essa checagem evita confundir “arquivo enviado” com “experiência pronta para enviar ao cliente”. O Site no Ar remove a fricção de hospedagem, mas não substitui a revisão do que foi gerado.

Quando usar esse fluxo

O fluxo é especialmente útil quando você está iterando com agente:

  • rascunhos de landing page para validar uma oferta;
  • páginas de campanha que mudam várias vezes no mesmo dia;
  • protótipos navegáveis que precisam de uma URL para feedback;
  • entregas de freelancer ou agência que precisam sair do editor para o cliente ver;
  • demos internas que não merecem um projeto de infraestrutura completo.

Para projetos com domínio próprio, publique primeiro no slug temporário e confira o conteúdo. Depois avance para Custom Domain com um pedido separado, já sabendo que a versão publicada está correta.

O próximo pedido

Se você ainda está configurando o ambiente, siga o guia de Claude Code e deixe o MCP autenticado. Depois peça o publish com Site, slug e critérios de verificação.

O último passo deixa de ser “abrir um painel de deploy” e passa a ser uma instrução: publique estes arquivos, retorne a URL e mostre o que foi colocado no ar.