Pular para o conteúdo
Infrastructure
Como publicar um site feito com o Claude Code sem configurar servidor

Como publicar um site feito com o Claude Code sem configurar servidor

O caminho de um site que o Claude Code acabou de gerar até um endereço com HTTPS: o build, o servidor MCP do Hoster, o comando que envia os arquivos e o que fazer quando algo não aparece.

Ciro Cesar Maciel5 min de leituraFeito com ajuda de IA

Nesta página · 11 seções
  1. Primeiro: o que o Claude Code fez é um site estático?
  2. Passo 1: conectar o Claude Code ao Hoster
  3. Passo 2: pedir a publicação
  4. Passo 3: abrir o endereço
  5. Se quiser um domínio seu
  6. O que costuma dar errado
  7. O que o Hoster não faz
  8. Perguntas frequentes
  9. Para continuar lendo
  10. Do localhost para um endereço com HTTPS
  11. Fontes

O Claude Code gerou o site, ele abre no localhost, e agora você quer mandar o endereço para alguém. É aqui que muita gente para: os tutoriais falam de servidor, de certificado, de conectar o GitHub a um painel e de configurar build remoto. Para um site feito com o Claude Code, quase nada disso é necessário. O site vira uma pasta de arquivos prontos, e essa pasta só precisa de um lugar que a sirva com HTTPS.

Primeiro: o que o Claude Code fez é um site estático?

Quase sempre, sim. Um site em Vite, React, Astro ou HTML puro termina, depois do build, numa pasta como dist ou build com HTML, CSS, JavaScript e imagens. Nenhum processo precisa rodar no servidor para entregar esses arquivos.

O Hoster publica exatamente essa pasta. Ele não roda o build por você: o build acontece no seu computador, e o Claude Code sabe fazer isso (npm run build, bun run build ou o que o package.json disser).

Se o projeto tem rotas de API, renderização no servidor ou funções que rodam a cada visita, ele não é estático, e o Hoster não serve para essa parte. A lista do que o Hoster não faz está mais abaixo.

Passo 1: conectar o Claude Code ao Hoster

No terminal, uma vez:

claude mcp add --transport http hoster https://hoster.worker.myinfrastructure.click/mcp

Não há chave no comando nem segredo em arquivo de configuração. Quando o Claude Code chama o servidor pela primeira vez, recebe a indicação de onde fazer o login, abre o navegador, e você entra com um código enviado ao seu e-mail. Depois disso, a conta vem do próprio login: o endereço do servidor é o mesmo para a conta inteira, sem id de projeto.

Dentro do Claude Code, /mcp mostra se o servidor hoster está conectado.

Passo 2: pedir a publicação

Peça em palavras, por exemplo: "faz o build e publica a pasta dist no Hoster, como projeto meu-site". O que acontece por trás:

  1. O Claude Code roda o build e confirma onde a pasta foi gerada.

  2. Ele cria o projeto meu-site, se ainda não existir. O nome do projeto é o subdomínio.

  3. Ele chama hoster_deploy_ticket, e o Hoster devolve um comando pronto, no formato bunx @ciromaciel/hoster-cli push ht_… --dir ./dist.

  4. O Claude Code executa esse comando no seu terminal, com a sua permissão. Os arquivos saem do seu disco direto para o Hoster; eles não passam pela conversa.

  5. Ele confere o estado da publicação e responde com o endereço.

O comando vale para um projeto, um uso e 15 minutos. Se a publicação falhar no meio, o mesmo comando pode ser repetido.

Por que duas partes? O servidor MCP é remoto e não alcança o seu disco. Então ele autoriza, e quem envia os bytes é o comando local.

Passo 3: abrir o endereço

O site responde em https://meu-site.myhoster.click. O HTTPS já vem pronto: não há certificado para emitir nem espera para o cadeado aparecer.

Para atualizar, peça de novo. Cada publicação vira uma versão nova, e o endereço não muda. Se a versão nova quebrou algo, peça "volta para a versão anterior": o Hoster troca a versão ativa sem republicar, e por padrão guarda as 5 últimas.

Se quiser um domínio seu

O projeto pode ganhar um domínio próprio, como meusite.com.br. Você aponta um registro CNAME do seu DNS para proxy.hoster.myinfrastructure.click, e o Hoster emite o certificado para esse domínio também. Se o domínio ficar em pending por horas, quase sempre o CNAME ainda não está resolvendo.

O que costuma dar errado

  • A rota da SPA dá 404 ao recarregar. O Hoster serve o arquivo principal do projeto para rotas sem extensão, que é o que faz o React Router funcionar. Se o build gerou um 404.html na raiz, esse fallback deixa de valer, porque o site passa a ser tratado como páginas separadas.

  • Os arquivos CSS e JS dão 404. O envio apontou para a raiz do repositório em vez da pasta do build.

  • Publiquei e vejo o site antigo. A versão nova chega em até um minuto. Com a estratégia de cache mais agressiva, o navegador de quem já visitou guarda o HTML por mais tempo; a estratégia equilibrada revalida o HTML a cada carga.

  • Coloquei uma chave secreta numa variável de ambiente. As variáveis do Hoster são públicas, lidas pelo navegador em window.ENV. Segredo não vai ali.

O que o Hoster não faz

Para não descobrir depois: o Hoster não roda build no servidor, não tem funções nem SSR, não publica sozinho a cada push no Git, não cria preview por branch e não lê arquivos de redirect como _redirects ou vercel.json. Se o projeto precisa disso, Vercel, Netlify e Cloudflare Pages fazem build remoto e funções; o Hoster serve a quem já tem a pasta pronta e quer o endereço sem configurar nada.

Perguntas frequentes

Preciso de conta no GitHub para publicar?

Não. A publicação sai da pasta do build no seu computador. O código pode nem estar num repositório.

Preciso criar uma chave de API?

Pelo MCP, não. O login no navegador basta, e o comando de envio é a autorização daquele deploy. A chave hk_ existe para quem publica pela CLI por conta própria, por exemplo num CI, e é dos planos Pro e Scale.

Funciona no Cursor e em outros clientes?

O servidor é MCP remoto com login OAuth, então qualquer cliente que aceite servidor MCP remoto conecta pelo mesmo endereço. O envio dos arquivos continua sendo um comando que roda no seu terminal.

E se eu tiver vários sites?

Cada site é um projeto, com o seu subdomínio. A conta sem plano tem um projeto, e ele publica; os planos aumentam o número de projetos.

Para continuar lendo

Do localhost para um endereço com HTTPS

O Hoster publica sites estáticos e SPAs com subdomínio, HTTPS, histórico de versões e domínio próprio, e o Claude Code faz a publicação inteira pelo servidor MCP, com um login no navegador. Conhecer o Hoster

Fontes

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Infrastructure para moderar e responder. O comentário aparece depois de aprovado.