Come fare il deploy di un'app da Claude Code

Fai il deploy di un'app da Claude Code in una sessione: collega Fine Structure via MCP o con il plugin open source e ottieni hosting, database e dominio.

A chi è rivolta questa guida

Chi costruisce dentro Claude Code e vuole vedere online il progetto appena fatto, con hosting, dati e autenticazione già risolti.

Cosa otterrai

- Un percorso di deploy funzionante, da Claude Code a una URL online in una sola sessione

- Un quadro chiaro di che cosa ospita la piattaforma al posto tuo: pagine, database, autenticazione, domini

- Un criterio onesto per capire quando un host statico è la scelta migliore

Che cosa significa davvero fare il deploy da Claude Code?

Per fare il deploy di un'app da Claude Code occorre collegare Claude a un runtime in grado di ospitarla. Con Fine Structure ci sono due ingressi: aggiungere https://finestructure.ai/api/mcp come connettore personalizzato nelle impostazioni di claude.ai e approvare la schermata OAuth, oppure installare il plugin open source con /plugin marketplace add finestructure-ai/claude-plugin e poi /plugin install finestructure@finestructure. Da lì Claude genera un'applicazione completa con create_app oppure porta il progetto che hai già dentro al runtime della piattaforma, un file alla volta, e il risultato gira come pagine React ospitate, con database gestito, autenticazione, dominio personalizzato e ripristino delle versioni salvate. Il piano gratuito non chiede la carta: la generazione consuma crediti, mentre modifiche, pubblicazione e domini restano gratis.

Claude Code è bravissimo a produrre un'applicazione e del tutto incapace di eseguirla. Una sessione finisce con una cartella sul disco: componenti React, un modello dati che ha preso forma mentre parlavi, un flusso di autenticazione che dà per scontato un server. Il deploy è il momento in cui quella cartella riceve una URL, un database e un login che funziona anche per gli altri.

La risposta abituale è idraulica: push su un repository, CI da collegare, un database da creare altrove, un servizio di autenticazione da aggiungere, il DNS da puntare, i certificati da aspettare. Ogni pezzo è ragionevole e la somma vale un pomeriggio. L'altra risposta è dare a Claude Code accesso diretto a un runtime che quei pezzi li ha già, così il deploy diventa una sola chiamata di strumento nella stessa conversazione.

Il quadro onesto: La nostra piattaforma non è un pulsante di deploy avvitato sopra al tuo stack attuale. È un runtime, e l'applicazione ci si trasferisce dentro. Lo scambio è reale: ottieni hosting, database, autenticazione e domini senza assemblarli, e rinunci al controllo del livello server.

Come si collega Claude a Fine Structure?

Due strade, stessa destinazione: stesso account e stesse applicazioni. Scegli il connettore se lavori soprattutto dentro claude.ai. Scegli il plugin se vivi nel terminale e vuoi i comandi di deploy accanto al codice.

Strada 1: il connettore MCP: Apri le impostazioni in claude.ai, scegli Add custom connector, incolla https://finestructure.ai/api/mcp come URL e approva la schermata OAuth. Un clic, nessuna API key, nessuna variabile d'ambiente che vive in un dotfile. Da quel momento Claude vede circa 70 strumenti: creazione di app, scrittura di file, entities, pubblicazione, domini e analytics.

Strada 2: il plugin open source per Claude Code: Esegui /plugin marketplace add finestructure-ai/claude-plugin, poi /plugin install finestructure@finestructure. Alla sessione si aggiungono /deploy, /fs-status e /fs-domain. Il sorgente è pubblico, quindi puoi leggere che cosa invia prima di installarlo, invece di fidarti di una descrizione.

Sulle directory: Le nostre candidature alle directory sono in revisione. Finché non si chiudono non definiremo il connettore o il plugin ufficiali, verificati o elencati. Installali perché la URL è pubblica e il codice è leggibile, non per un distintivo.

Meglio generare un'app nuova o portare il progetto che hai già?

Le modalità di deploy sono due. La prima parte da una frase: create_app prende un prompt e produce un'applicazione completa con pagine, schemi di entities, autenticazione collegata e una URL funzionante. È la via rapida quando l'idea è ancora morbida e il modo più veloce per capirla è guardarla. La generazione consuma crediti ed è l'unica parte a consumo dell'intero flusso.

La seconda modalità porta dentro un progetto che hai già. Claude legge i tuoi file e li riscrive uno alla volta nel runtime della piattaforma: le pagine diventano pagine della piattaforma, il modello dati diventa entities, le chiamate di autenticazione diventano l'autenticazione della piattaforma. È un porting, non un caricamento alla cieca. Ogni file che presupponeva un server sotto il tuo controllo viene riscritto contro il runtime, ed è lì che Claude Code si guadagna il posto.

Com'è fatta una prima sessione realistica: Chiedi a Claude di creare l'app, apri la preview e continua a modificare i file nella stessa conversazione finché le pagine non somigliano a quello che avevi in mente. Modifiche ai file e pubblicazione non consumano crediti, quindi il ciclo dopo la generazione è gratuito. Quando ti convince, pubblica, collega un dominio e lascia che il TLS si sistemi da solo.

Come si confronta con un deploy su un host statico?

Gli host statici sono bravissimi in quello che fanno. Se il tuo prodotto finito è un bundle frontend e nient'altro, lo serviranno più in fretta, a meno e con un ecosistema più grande del nostro. Il confronto si fa interessante quando l'applicazione ha bisogno di stato, utenti e una via di ritorno.

Che cosa serve all'app | Fine Structure | Destinazione di deploy statico

Hosting | Pagine React ospitate dal runtime della piattaforma | La migliore velocità frontend pura, ecosistema più ampio

Database | Entities gestite, pronte prima del primo deploy | Lo porti tu, va creato a parte

Autenticazione | Integrata, con sessioni e utenti per singola app | Porti il tuo servizio o il tuo provider

Domini | Dominio personalizzato con TLS automatico | Dominio personalizzato con TLS automatico, flusso maturo

Rollback | Ripristinare una versione salvata dell'app | Rifare il deploy di una build precedente o annullare il commit

Agenti | Agenti AI che continuano a lavorare su pianificazione | Non inclusi, vanno eseguiti altrove

Quando siamo la scelta sbagliata: Tre casi in cui un altro strumento è migliore, e lo diciamo. Un runtime server su misura che deve essere tuo, per esempio un binario in Go o un worker Python con librerie di sistema specifiche. Un monorepo con un backend proprio che non riscriverai. Hosting puramente statico su larga scala, dove vince un CDN senza database.

Che cosa ottieni dopo il primo deploy?

Il deploy non è la fine del lavoro. È il punto in cui l'applicazione comincia a produrre fatti invece che opinioni. Si aprono quattro cose, e nessuna richiede di uscire dalla conversazione.

Gli agenti sono la parte che sorprende. Un agente qui non è un widget di chat incollato su una pagina. È un lavoratore agganciato all'applicazione che continua a girare su pianificazione dopo che hai chiuso il portatile, legge i dati dell'app stessa e può scrivere al suo proprietario verificato su WhatsApp o via email. È l'app che ti dice che è successo qualcosa, invece di aspettare che vada tu a controllare.

Tutto quello che viene dopo la generazione resta nella stessa sessione di Claude: cambiare un file, pubblicare, controllare il dominio, leggere gli analytics, regolare un agente. Il piano gratuito non chiede la carta, quindi il modo onesto di valutarlo è puntare Claude su una piccola app reale e vedere fin dove arriva.

Domande frequenti

Claude Code può fare il deploy di un'app da solo?

Da solo no. Claude Code scrive e modifica file e ha bisogno di una destinazione capace di ospitarli. Aggiungi il nostro connettore MCP o installa il plugin e il deploy diventa una chiamata di strumento: creare l'app, scrivere i file, pubblicare, collegare un dominio.

Qual è la URL del server MCP di Fine Structure?

https://finestructure.ai/api/mcp. In claude.ai apri le impostazioni, scegli Add custom connector, incolla quella URL e approva la schermata OAuth. Nessuna API key da copiare, e Claude vede circa 70 strumenti.

Come si installa il plugin di deploy per Claude Code?

Esegui /plugin marketplace add finestructure-ai/claude-plugin, poi /plugin install finestructure@finestructure. Ottieni /deploy, /fs-status e /fs-domain. Il plugin è open source e le nostre candidature alle directory sono in revisione, quindi non rivendichiamo alcuno stato ufficiale.

Esiste un piano gratuito e serve la carta di credito?

Il piano gratuito c'è e non chiede la carta. Generare un'app consuma crediti. Modifiche ai file, pubblicazione e domini personalizzati no.

Posso pubblicare un progetto React esistente invece di generarne uno nuovo?

Sì. Claude lo porta nel runtime della piattaforma un file alla volta: le pagine diventano pagine della piattaforma, il modello dati diventa entities, le chiamate di autenticazione vengono riscritte. È un porting, non un caricamento, quindi aspettati che i file cambino forma.

La piattaforma gestisce HTTPS e domini personalizzati?

Sì. Aggiungi un dominio personalizzato e il TLS viene emesso in automatico. Usa /fs-domain dal terminale, oppure chiedilo a Claude tramite il connettore MCP.

Che succede se un deploy rompe l'applicazione?

Ripristini una versione salvata. Il rollback riporta l'app a uno stato salvato precedente: di solito è più veloce che diagnosticare una modifica in produzione e ti restituisce una base funzionante.

Quando è lo strumento sbagliato?

Quando serve un runtime server su misura che deve essere tuo, per esempio un binario in Go o un worker Python con librerie di sistema specifiche. Quando un monorepo tiene il proprio backend. Oppure quando vuoi hosting puramente statico su larga scala, dove vince un CDN senza database.