Jak wdrożyć aplikację z Claude Code

Wdróż aplikację z Claude Code w jednej sesji: podłącz Fine Structure przez MCP albo plugin open source i dostań hosting, bazę danych oraz własną domenę.

Dla kogo jest ten poradnik

Osoby budujące w Claude Code, które chcą, żeby dopiero co zbudowany projekt był online, z hostingiem, danymi i logowaniem po stronie platformy.

Co otrzymasz

- Działająca ścieżka wdrożenia z Claude Code do żywego adresu w jednej sesji

- Jasny obraz tego, co platforma hostuje za ciebie: strony, bazę danych, logowanie, domeny

- Uczciwy test na to, kiedy lepszy będzie hosting statyczny

Co właściwie znaczy wdrożenie z Claude Code?

Żeby wdrożyć aplikację z Claude Code, trzeba podłączyć Claude do runtime, który potrafi ją hostować. W Fine Structure są dwa wejścia: dodać https://finestructure.ai/api/mcp jako własny konektor w ustawieniach claude.ai i zatwierdzić ekran OAuth, albo zainstalować plugin open source poleceniem /plugin marketplace add finestructure-ai/claude-plugin, a potem /plugin install finestructure@finestructure. Dalej Claude generuje kompletną aplikację przez create_app albo przenosi twój istniejący projekt do runtime platformy plik po pliku, a efekt działa jako hostowane strony React z zarządzaną bazą danych, logowaniem, własną domeną i przywracaniem zapisanych wersji. Darmowy plan nie wymaga karty: generowanie zużywa kredyty, a edycje, publikacja i domeny są bezpłatne.

Claude Code świetnie tworzy aplikację i zupełnie nie potrafi jej uruchomić. Sesja kończy się folderem na dysku: komponenty React, model danych, który ukształtował się w trakcie rozmowy, i logowanie zakładające, że gdzieś stoi serwer. Wdrożenie to moment, w którym ten folder dostaje adres, bazę danych i logowanie działające także dla innych ludzi.

Zwykła odpowiedź to hydraulika: wypchnąć do repozytorium, podpiąć CI, postawić bazę danych gdzie indziej, dodać usługę logowania, ustawić DNS, poczekać na certyfikaty. Każdy element z osobna brzmi rozsądnie, a suma zjada całe popołudnie. Druga odpowiedź to dać Claude Code bezpośredni dostęp do runtime, który te elementy ma już w środku, żeby wdrożenie było jednym wywołaniem narzędzia w tej samej rozmowie.

Uczciwe postawienie sprawy: Nasza platforma nie jest przyciskiem deployu przykręconym do twojego obecnego stacku. Jest runtime, a aplikacja się do niego przeprowadza. To realna wymiana: dostajesz hosting, bazę danych, logowanie i domeny bez składania ich samodzielnie, a oddajesz kontrolę nad warstwą serwera.

Jak podłączyć Claude do Fine Structure?

Dwie drogi, ten sam cel: to samo konto i te same aplikacje. Wybierz konektor, jeśli większość pracy dzieje się w claude.ai. Wybierz plugin, jeśli mieszkasz w terminalu i chcesz mieć polecenia wdrożeniowe obok kodu.

Droga 1: konektor MCP: Otwórz ustawienia w claude.ai, wybierz Add custom connector, wklej https://finestructure.ai/api/mcp jako URL i zatwierdź ekran OAuth. Jedno kliknięcie, żadnego API key, żadnej zmiennej środowiskowej mieszkającej w dotfile. Claude widzi wtedy około 70 narzędzi: tworzenie aplikacji, zapis plików, entities, publikację, domeny i analitykę.

Droga 2: plugin open source do Claude Code: Uruchom /plugin marketplace add finestructure-ai/claude-plugin, a potem /plugin install finestructure@finestructure. Do sesji dochodzą /deploy, /fs-status i /fs-domain. Kod jest jawny, więc możesz przeczytać, co wysyła, zanim go zainstalujesz, zamiast ufać opisowi.

O katalogach: Nasze zgłoszenia do katalogów są w trakcie weryfikacji. Dopóki się nie zakończą, nie nazwiemy konektora ani pluginu oficjalnym, zweryfikowanym czy wpisanym na listę. Instaluj je dlatego, że adres jest jawny, a kod da się przeczytać, nie dla odznaki.

Wygenerować nową aplikację czy przenieść projekt, który już masz?

Tryby wdrożenia są dwa. Pierwszy zaczyna się od zdania: create_app przyjmuje prompt i tworzy kompletną aplikację ze stronami, schematami entities, podpiętym logowaniem i działającym adresem. To szybka ścieżka, kiedy pomysł jest jeszcze miękki, a najkrótszą drogą do jego zrozumienia jest po prostu go zobaczyć. Generowanie zużywa kredyty i jest jedyną rozliczaną częścią całej drogi.

Drugi tryb przenosi projekt, który już masz. Claude czyta twoje pliki i przepisuje je pojedynczo do runtime platformy: strony stają się stronami platformy, model danych staje się entities, wywołania logowania stają się logowaniem platformy. To port, nie ślepy upload. Każdy plik, który zakładał serwer pod twoją kontrolą, zostaje napisany od nowa pod runtime, i właśnie tu Claude Code zarabia na swoje miejsce.

Jak wygląda realistyczna pierwsza sesja: Poproś Claude o utworzenie aplikacji, otwórz preview i dalej edytuj pliki w tej samej rozmowie, aż strony będą wyglądać dokładnie tak, jak w zamyśle. Edycje plików i publikacja nie zużywają kredytów, więc pętla po generowaniu jest darmowa. Kiedy wygląda dobrze, publikuj, podłącz domenę i pozwól, żeby TLS załatwił się sam.

Jak to wypada w porównaniu z wdrożeniem na hosting statyczny?

Hostingi statyczne są bardzo dobre w tym, co robią. Jeśli twoim efektem jest bundle frontendu i nic więcej, podadzą go szybciej, taniej i z większym ekosystemem niż my. Porównanie robi się ciekawe dopiero wtedy, gdy aplikacja potrzebuje stanu, użytkowników i drogi powrotnej.

Czego potrzebuje aplikacja | Fine Structure | Statyczny cel wdrożenia

Hosting | Hostowane strony React z runtime platformy | Najlepsza czysta szybkość frontendu i najszerszy ekosystem

Baza danych | Zarządzane entities, gotowe przed pierwszym wdrożeniem | Własna, stawiana osobno

Logowanie | Wbudowane, z sesjami i użytkownikami dla każdej aplikacji | Własna usługa logowania lub zewnętrzny dostawca

Domeny | Własna domena z automatycznym TLS | Własna domena z automatycznym TLS, dojrzały proces

Rollback | Przywrócenie zapisanej wersji aplikacji | Ponowne wdrożenie wcześniejszego builda lub cofnięcie commita

Agenci | Agenci AI, którzy pracują dalej według harmonogramu | Brak, trzeba uruchomić ich gdzie indziej

Kiedy jesteśmy złym wyborem: Trzy przypadki, w których lepsze będzie inne narzędzie, i mówimy to wprost. Własny runtime serwerowy, który musi być twój, na przykład binarka w Go albo worker w Pythonie z konkretnymi bibliotekami systemowymi. Monorepo z własnym backendem, którego nie zamierzasz przepisywać. Czysto statyczny hosting na dużą skalę, gdzie wygrywa CDN bez bazy danych.

Co dostajesz po pierwszym wdrożeniu?

Wdrożenie nie jest końcem pracy. To moment, w którym aplikacja zaczyna produkować fakty zamiast opinii. Otwierają się cztery rzeczy i żadna nie wymaga wychodzenia z rozmowy.

Agenci to część, która zaskakuje ludzi. Agent nie jest tu widgetem czatu przyklejonym do strony. To pracownik podpięty do aplikacji, który po zamknięciu laptopa działa dalej według harmonogramu, czyta dane samej aplikacji i potrafi napisać do zweryfikowanego właściciela na WhatsApp albo mailem. Aplikacja sama mówi, że coś się wydarzyło, zamiast czekać, aż ktoś zajrzy.

Wszystko po generowaniu zostaje w tej samej sesji Claude: zmienić plik, opublikować, sprawdzić domenę, przeczytać analitykę, poprawić agenta. Darmowy plan nie prosi o kartę, więc uczciwy sposób oceny wygląda tak: skierować Claude na jedną małą, prawdziwą aplikację i zobaczyć, jak daleko zajdzie.

Najczęstsze pytania

Czy Claude Code sam wdroży aplikację?

Sam nie. Claude Code pisze i edytuje pliki, a potrzebuje celu, który potrafi je hostować. Dodaj nasz konektor MCP albo zainstaluj plugin, a wdrożenie staje się wywołaniem narzędzia: utworzyć aplikację, zapisać pliki, opublikować, podłączyć domenę.

Jaki jest adres serwera MCP Fine Structure?

https://finestructure.ai/api/mcp. W claude.ai otwórz ustawienia, wybierz Add custom connector, wklej ten adres i zatwierdź ekran OAuth. Nie ma API key do skopiowania, a Claude widzi wtedy około 70 narzędzi.

Jak zainstalować plugin wdrożeniowy do Claude Code?

Uruchom /plugin marketplace add finestructure-ai/claude-plugin, a potem /plugin install finestructure@finestructure. Dostajesz /deploy, /fs-status i /fs-domain. Plugin jest open source, a nasze zgłoszenia do katalogów są w weryfikacji, więc nie ogłaszamy statusu oficjalnego.

Czy jest darmowy plan i czy potrzebna jest karta?

Darmowy plan jest i nie prosi o kartę. Wygenerowanie aplikacji zużywa kredyty. Edycje plików, publikacja i własne domeny nie zużywają.

Czy mogę wdrożyć istniejący projekt React zamiast generować nowy?

Tak. Claude przenosi go do runtime platformy plik po pliku: strony stają się stronami platformy, model danych staje się entities, wywołania logowania są przepisywane. To port, nie upload, więc licz się z tym, że pliki zmienią kształt.

Czy platforma obsługuje HTTPS i własne domeny?

Tak. Dodaj własną domenę, a TLS zostanie wystawiony automatycznie. Użyj /fs-domain z terminala albo poproś Claude przez konektor MCP.

Co jeśli wdrożenie zepsuje aplikację?

Przywróć zapisaną wersję. Rollback cofa aplikację do wcześniejszego zapisanego stanu, co zwykle jest szybsze niż diagnozowanie zmiany na produkcji i daje działający punkt odniesienia.

Kiedy to złe narzędzie do zadania?

Kiedy potrzebujesz własnego runtime serwerowego, który musi być twój, na przykład binarki w Go albo workera w Pythonie z konkretnymi bibliotekami systemowymi. Kiedy monorepo zachowuje własny backend. Albo kiedy chcesz czysto statycznego hostingu na dużą skalę, gdzie wygrywa CDN bez bazy danych.