Faça o deploy de um app a partir do Claude Code em uma sessão: conecte a Fine Structure via MCP ou pelo plugin open source e ganhe hospedagem, banco e domínio.
Quem constrói dentro do Claude Code e quer ver no ar o projeto que acabou de montar, com hospedagem, dados e autenticação resolvidos.
- Um caminho de deploy que funciona, do Claude Code até uma URL no ar em uma única sessão
- Uma visão clara do que a plataforma hospeda por você: páginas, banco de dados, autenticação e domínios
- Um teste honesto para saber quando um host estático é a melhor opção
Para fazer o deploy de um app a partir do Claude Code, você conecta o Claude a um runtime capaz de hospedá-lo. Na Fine Structure há duas entradas: adicionar https://finestructure.ai/api/mcp como conector personalizado nas configurações do claude.ai e aprovar a tela de OAuth, ou instalar o plugin open source com /plugin marketplace add finestructure-ai/claude-plugin e depois /plugin install finestructure@finestructure. A partir daí o Claude gera uma aplicação completa com create_app ou leva o seu projeto atual para o runtime da plataforma, arquivo por arquivo, e o resultado roda como páginas React hospedadas, com banco de dados gerenciado, autenticação, domínio próprio e restauração de versões salvas. O plano gratuito não pede cartão: a geração consome créditos, enquanto edições, publicação e domínios são de graça.
O Claude Code é muito bom em produzir uma aplicação e completamente incapaz de executar uma. A sessão termina com uma pasta no disco: componentes React, um modelo de dados que tomou forma durante a conversa, um fluxo de autenticação que assume a existência de um servidor. O deploy é o momento em que essa pasta ganha uma URL, um banco de dados e um login que funciona para outras pessoas.
A resposta de sempre é encanamento: subir para um repositório, ligar a CI, provisionar um banco em outro lugar, acrescentar um serviço de autenticação, apontar o DNS, esperar os certificados. Cada peça é razoável e a soma consome uma tarde inteira. A outra resposta é dar ao Claude Code acesso direto a um runtime que já tem essas peças, para que o deploy seja uma única chamada de ferramenta dentro da mesma conversa.
O recorte honesto: Nossa plataforma não é um botão de deploy parafusado na sua stack atual. Ela é um runtime, e a aplicação se muda para dentro dele. A troca é real: você ganha hospedagem, banco de dados, autenticação e domínios sem montar nada disso, e abre mão do controle da camada de servidor.
Dois caminhos, o mesmo destino: a mesma conta e os mesmos apps. Escolha o conector se a maior parte do seu trabalho acontece no claude.ai. Escolha o plugin se você vive no terminal e quer os comandos de deploy ao lado do código.
Caminho 1: o conector MCP: Abra as configurações no claude.ai, escolha Add custom connector, cole https://finestructure.ai/api/mcp como URL e aprove a tela de OAuth. Um clique, nenhuma API key, nenhuma variável de ambiente morando em um dotfile. A partir daí o Claude enxerga cerca de 70 ferramentas: criação de app, escrita de arquivos, entities, publicação, domínios e analytics.
Caminho 2: o plugin open source do Claude Code: Rode /plugin marketplace add finestructure-ai/claude-plugin e depois /plugin install finestructure@finestructure. Isso adiciona /deploy, /fs-status e /fs-domain à sua sessão. O código é público, então dá para ler o que ele envia antes de instalar, em vez de confiar em uma descrição.
Sobre listagens em diretórios: Nossas submissões aos diretórios estão em análise. Até isso terminar, não vamos chamar o conector nem o plugin de oficial, verificado ou listado. Instale porque a URL é pública e o código é legível, não por causa de um selo.
Existem dois modos de deploy. Um começa em uma frase: o create_app recebe um prompt e produz uma aplicação completa, com páginas, esquemas de entities, autenticação ligada e uma URL que funciona. É o caminho rápido quando a ideia ainda está mole e o jeito mais veloz de entendê-la é olhar para ela. A geração consome créditos e é a única parte medida do fluxo.
O segundo modo leva um projeto que você já tem. O Claude lê os seus arquivos e os reescreve um a um dentro do runtime da plataforma: páginas viram páginas da plataforma, o modelo de dados vira entities, as chamadas de autenticação viram a autenticação da plataforma. É uma migração, não um upload às cegas. Todo arquivo que presumia um servidor sob o seu controle é reescrito contra o runtime, e é aí que o Claude Code justifica o lugar dele.
Como é uma primeira sessão realista: Peça ao Claude que crie o app, abra o preview e siga editando arquivos na mesma conversa até as páginas ficarem parecidas com o que você quis dizer. Edições de arquivo e publicação não consomem créditos, então o ciclo depois da geração é gratuito. Quando estiver bom, publique, conecte um domínio e deixe o TLS se resolver sozinho.
Hosts estáticos são muito bons no que fazem. Se a sua entrega é um bundle de frontend e nada além disso, eles vão servir mais rápido, mais barato e com um ecossistema maior que o nosso. A comparação fica interessante quando o app precisa de estado, de usuários e de um caminho de volta.
O que o app precisa | Fine Structure | Destino de deploy estático
Hospedagem | Páginas React hospedadas pelo runtime da plataforma | A melhor velocidade bruta de frontend e o maior ecossistema
Banco de dados | Entities gerenciadas, prontas antes do primeiro deploy | Você traz o seu, provisionado à parte
Autenticação | Embutida, com sessões e usuários por aplicação | Você traz o seu serviço ou provedor
Domínios | Domínio próprio com TLS automático | Domínio próprio com TLS automático, fluxo maduro
Rollback | Restaurar uma versão salva da aplicação | Refazer o deploy de um build anterior ou reverter o commit
Agentes | Agentes de IA que seguem trabalhando em uma agenda | Não incluídos, precisam rodar em outro lugar
Quando somos a escolha errada: Três casos em que outra ferramenta é melhor, e nós falamos isso. Um runtime de servidor sob medida que precisa ser seu, como um binário em Go ou um worker Python com bibliotecas de sistema específicas. Um monorepo com backend próprio que você não vai reescrever. Hospedagem puramente estática em grande escala, onde um CDN sem banco de dados ganha.
O deploy não é o fim do trabalho. É onde a aplicação começa a produzir fatos em vez de opiniões. Quatro coisas ficam disponíveis, e nenhuma delas exige sair da conversa.
Os agentes são a parte que surpreende as pessoas. Um agente aqui não é um widget de chat colado na página. É um trabalhador ligado à aplicação, que continua rodando em uma agenda depois que você fecha o notebook, lê os dados do próprio app e consegue falar com o dono verificado no WhatsApp ou por e-mail. O app avisa que algo aconteceu em vez de esperar que alguém vá conferir.
Tudo o que vem depois da geração continua na mesma sessão do Claude: mudar um arquivo, publicar, checar o domínio, ler o analytics, ajustar um agente. O plano gratuito não pede cartão, então o jeito honesto de avaliar isso é apontar o Claude para um app real pequeno e ver até onde ele chega.
Sozinho não. O Claude Code escreve e edita arquivos e precisa de um destino capaz de hospedá-los. Adicione o nosso conector MCP ou instale o plugin e o deploy vira uma chamada de ferramenta: criar o app, escrever arquivos, publicar e conectar um domínio.
https://finestructure.ai/api/mcp. No claude.ai, abra as configurações, escolha Add custom connector, cole essa URL e aprove a tela de OAuth. Não há API key para copiar, e o Claude passa a enxergar cerca de 70 ferramentas.
Rode /plugin marketplace add finestructure-ai/claude-plugin e depois /plugin install finestructure@finestructure. Você recebe /deploy, /fs-status e /fs-domain. O plugin é open source e nossas submissões a diretórios estão em análise, então não reivindicamos status oficial.
Existe plano gratuito e ele não pede cartão. Gerar um app consome créditos. Edições de arquivo, publicação e domínios próprios não consomem.
Pode. O Claude leva o projeto para o runtime da plataforma arquivo por arquivo: páginas viram páginas da plataforma, o modelo de dados vira entities e as chamadas de autenticação são reescritas. É migração, não upload, então espere que os arquivos mudem de forma.
Sim. Adicione um domínio próprio e o TLS é emitido automaticamente. Use /fs-domain no terminal ou peça ao Claude pelo conector MCP.
Você restaura uma versão salva. O rollback devolve o app a um estado salvo anterior, o que costuma ser mais rápido do que diagnosticar uma mudança em produção e ainda deixa uma base funcionando para comparar.
Quando você precisa de um runtime de servidor sob medida que tem de ser seu, como um binário em Go ou um worker Python com bibliotecas de sistema específicas. Quando um monorepo mantém o próprio backend. Ou quando você quer hospedagem puramente estática em grande escala, onde um CDN sem banco de dados ganha.