
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.
Nesta página · 11 seções
- Primeiro: o que o Claude Code fez é um site estático?
- Passo 1: conectar o Claude Code ao Hoster
- Passo 2: pedir a publicação
- Passo 3: abrir o endereço
- Se quiser um domínio seu
- O que costuma dar errado
- O que o Hoster não faz
- Perguntas frequentes
- Para continuar lendo
- Do localhost para um endereço com HTTPS
- 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:
O Claude Code roda o build e confirma onde a pasta foi gerada.
Ele cria o projeto
meu-site, se ainda não existir. O nome do projeto é o subdomínio.Ele chama
hoster_deploy_ticket, e o Hoster devolve um comando pronto, no formatobunx @ciromaciel/hoster-cli push ht_… --dir ./dist.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.
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.htmlna 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
Quem escreveu
Continue lendo
Onde hospedar uma SPA em React ou Vite sem quebrar as rotasMais sobre Hoster · · 5 min
Como publicar um site estático com HTTPS e domínio próprioMais sobre Hoster · · 6 min
Como receber um aviso quando o meu site sair do ar, de graçaMais recente · · 5 min
Como cobrar assinatura num app feito com IA e liberar acesso só para quem pagouMais recente · · 5 min
Qual o jeito mais simples de colocar login num app que eu fiz com IAMais recente · · 5 min
Como mandar e-mail de confirmação e de senha pelo meu app sem configurar servidor de e-mailMais recente · · 5 min