Jak podłączyć Claude Code do n8n przez MCP i co agent może wtedy zrobić?

Co daje MCP w połączeniu Claude Code z n8n?

MCP, Model Context Protocol, to standard, przez który agent taki jak Claude Code podłącza zewnętrzne narzędzia. Bez niego agent buduje workflow n8n z pamięci: zgaduje nazwy węzłów, myli parametry, nie wie, co zmieniło się w ostatniej wersji, i nikt nie sprawdza, czy to, co powstało, w ogóle uruchomi się w n8n.

n8n-mcp jest serwerem MCP, który tę lukę zamyka. Zbudowałem go, bo agenci obiecywali budować automatyzacje samodzielnie, a w praktyce zgadywali. Serwer daje agentowi trzy rzeczy:

• Wiedzę zamiast zgadywania. Pełną, aktualną dokumentację wszystkich 1800+ węzłów n8n, z przykładami konfiguracji i szablonami z biblioteki.
• Walidację przed uruchomieniem. Sprawdzenie pojedynczego węzła i całego workflowu: wymagane pola, połączenia, wyrażenia, konfiguracja agentów AI. Błędy wychodzą przed wdrożeniem, nie po.
• Operacje na żywej instancji. Tworzenie, aktualizowanie, walidowanie i testowanie workflowów, przeglądanie egzekucji, zarządzanie credentialami, folderami i Data Tables, audyt bezpieczeństwa instancji.

Korzysta z niego ponad 143 000 osób, w tym zespoły w Deutsche Telekom, PayPal, Mercado Libre, MIT i NYU.

Jak podłączyć Claude Code do n8n?

Jedno polecenie w terminalu. Wersja z operacjami na Twojej instancji wymaga adresu i klucza API n8n, który generujesz w ustawieniach n8n w sekcji „n8n API”:

claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e N8N_API_URL=https://twoja-instancja-n8n.pl \
  -e N8N_API_KEY=twoj-klucz-api \
  -- npx n8n-mcp

Bez dwóch ostatnich zmiennych serwer działa w trybie samej dokumentacji: agent zna węzły i waliduje konfiguracje, ale nie dotyka instancji. To dobry tryb na początek, gdy chcesz zobaczyć, jak agent projektuje workflow, zanim dasz mu prawo zapisu.

Jeśli instancja stoi za Cloudflare Access, dodatkowe zmienne z identyfikatorem i sekretem tokena serwisowego pozwalają serwerowi przejść przez zabezpieczenie. Jeśli używasz n8n Agents, osobny token dostępu do MCP instancji włącza zarządzanie agentami.

Ta sama konfiguracja działa w Cursorze, VS Code z Copilotem, Windsurfie, Codex i Antigravity; każdy ma własną instrukcję w repozytorium n8n-mcp.

Hostowany czy własny n8n-mcp?

Dwie drogi, ten sam serwer, ale różne konsekwencje.

Własny, przez npx jak wyżej albo przez obraz Dockera. n8n-mcp jest open source i darmowy, nic nie wychodzi poza Twoją maszynę poza wywołaniami do instancji n8n. W zamian to Ty aktualizujesz pakiet po każdym wydaniu, pilnujesz, żeby baza węzłów nadążała za nowymi wersjami n8n, konfigurujesz zmienne środowiskowe dla każdego klienta i dbasz, żeby dwa klienty nie uruchamiały npx z tym samym katalogiem cache. Serwer działa lokalnie, więc podłączysz go do Claude Code, Cursora czy VS Code, ale nie do webowego ChatGPT ani do Claude w przeglądarce: te potrzebują serwera dostępnego z internetu.

Hostowany na dashboard.n8n-mcp.com. Rejestracja, klucz API albo OAuth, połączenie klienta. Instancje n8n, także kilka naraz, podłączasz w panelu: adres, klucz, gotowe, bez zmiennych środowiskowych i bez plików konfiguracyjnych. Aktualizacjami, bazą węzłów i infrastrukturą zajmuję się ja. Działa tam, gdzie lokalny serwer nie zadziała: w webowym ChatGPT, w Claude w przeglądarce i w każdym kliencie, który łączy się z serwerami MCP przez sieć. Darmowy próg to 100 wywołań dziennie, co wystarcza na zbudowanie i przetestowanie kilku workflowów dziennie; płatne plany podnoszą limit dla zespołów, które budują cały dzień.

Osobom, które żyją w terminalu i chcą mieć wszystko u siebie, wystarczy npx. Wszystkim pozostałym, a zwłaszcza zespołom bez programisty i każdemu, kto buduje workflowy w ChatGPT albo Claude w przeglądarce, polecam wersję hostowaną.

Co agent naprawdę robi, gdy buduje workflow?

Telemetria n8n-mcp, publikowana co tydzień w n8n AI Automation Index, pokazuje pracę agentów bez retuszu. W jednym tygodniu agenci wykonali 1,87 miliona wywołań narzędzi i utworzyli 98 tysięcy workflowów.

• Czytają cztery razy więcej, niż piszą. 57% wywołań to odczyt workflowów, egzekucji i list, 15% to zapis. Samo pobieranie egzekucji to 28% wszystkich wywołań: agent sprawdza, co się wydarzyło po uruchomieniu, zanim poprawi workflow.
• Pracują przyrostowo. Na jedno utworzenie workflowu przypada 9 aktualizacji. Duże workflowy powstają przez wiele małych, sprawdzanych zmian, dlatego workflowy o 31–100 węzłach nie przechodzą walidacji rzadziej niż te o 2–3 węzłach.
• Więcej utrzymują, niż budują od zera. Najczęstszym pierwszym krokiem sesji jest odczyt istniejącego workflowu, nie utworzenie nowego.

Dobrze skonfigurowany agent pracuje w pętli: dokumentacja węzła, walidacja konfiguracji, utworzenie workflowu, walidacja po stronie n8n, test, odczyt egzekucji, poprawka. Skille n8n dla Claude Code, osobny pakiet, uczą agenta tej pętli i konwencji, dzięki którym unika klasycznych błędów, na przykład wpisywania instrukcji agenta do user message.

Czego agent nie zrobi dobrze bez Ciebie?

Te same dane pokazują, gdzie potrzebny jest człowiek albo reguła.

Obsługa błędów. Tylko 2% workflowów budowanych przez AI ma Error Trigger. Agent buduje ścieżkę szczęśliwą, bo o nią go poproszono. Wpisz do pamięci agenta zasadę: każdy workflow produkcyjny, aktywny i cykliczny, dostaje error workflow z alertem. Wtedy nie trzeba o tym pamiętać przy każdej automatyzacji.

Kod zamiast węzłów. 74% workflowów budowanych przez AI zawiera węzeł Code, 60% HTTP Request. Agent woli napisać JavaScript i wywołać API, niż poszukać gotowej integracji, która ma wbudowane uwierzytelnianie i paginację. Prompt, który każe preferować węzły natywne, oraz przegląd przed aktywacją ograniczają dług, który potem ktoś musi utrzymać.

Połączenie z instancją. 43% testów połączenia agenta z API n8n kończy się błędem, w trzech czwartych przez zły adres albo niedostępną sieć. Instancje za reverse proxy, z niestandardową ścieżką albo bez publicznego dostępu to pierwsza rzecz do sprawdzenia przy wdrożeniu. Drugi częsty przypadek to błąd 403 przy pobieraniu credentiali: klucz API sprzed aktualizacji n8n nie zawiera nowych uprawnień, mimo że w interfejsie wygląda na kompletny. Rotacja klucza rozwiązuje problem.

Testy bez bałaganu. Zanim agent wyśle coś do prawdziwego systemu, wyłącz węzły akcji klawiszem D albo każ agentowi logować wyniki do Data Table i przejrzeć je po kilku dniach.

Jakie narzędzia dostaje agent?

n8n-mcp wystawia agentowi dwie grupy narzędzi. Pierwsza działa zawsze, druga po podaniu adresu i klucza API instancji.

Grupa	Narzędzia	Do czego
Dokumentacja i walidacja	tools_documentation, search_nodes, get_node, validate_node, validate_workflow, szablony	agent sprawdza, jak działa węzeł, i weryfikuje konfigurację, zanim cokolwiek zapisze
Workflowy	n8n_create_workflow, n8n_update_partial_workflow, n8n_validate_workflow, n8n_test_workflow, n8n_executions	tworzenie, przyrostowe zmiany, walidacja po stronie n8n, test i odczyt wyniku
Instancja	credentiale, foldery, Data Tables, wersje workflowów, audyt bezpieczeństwa	porządek, dane pomocnicze i przegląd webhooków oraz credentiali
n8n Agents	n8n_manage_agents	zarządzanie agentami przez wbudowany serwer MCP instancji, n8n 2.34 i nowsze

Agent nie nadpisuje całego workflowu, tylko wysyła operacje: dodaj węzeł, zmień pole, dodaj połączenie, włącz workflow. Dane z telemetrii pokazują, że typowa edycja to dwie do trzech takich operacji, a co piąta z nich to włączenie albo wyłączenie workflowu, czyli pętla testowa: wyłącz, popraw, włącz, sprawdź egzekucje.

Jak wygląda dobre zlecenie dla agenta?

Przykład zlecenia, które regularnie kończy się działającym workflowem: „Zbuduj workflow, który codziennie o 7:00 pobiera nowe wiersze z arkusza X, sprawdza, czy pole Status jest puste, i wysyła mi podsumowanie na Telegram przez credential, który mam. Podepnij error workflow z alertami. Nie aktywuj, dopóki nie potwierdzę”.

Cztery elementy robią różnicę:

• Konkretne źródła i credentiale. Agent nie zgaduje, gdzie są dane i jakim kontem ma się posłużyć.
• Warunek biznesowy zapisany słowami, nie w kategoriach węzłów. Wybór węzła IF czy Filter jest zadaniem agenta.
• Wymagania jakościowe wprost: obsługa błędów, brak aktywacji bez zgody, preferencja węzłów natywnych. To, czego nie napiszesz, agent pominie.
• Zasady w pamięci agenta zamiast powtarzania ich w każdym zleceniu. Reguła „każdy workflow produkcyjny dostaje error workflow” wpisana raz działa przy każdej kolejnej automatyzacji.

Zestaw skilli n8n dla Claude Code i ChatGPT uzupełnia to o konwencje, których agent nie zna z dokumentacji: gdzie w węźle AI Agent umieścić instrukcję, jak zwracać dane z sub-workflowu, jak testować bez tworzenia śmieci w systemach. W zespołach, z którymi pracuję, różnica po instalacji skilli jest wyraźna, a same skille warto utrzymywać centralnie, bo nie aktualizują się same.

Jak ograniczyć szkody, gdy agent się pomyli?

Agent z prawem zapisu do instancji potrafi nadpisać workflow, który działał. Kilka zasad z wdrożeń:

1. Kopia przed pracą agenta. n8n-mcp ma narzędzie do wersji workflowów, a sam n8n przechowuje historię; mimo to zapisanie kopii przed większą zmianą kosztuje sekundę i oszczędza godzinę.
2. Tryb samej dokumentacji na start. Bez adresu i klucza API agent projektuje i waliduje, ale nie dotyka instancji. Prawo zapisu dajesz, gdy zobaczysz, jak pracuje.
3. Osobny klucz API z terminem ważności dla agenta, rotowany co 90 dni, zamiast klucza bez daty wygaśnięcia.
4. Instancja za Cloudflare Access albo VPN, z tokenem serwisowym dla n8n-mcp, jeśli nie ma być publicznie dostępna.
5. Wyłączone węzły akcji podczas testów i logi do Data Table zamiast wysyłek do prawdziwych systemów.

Jak wygląda praca zespołu, który buduje w ten sposób?

U klienta z branży e-commerce zespół z finansów, magazynu i sprzedaży buduje workflowy przez ChatGPT i Claude z n8n-mcp od maja 2026. Na cotygodniowym spotkaniu każdy prosi swojego agenta o to samo, na przykład o generyczny error workflow z alertami na czacie, a potem o podpięcie go do wszystkich aktywnych workflowów, bez klikania. Osoba z magazynu zbudowała w ten sposób aplikację do inwentaryzacji terminów przydatności z n8n jako backendem. Rola człowieka przesunęła się z klikania w węzły na opisywanie procesu, przegląd wyniku i decyzje o tym, co ma prawo trafić na produkcję.

To ta sama metoda, którą stosuję we własnych wdrożeniach: agenci budują, ja projektuję, sprawdzam i odpowiadam za wynik.