Quando vale configurar

Se você usa Claude Code para criar sites, componentes ou páginas completas, configurar o Site no Ar como servidor MCP evita que o publish vire uma etapa separada. O agente passa a ter uma ferramenta própria para criar ou escolher um Site, enviar arquivos e acompanhar a publicação.

Essa configuração faz sentido quando você quer manter o fluxo dentro do mesmo contexto: o agente lê o código, gera a build, publica os arquivos e retorna a URL final. Você continua revisando o resultado, mas não precisa transformar cada entrega em um processo manual de hospedagem.

Instale o servidor MCP

No terminal, adicione o servidor remoto do Site no Ar ao Claude Code:

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

Se quiser salvar a configuração no projeto, use --scope project para registrar o MCP em .mcp.json. Isso ajuda quando a equipe inteira deve usar o mesmo servidor no mesmo repositório.

O guia oficial de Claude Code mantém esse comando e o fluxo de verificação. A página de configuração também lista os caminhos para outros clientes, como Codex, Cursor, Gemini CLI, ChatGPT, OpenCode e Claude web.

Autentique no Claude Code

Depois de adicionar o servidor, abra o Claude Code e 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

Depois abra /mcp novamente. O objetivo desta etapa é deixar o Claude Code autenticado antes do primeiro pedido de publish, para que o agente não descubra no fim do fluxo que ainda falta login.

Teste a conexão antes do primeiro site

Antes de publicar uma pasta real, use um teste pequeno:

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

O resultado esperado é simples: o agente consegue usar o MCP ou informa qual etapa de login/configuração ainda falta. Se aparecer erro de autenticação, refaça o fluxo pelo /mcp. Se a conta não tiver assinatura ativa, o agente deve apontar esse bloqueio em vez de seguir tentando publicar.

Primeiro publish controlado

Com a conexão pronta, faça um pedido com escopo fechado:

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 virou a rota principal.

Esse prompt contém as três informações que mais evitam ambiguidades:

  • os arquivos sob public/ que serão publicados;
  • o slug que você quer usar;
  • o arquivo que deve virar a rota principal.

O restante segue o contrato de publicação: arquivos .html sob public/ viram páginas, public/index.html vira /, e CSS, JavaScript, imagens e fontes permanecem como assets em seus caminhos.

Erros comuns e como reagir

Sintoma O que fazer
sitenoar não aparece em /mcp Rode /reload-plugins e abra /mcp de novo
401 Entre no Site no Ar novamente pelo fluxo do Claude Code
402 Verifique a assinatura da conta antes de tentar publicar
Slug ocupado Peça ao agente para aceitar uma sugestão da API ou escolha outro slug
A URL abriu sem estilos Confira se public/ inclui CSS, JS, imagens e fontes

Esses casos devem aparecer como próximas ações claras. Se o agente retornar apenas um erro bruto, peça para ele explicar qual passo falhou: autenticação, limite da conta, upload, deploy ou verificação da URL final.

Boas regras para deixar no projeto

Quando o repositório tem instruções para agentes, vale deixar uma regra curta perto do build ou do README:

Para publicar no Site no Ar, use o MCP sitenoar.
Publique a pasta de build indicada pelo projeto.
Nunca envie arquivos sem confirmar qual index.html vira a home.
Depois de publicar, retorne a URL final e confira a página no navegador.

Isso reduz variação entre sessões e impede que o agente invente um caminho alternativo de hospedagem quando o contrato do projeto já está definido.

O que vem depois

Com o Claude Code configurado, você pode tratar publicação como parte do ciclo normal de trabalho: gerar, ajustar, buildar, publicar e verificar. Para entender melhor o motivo desse blog existir, leia também O agente terminou o Site. E agora?.

Quando o primeiro publish funcionar, o próximo passo é padronizar os prompts de entrega: pasta, slug, arquivo inicial, URL esperada e critério de verificação. Isso transforma o Site no Ar em uma etapa previsível do fluxo do Claude Code, não em um painel extra no fim do projeto.