O que o plugin do Fine Structure adiciona ao Claude Code?
O Fine Structure (finestructure.ai) é uma plataforma de aplicações full-stack. Ela oferece hospedagem, um banco de dados gerenciado cujas tabelas se chamam entities, autenticação, domínios próprios com TLS automático, armazenamento de segredos, reversão para versões salvas e agentes de IA. A integração com o Claude Code é um plugin de código aberto para o Claude Code, com licença MIT, publicado em https://github.com/finestructure-ai/claude-plugin.
Instalar faz duas coisas. Adiciona um conjunto curto de comandos de barra à sua sessão e registra um conector MCP apontado para https://finestructure.ai/api/mcp. O conector é o que expõe a plataforma ao Claude: cerca de 69 ferramentas cobrindo criação de apps, edição de arquivos, modelagem de dados, publicação e leitura de erros e tráfego.
- /deploy faz o deploy do projeto atual e devolve uma URL ao vivo.
- /fs-status informa o status do app, os links e os erros em tempo de execução.
- /fs-domain <domain> conecta um domínio próprio, com um passo a passo de DNS e TLS automático.
Como instalar o plugin de deploy do Claude Code?
A instalação acontece dentro de uma sessão do Claude Code, e não no terminal. Rode estes dois comandos, nesta ordem, no prompt do Claude Code. O primeiro registra o marketplace que hospeda o plugin, o segundo instala o plugin a partir dele.
Assim que a instalação termina, os comandos de barra e o conector MCP ficam ativos na sessão. Não há chave de API para colar, nem arquivo de configuração para adicionar ao repositório, nem etapa de build para ligar.
- /plugin marketplace add finestructure-ai/claude-plugin
- /plugin install finestructure@finestructure
Como funciona a autorização, e para onde vão as chaves de API?
Não existem chaves de API neste fluxo. Na primeira vez que o Claude chama uma ferramenta do Fine Structure, o navegador abre uma tela de consentimento OAuth do Fine Structure. Você entra na conta (existe um plano gratuito e não é preciso cartão), lê o que o conector está pedindo e clica em Autorizar. A partir daí a sessão assume o acesso concedido e segue em frente.
Como a concessão é um consentimento OAuth e não um token copiado, nenhum valor secreto passa pelo histórico do seu terminal nem pelo seu repositório. Uma observação de precisão enquanto você está na tela de consentimento: este é um plugin de código aberto para o Claude Code, não uma listagem oficial ou verificada da Anthropic, e os envios ao diretório ainda estão em análise. O código é público, então ler o repositório é o jeito prático de confirmar o que o conector faz.
Como fazer deploy a partir do Claude Code com o comando /deploy?
Existem dois modos de deploy, e qual deles roda depende do que está na frente do plugin.
O primeiro modo parte de uma ideia, não de uma base de código. Você descreve o app na sessão, o Claude chama create_app com essa descrição e a plataforma gera a aplicação inicial. Rodar /deploy publica o resultado e devolve a URL. O segundo modo parte de um projeto que já está em disco, e ele aparece na próxima seção porque se comporta de outro jeito.
Um primeiro deploy de uma ideia nova é assim.
- Abra o Claude Code no diretório de onde você quer trabalhar.
- Descreva em linguagem natural o app que você quer, ou aponte o Claude para o projeto existente.
- Rode /deploy.
- Aprove a tela de consentimento OAuth se este for seu primeiro uso do conector.
- Abra a URL devolvida. O app é servido em <name>.finestructure.ai até você conectar um domínio próprio.
Como publicar um projeto local já existente a partir do Claude Code?
Um projeto existente é portado arquivo por arquivo para o runtime React da plataforma. O Claude lê seu código e o recria no layout do runtime: telas em pages/, código de interface compartilhado em components/. Imports, convenções de rotas e acesso a dados são reescritos para caber na plataforma, e não copiados literalmente. É um port, não um upload cego de arquivos.
Essa distinção ajusta a expectativa certa. O resultado é um app funcionando no formato da plataforma, não um espelho idêntico do seu repositório, então revise os arquivos portados como você revisaria um pull request. Cada escrita de arquivo cria uma versão salva, o que significa que uma reescrita que saiu errada pode ser revertida em vez de desfeita na mão.
Uma ordem de trabalho sensata: porte uma página e os dados que ela lê, faça o deploy dessa fatia, confirme que o runtime se comporta como você espera e só então leve o resto.
Conferir status, erros de execução e tráfego depois do primeiro deploy
/fs-status é a leitura mais rápida de um app publicado. Ele devolve o status atual, os links do app e os erros em tempo de execução do app ao vivo, o que costuma bastar para separar um problema de build de algo que falha no navegador.
O Claude tem ferramentas mais finas sobre o mesmo terreno. get_errors puxa os erros em tempo de execução para que a correção seja feita e publicada na mesma sessão. get_app_analytics devolve visualizações, visitantes únicos, páginas mais acessadas, origens de tráfego e divisão por dispositivo. publish_app coloca o estado atual no ar quando você quer controlar o momento da publicação em vez de publicar a cada edição.
Como conectar um domínio próprio com TLS automático?
Enquanto nenhum domínio está conectado, o app responde em <name>.finestructure.ai. Para levar tudo para o seu próprio endereço, rode /fs-domain app.example.com na sessão.
O comando mostra os registros DNS a adicionar no seu registrador e depois verifica se eles resolvem. Os certificados TLS são emitidos e renovados automaticamente assim que o domínio é verificado, então não há arquivo de certificado para instalar nem renovação para agendar. A propagação de DNS é a parte lenta desta etapa e fica fora do controle da plataforma, então dê tempo a ela antes de concluir que algo falhou.
O que mais o conector permite o Claude fazer?
O deploy é uma fatia do conjunto de ferramentas. O resto passa a importar quando o app tem usuários e dados de verdade.
- Entities: defina esquemas de banco de dados e trabalhe com os registros direto da sessão.
- Versões salvas: cada edição de arquivo é versionada, então reverter é uma operação de rotina e não uma emergência.
- Segredos: mantenha fora do código que você edita as credenciais de que o app precisa em execução.
- Políticas de acesso: proteja páginas atrás do login para que só usuários autenticados cheguem a elas.
- Analytics: visualizações, visitantes únicos, páginas mais acessadas, origens de tráfego e dispositivos.
- Agentes: agentes de IA que rodam como parte do app em vez de como um script externo que você precisa hospedar.
Quando não usar isso como hospedagem para o Claude Code?
Esse caminho serve para trabalho em formato de app: um front end React, dados em entities, usuários atrás de autenticação, publicado e revisado a partir da sessão. Três casos se encaixam mal, e sai mais barato perceber isso antes do port do que depois.
Há também uma questão de fluxo de trabalho que não tem nada a ver com funcionalidades. Se o seu time trata o git como fonte da verdade, com revisão obrigatória e CI que precisa passar antes de qualquer coisa ir ao ar, então uma plataforma em que o assistente edita arquivos publicados diretamente exige uma convenção combinada sobre o que volta para o repositório. Resolva isso antes do primeiro deploy, não depois.
- Você precisa de um runtime de servidor específico. Se o serviço tem que rodar Go, Rust, uma versão fixa de Python ou um processo worker de longa duração, um runtime React é o alvo errado.
- Você tem um monorepo com backend relevante. Portar um front end é viável; um repositório cujo valor está em serviços de backend, pacotes internos compartilhados e um pipeline de build próprio vai brigar com o port em vez de se beneficiar dele.
- Você só precisa de hospedagem de arquivos estáticos. Para um site estático sem banco de dados, sem autenticação e sem lógica de servidor, uma hospedagem no estilo Vercel ou Netlify é mais simples e mais fácil de entender.
Perguntas que as pessoas realmente fazem
- O plugin do Fine Structure para Claude Code é oficial?
- Não. É um plugin de código aberto para o Claude Code, com licença MIT, publicado em github.com/finestructure-ai/claude-plugin. Os envios ao diretório estão em análise, então ele não deve ser descrito como oficial, verificado ou listado no diretório da Anthropic.
- Preciso de cartão de crédito para fazer deploy a partir do Claude Code?
- Não. O Fine Structure tem plano gratuito, e a tela de consentimento OAuth que abre no primeiro uso não pede dados de cartão. Você entra na conta ou cria a conta ali e clica em Autorizar, e o deploy continua na sessão.
- O que o comando /deploy no Claude Code faz de verdade?
- Ele faz o deploy do projeto atual e devolve uma URL ao vivo. Para uma ideia nova, ele trabalha junto com create_app, que primeiro gera a aplicação a partir da sua descrição. Para um projeto local já existente, os arquivos são portados para o runtime React da plataforma e depois publicados.
- Dá para fazer deploy de um projeto React existente a partir do Claude Code?
- Dá, com a ressalva de que é um port e não um upload. O Claude recria suas telas e componentes compartilhados no layout da plataforma (pages/ e components/) e adapta imports e acesso a dados ao runtime. Revise os arquivos portados antes de publicar, como faria com qualquer código gerado.
- Como aponto meu próprio domínio para um app publicado a partir do Claude Code?
- Rode /fs-domain yourdomain.com na sessão. O comando entrega os registros DNS para adicionar no seu registrador, confere a verificação e provisiona TLS automaticamente. Até o domínio ser verificado, o app continua acessível em <name>.finestructure.ai.