Claude Code buduje workflow n8n — checklista · Zasób

Tę kartę trzymaj otwartą obok rozmowy z Claude Code, gdy zlecasz mu budowę workflowu w n8n. Bloki idą w kolejności realnej pracy: najpierw raz ustawiasz projekt, potem przy każdym workflowie przechodzisz opis, plan, budowę, przegląd i test. Przy każdym bloku masz pola do odhaczenia i jedno zdanie do zapamiętania.

Zasada nadrzędna: agent buduje, ty zatwierdzasz. Żadne pole z tej karty nie przechodzi na agenta tylko dlatego, że walidacja zakończyła się sukcesem.

Projekt i CLAUDE.md (raz na projekt)

Projekt to folder, w którym agent pracuje i zapisuje pliki. CLAUDE.md to stała instrukcja dla tego folderu: po co jest, w jakim środowisku działa agent, jakich zasad się trzyma.

[ ] Utwórz osobny, pusty folder tylko na budowanie workflowów n8n i otwórz go w edytorze z Claude Code.
[ ] Przełącz agenta w tryb planowania, zanim poprosisz o cokolwiek.
[ ] Poproś agenta o przygotowanie CLAUDE.md: projekt służy budowaniu workflowów w twojej instancji n8n z pomocą serwera MCP i skilli n8n.
[ ] Odpowiedz na jego pytania: z jakich narzędzi będzie korzystać i czy n8n działa w chmurze, czy na twoim serwerze.
[ ] Wklej adresy repozytoriów serwera MCP i skilli, żeby agent przeczytał je sam.
[ ] Przeczytaj gotowy plik i sprawdź, czy opisuje kolejność pracy: wymagania, szablony, węzły, budowa, walidacja, wdrożenie.
[ ] Sprawdź, czy plik zawiera zasady bezpieczeństwa; jeśli ich brakuje, dopisz przynajmniej tę: nic nie jest włączane bez mojej zgody.

Projekt bez CLAUDE.md zaczyna każdą rozmowę od zera. Projekt z nim zaczyna od twoich zasad.

Serwer MCP, skille i klucz API (raz na projekt)

Serwer MCP to ręce agenta: katalog węzłów, szablony i dostęp do twojej instancji. Skille to wiedza czytana na żądanie: wyrażenia, konfiguracja węzłów, wzorce, walidacja, kod. Klucz API to hasło, którym agent loguje się do twojego n8n.

[ ] Zleć instalację agentowi: zainstaluj ten serwer i te skille i upewnij się, że działają w tym projekcie.
[ ] Gdy agent zapyta o adres instancji, podaj adres swojego n8n bez dalszej części ścieżki.
[ ] Utwórz w ustawieniach n8n osobny klucz API dla tego projektu i nazwij go tak, żebyś po nazwie wiedział, do czego służy.
[ ] Jeśli twój plan n8n pozwala ograniczyć uprawnienia klucza, daj mu tylko te, których projekt potrzebuje.
[ ] Sprawdź, w którym pliku projektu wylądował klucz, i dopilnuj, żeby ten plik nie trafił do repozytorium ani wspólnego folderu.
[ ] Zrestartuj Claude Code, żeby załadował serwer i skille.
[ ] Przetestuj połączenie: poproś o wyszukanie przez serwer MCP węzła webhook.
[ ] Zapytaj wprost, czy agent może tworzyć workflowy w twojej instancji i czy ma załadowane skille n8n; oczekuj konkretów, nie zapewnień.
[ ] Zapisz datę utworzenia klucza i usuń go, gdy projekt się skończy.

Klucz API do n8n otwiera całą instancję. Traktuj go jak hasło, nie jak ustawienie.

Opis i szkic (przy każdym workflowie)

Agent nie zgadnie, czego nie napisałeś. Opis to twoja jedyna specyfikacja, więc pisz go tak, jak tłumaczyłbyś zadanie programiście.

[ ] Napisz, co uruchamia workflow: godzina, formularz, nowy mail, ręczne kliknięcie.
[ ] Napisz, co ma się stać krok po kroku, zwykłymi zdaniami.
[ ] Napisz, gdzie ma trafić wynik i w jakiej formie: mail, arkusz, wiadomość na komunikatorze.
[ ] Jeśli chcesz kilku agentów AI, opisz każdego osobno: rolę, wejście, wyjście i model, którego ma używać.
[ ] Podaj strefę czasową dla każdej godziny w harmonogramie.
[ ] Narysuj przepływ, choćby odręcznie: co startuje, gdzie się rozgałęzia, dokąd płyną dane. Dołącz zrzut do opisu.
[ ] Napisz wprost, że workflow ma powstać w twojej instancji n8n, a nie jako plik na dysku.
[ ] Oceń rozmiar: jeśli przepływ wychodzi na kilkadziesiąt węzłów, podziel go na części i opisz tylko pierwszą.

Dobry opis to taki, z którym inny człowiek zbudowałby ten sam workflow bez dopytywania.

Plan przed budową

W trybie planowania agent tylko analizuje i proponuje. To najtańszy moment na wyłapanie nieporozumień.

[ ] Wyślij opis w trybie planowania, nie w trybie wykonywania.
[ ] Odpowiedz na każde pytanie doprecyzowujące; jeśli nie znasz odpowiedzi, poproś agenta o wyjaśnienie opcji.
[ ] Przeczytaj cały plan: architekturę, listę węzłów, konfigurację każdego z nich.
[ ] Sprawdź, gdzie workflow ma powstać: w instancji czy jako plik.
[ ] Sprawdź, czy plan używa narzędzi i modeli, które wskazałeś.
[ ] Jeśli coś jest niejasne, zapytaj: dlaczego tak, a nie inaczej.
[ ] Popraw plan jednym zdaniem przed wykonaniem, zamiast przerabiać gotowy workflow.
[ ] Automatyczne wykonanie włącz dopiero wtedy, gdy ufasz planowi.

Korekta planu kosztuje jedno zdanie. Korekta gotowego workflowu kosztuje przegląd od nowa.

Budowa i walidacja

Agent tworzy workflow, waliduje go i sam poprawia błędy konfiguracji. Twoja rola tu to obserwacja, nie klikanie.

[ ] Śledź listę zadań agenta: utworzenie, walidacja, raport.
[ ] Gdy agent zatrzyma się z pytaniem o brakujące dane, odpowiedz, zamiast kazać mu zgadywać.
[ ] Zauważ, które błędy agent poprawiał sam; to pierwsze miejsca do sprawdzenia przy przeglądzie.
[ ] Odbierz link do workflowu i listę następnych kroków.
[ ] Nie włączaj workflowu tylko dlatego, że walidacja przeszła; walidacja sprawdza poprawność konfiguracji, nie zgodność z twoim zamówieniem.

Walidacja mówi, że workflow da się uruchomić. Nie mówi, że robi to, o co prosiłeś.

Przegląd każdego węzła przed włączeniem

To blok, którego nie skracasz. Agent potrafi ustawić inny model niż wskazany i dopisać parametry, o które nikt nie prosił.

[ ] Podłącz sam dane logowania w każdym węźle, który ich wymaga: wyszukiwarka, dostawca modeli, poczta.
[ ] W każdym węźle agenta AI sprawdź model i jego wersję; porównaj z opisem.
[ ] Sprawdź parametry dopisane przez agenta, takie jak limit długości odpowiedzi czy temperatura, i usuń te, których nie chcesz.
[ ] Przeczytaj w całości prompt systemowy każdego agenta: rolę, zakres, format wyniku.
[ ] Przeczytaj wiadomość wejściową każdego agenta i sprawdź, czy wyrażenia wskazują właściwe pola z poprzedniego kroku.
[ ] Sprawdź węzeł wyjściowy: adres odbiorcy, temat, format treści.
[ ] Wypisz decyzje, które agent podjął za ciebie, na przykład wyłączone dopiski albo dodane opcje, i zdecyduj, które zostają.
[ ] Sprawdź harmonogram: godzinę i strefę czasową.

Każdy węzeł, który nie przeszedł przez twoje ręce, jest założeniem, nie konfiguracją.

Przebieg testowy

[ ] Uruchom workflow ręcznie, zanim włączysz harmonogram.
[ ] Prześledź wynik każdego kroku: co znalazł pierwszy agent, co dostał drugi, co wyszło na końcu.
[ ] Sprawdź wynik tam, gdzie trafi naprawdę: w skrzynce, w arkuszu, na komunikatorze.
[ ] Sprawdź, czy wynik zawiera źródła albo dane, o które prosiłeś.
[ ] Dopiero po udanym przebiegu włącz harmonogram.

Pierwszy przebieg robisz ty, patrząc. Harmonogram dostaje tylko to, co już raz widziałeś.

Bezpieczne limity

[ ] Buduj kawałkami: jeden fragment przepływu, przegląd, test, następny fragment.
[ ] Nie zamawiaj workflowu na kilkadziesiąt węzłów w jednej prośbie; zbyt duża prośba potrafi przeciążyć instancję tak, że przestanie odpowiadać.
[ ] Jeśli agent zaczyna ponawiać te same próby po przekroczeniu limitu czasu, przerwij go i podziel zadanie.
[ ] Na instancji w chmurze pamiętaj, że restartu nie zrobisz sam; na własnym serwerze wiedz, jak go zrestartować.
[ ] Gdy agent proponuje, żebyś coś zainstalował albo ustawił sam, a nie musisz tego robić ręcznie, poproś, żeby zrobił to on.

Mniejsza prośba kończy się szybciej i psuje mniej.

Poprawki i kolejne iteracje

[ ] Zlecaj zmiany w tej samej rozmowie: prompt, narzędzie, nowa sekcja.
[ ] Po każdej zmianie sprawdź w n8n, co dokładnie się zmieniło.
[ ] Po każdej większej zmianie powtórz przegląd węzłów i przebieg testowy.
[ ] Gdy nie rozumiesz, co agent zrobił, poproś: wyjaśnij mi to.
[ ] Gdy ta sama poprawka wraca przy kolejnych workflowach, dopisz ją jako regułę do CLAUDE.md.

Agent buduje, ty zatwierdzasz. Ta kolejność nie zmienia się przy żadnej iteracji.