02.10.202612 min

n8n MCP: jak podpiąć Claude'a do swoich automatyzacji (konfiguracja krok po kroku)

Damian GębalaAutor

Podpięcie Claude'a do n8n przez MCP to włączenie jednego przełącznika w ustawieniach n8n, skopiowanie adresu serwera i jedna komenda w terminalu. Resztę robi model: buduje scenariusze, waliduje je przed uruchomieniem, a Ty zostajesz z przeglądem i zgodą na produkcję. Sam protokół jest wbudowany w n8n i nie ma osobnej opłaty za niego. Reszta artykułu to konfiguracja krok po kroku dla Claude Code i Claude Desktop, wraz z miejscami, w których najczęściej się wywala.

Czym jest n8n MCP i co realnie zmienia

MCP to standard, który pozwala programowi zewnętrznemu rozmawiać z narzędziem przez jeden ustalony interfejs. W n8n oznacza to, że Claude widzi Twoje scenariusze, wie, jakie mają kroki i może je tworzyć albo poprawiać - zamiast kleić do promptu instrukcję „zrób mi webhook do Dockera".

Oficjalna dokumentacja n8n opisuje to jednym zdaniem: „n8n's built-in MCP server lets supported clients, such as Lovable or Claude Desktop, connect securely to your n8n instance" (docs.n8n.io). Zasięg tego, co dostaje klient, obejmuje cztery rzeczy: przeszukiwanie scenariuszy, interakcję z tymi, które oznaczyłeś jako dostępne, uruchamianie i testowanie, oraz tworzenie i edycję scenariuszy i tabel danych.

Jeśli dopiero zaczynasz z n8n, uprzedzam, że n8n jako platforma sama w sobie nie robi nic z modelem językowym. MCP jest warstwą, która do tego dochodzi.

Jedna rzecz, którą warto wyjaśnić od razu, bo myli wiele osób: to nie jest tożsame z node'em MCP Server Trigger. Jak ujmuje to n8n.io, „The n8n instance MCP lets external AI clients connect to your entire instance. The MCP Server Trigger node only exposes tools from a single workflow as a MCP server." Ten drugi mechanizm wystawia jeden scenariusz, pierwszy - całą instancję, w zakresie, który sam wyznaczysz.

Dwa różne „n8n MCP" - nie pomyl ich przy zakupie

W sieci krąży jedno hasło i dwa zupełnie różne produkty. Pierwszy jest wbudowany w n8n, działa na każdym planie i komunikuje się z Twoją instancją bezpośrednio. Drugi to niezależny serwer open source, który komunikuje się z n8n przez publiczne API i dokłada dokumentację węzłów.

Natywny serwer jest wersją, którą opisuję niżej - jest darmowy, nie wymaga osobnego konta i nie potrzebuje dodatkowego klucza API do samego n8n. Opcja druga to projekt czlonkowski/n8n-mcp, uruchamiany jednym npx n8n-mcp albo przez Dockera, w wersji darmowej na licencji MIT. Opisano go jako „A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to n8n node documentation, properties, and operations". Autor, ten sam, sprzedaje też wersję chmurową: 0 euro i 100 wywołań narzędzi dziennie w darmowym wariancie albo 19 euro miesięcznie za limity bez ograniczeń. To 228 euro rocznie. Nie jest to opłata za MCP w n8n, tylko za hostingowaną usługę tej samej firmy - myląca jest sama nazwa domeny, która wygląda niemal jak oficjalna.

Na co dzień wybieram wbudowany. Powód jest prosty: nie ma między nimi pośrednika, który dotyka Twoich danych.

Jakiej wersji n8n potrzebujesz

Tutaj dokumentacja i strona marketingowa mówią różne rzeczy i warto to rozstrzygnąć, zanim zaczniesz. n8n.io obiecuje, że „You just need to be running version 2.18.3, or higher." To próg, od którego MCP w ogóle istnieje. Instrukcja, którą przeczytasz niżej, wymaga nowszej wersji, bo kolejne funkcje dochodziły etapami:

2.13.0 - budowanie i edycja scenariuszy przez MCP
2.24.0 - kontrola dostępu MCP na poziomie projektu i folderu
2.33.0 - układ ustawień z dialogiem „Connect a client" i instrukcja per klient
2.34.0 - zarządzanie agentami z poziomu klienta MCP
2.36.0 - automatyczne wystawianie nowych scenariuszy i nagłówki routingu w CORS

Jeśli prowadzisz instancję starszą niż 2.33.0, zacznij od aktualizacji. Jeśli jest starsza niż 2.18.3, nie zaczynaj - warto wiedzieć, że ja sam przy pierwszym podejściu nie wiedziałem, gdzie tego przełącznika szukać, a instrukcja w sieci mieszała obie wersje.

Krok 1: włącz dostęp MCP w n8n

Zaloguj się do instancji i wejdź w Settings › Instance-level MCP. W dokumentacji: „Navigate to Settings > Instance-level MCP. Then toggle Enable MCP access" (n8n.io). Przełącznik wymaga konta właściciela lub administratora - dokumentacja mówi wprost: „Select Enable MCP access (requires instance owner or admin permissions)."

Po włączeniu strona dzieli się na trzy sekcje. Connection details pokazuje status MCP i przycisk podłączenia klienta. Access pokazuje, ile scenariuszy (a jeśli masz moduł agentów, to ile agentów) jest wystawionych. Connected clients daje podgląd do trzech podłączonych klientów. To miejsce, w którym od razu zobaczysz, czy nie zostawiłeś czegoś włączonego, o czym nie pamiętałeś.

Krok 2: wybierz sposób logowania

Kliknij przycisk podłączenia i w oknie „Connect a client" masz dwie opcje: OAuth (rekomendowane przez n8n) albo klucz API. Wybór ma realne skutki, więc warto zrozumieć różnicę, zanim klikniesz.

OAuth to standardowy tryb, w którym klient przechodzi przez okno logowania. n8n pokazuje wtedy listę podzieloną na trzy grupy: „n8n groups clients into CLI (Claude Code, Codex, Gemini CLI), Web (Claude.ai, ChatGPT, Mistral Vibe), and IDE (Cursor, VS Code, Windsurf)". Wybierasz swoje narzędzie z listy i dostajesz gotową konfigurację.

Klucz API to wygodniejsze, ale ostrzejsze podejście. n8n generuje token przy pierwszym otwarciu okna: „n8n automatically generates a personal access token tied to your user account the first time you open it". I tu jest pułapka, o której nie wspomina instrukcja na pierwszej stronie: „Once you leave this tab, n8n only shows a redacted token value, and you won't be able to copy it again unless you rotate it." Token widzisz raz. Jeśli go zgubisz, nie odzyskasz - musisz wygenerować nowy.

W obu wariantach adres serwera jest taki sam i kończy się konkretnym sufiksem. Dokumentacja zaleca: „Copy the Server URL from Settings > Instance-level MCP > Connect a client. It ends in /mcp-server/http". Zapisz go - użyjesz go za chwilę.

Krok 3: podepnij Claude Code

Tu jest najkrótsza ścieżka i wariant OAuth nie wymaga żadnego JSON-a. Jedna komenda w terminalu:

claude mcp add --transport http n8n https://twoja-domena.pl/mcp-server/http

Potem w Claude Code odpowiadasz /mcp, wskazujesz pozycję n8n i kończysz autoryzację. Instrukcja dosłownie: „Run /mcp in Claude Code and select n8n to complete the OAuth authorization."

Jeśli wolisz plik, to ten sam efekt daje blok w claude.json:

{
  "mcpServers": {
    "n8n": {
      "type": "http",
      "url": "https://twoja-domena.pl/mcp-server/http"
    }
  }
}

Przy kluczu API dochodzi nagłówek, a nazwa serwera zmienia się na n8n-mcp:

claude mcp add --transport http n8n-mcp https://twoja-domena.pl/mcp-server/http --header "Authorization: Bearer TWOJ_TOKEN"

Jedna uwaga do adresu: przykłady z dokumentacji używają https://. Jeśli masz instancję lokalną na http://localhost:5678, zostaw http:// - mieszanie schematów to częsty powód, dla którego klient nie łączy się wcale.

Krok 4: podepnij Claude Desktop

W Claude Desktop ścieżka wygląda inaczej, bo tu nie ma terminala. Dokumentacja prowadzi krokami: „Navigate to Settings > Connectors in Claude Desktop. Click on Add custom connector. Name: n8n MCP. Remote MCP Server URL: the Server URL value shown in the Connect a client dialog. It ends in /mcp-server/http".

Na stronie n8n.io znajdziesz też skrót tej ścieżki przez menu „Customize" w panelu bocznym, gdzie n8n jest pozycją w katalogu konektorów - n8n podaje, że „n8n is an official Claude Connector". Efekt jest ten sam, różnią się etykiety przycisków zależnie od wersji.

Przy kluczu API Desktop potrzebuje lokalnego mostka, bo nie umie sam dodać nagłówka autoryzacji do zdalnego adresu. Konfiguracja wygląda wtedy tak:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://twoja-domena.pl/mcp-server/http",
        "--header",
        "Authorization:Bearer TWOJ_TOKEN"
      ]
    }
  }
}

To jedyna sytuacja, w której potrzebujesz tego pośrednika. Przy OAuth w Desktop i przy API key w Claude Code nie.

Gdzie każdy klient trzyma konfigurację

Najwięcej czasu tracisz nie na samej konfiguracji, tylko na szukaniu właściwego pliku. Nazwa sekcji nie zawsze brzmi mcpServers i nie wszędzie to JSON - zestaw poniżej oszczędza kilkanaście minut:

Klient	Plik	Sekcja / typ
Claude Code	`claude.json`	`mcpServers`, typ `http`
Claude Desktop	plik konfiguracyjny aplikacji	`mcpServers`, typ `http`
Codex	`~/.codex/config.toml`	format TOML, `codex mcp login n8n` do autoryzacji
Cursor	`~/.cursor/mcp.json`	typ `streamable-http`
VS Code	`.vscode/mcp.json`	sekcja `servers` (nie `mcpServers`)
Gemini CLI	`~/.gemini/settings.json`	pole `httpUrl`
Windsurf	`~/.codeium/windsurf/mcp_config.json`	pole `serverUrl`

Sam wybór klienta to osobna decyzja, nie kwestia preferencji. Zestawienie Claude Code kontra Cursor kontra Codex rozpisuje różnice, które widać właśnie przy pracy z MCP.

Krok 5: pokaż n8n tylko to, co ma być widoczne

Domyślnie nie widzi nic. Włączasz dostęp do scenariusza w trzech miejscach: na stronie „Workflows exposed" (dostępne od 2.2.0), w edytorze przez Workflow (…) › Settings › „Available in MCP", albo z menu karty na liście scenariuszy.

Tu jest ograniczenie, które oszczędza kłopot: „You can only enable MCP access for published workflows that contain a webhook, form, schedule, or chat trigger node." Innymi słowy: musi być opublikowany i musi mieć wyzwalacz. Scenariusz uruchamiany ręcznie z panelu nie nadaje się.

Od wersji 2.36.0 n8n wdraża też automatyczne wystawianie nowych scenariuszy, ale z zastrzeżeniem, że „The setting may not be visible on every instance yet". Licz na ręczne włączanie.

Co dokładnie Claude dostaje w ręce

I tu dochodzimy do liczb, o które w sieci jest potyczka. Wbudowany serwer n8n udostępnia ponad 50 narzędzi w siedmiu grupach: zarządzanie scenariuszami, zarządzanie wykonaniami, poświadczenia, kontekst instancji, budowanie i walidacja, agenty oraz tabele danych. Zewnętrzny serwer czlonkowskiego deklaruje „Core Tools (7 tools)" plus „n8n Management Tools (21 tools - Requires API Configuration)", czyli 28. Trzeci projekt podaje 17 w nagłówku, a po rozwinięciu opisu sam wylicza 23.

Nie ma tu błędu w Twojej głowie. Te liczby opisują trzy różne serwery. Dlatego nie podaję jednej jako „liczby narzędzi n8n MCP" - byłoby to po prostu nieuczciwe wobec czytelnika, który potem policzy i nie zobaczy zgodności.

W praktyce największy wpływ na koszt rozmowy ma walidacja pojedynczego węzła. Dokumentacja zewnętrznego serwera podaje, że wersja minimalna to „Basic metadata only ( ~ 200 tokens)", a wersja pełna „Complete information ( ~ 3000-8000 tokens)". Różnica jest dwudziestokrotna, więc warto w instrukcjach dla Claude'a prosić o wersję minimalną, dopóki nie trzeba sprawdzić czegoś egzotycznego. Samo sprawdzenie poprawności konfiguracji węzła to „Quick required fields check (<100ms)".

Jeśli zastanawiasz się, który model w ogóle spina te narzędzia, mam osobne porównanie kosztu 1000 zadań automatyzacji - liczby tokenów zużytych przez narzędzia są tam realnym kosztem, nie tłem.

Bezpieczeństwo: co ustawić, zanim podepniesz produkcję

Najpierw rzecz, która brzmi jak drobnostka, a jest dziurą. Uprawnienia nadane klientowi MCP dotyczą wszystkich podłączonych klientów naraz: „It's not scoped to each MCP client. All clients you connect... can see all workflows you've enabled for MCP access. You can't restrict specific workflows to specific clients." Nie da się powiedzieć „ten asystent widzi raporty, a tamten faktury".

Co możesz zrobić:

Ogranicz adresy zwrotne OAuth. Domyślnie n8n dopuszcza każdy - „By default, n8n allows any callback URL, which is less secure." Do wyboru masz tryb „All callback URLs" albo „Only trusted URLs".
Wystawiaj pojedyncze scenariusze, nie całą instancję. Możliwości, których nie włączasz, nie ma w narzędziach.
Wróć uwagę na tryb produkcyjny. Dokumentacja ostrzega wprost: „The exception is execute_workflow, which defaults to production mode and runs the published version of a workflow." Jedno wywołanie odpalające produkcję to najdroższy błąd, jaki możesz zrobić przez MCP.
Trzymaj kopię. Autor zewnętrznego serwera pisze wprost: „NEVER edit your production workflows directly with AI!" i zaleca kopię scenariusza przed każdą pracą z AI.
Umiej wyłączyć całość. Zmienna N8N_DISABLED_MODULES=mcp „removes MCP endpoints and hides all related UI elements".

Dodam, że search_workflows widzi podglądy wszystkich scenariuszy, do których ma dostęp bieżący użytkownik, niezależnie od tego, co włączyłeś - to jedyny wyjątek od zasady „wystawiasz pojedyncze scenariusze". O reszcie uprawnień decyduje zakres nadany przy pierwszym połączeniu: „Each connected client only has the permissions you granted it when it connected, for example reading workflows without being able to create or run them."

Jak nie wpuszczać do promptów danych, których nie powinieneś tam puszczać, opisuję osobno w tekście o zasadach bezpieczeństwa danych firmowych.

Osiem rzeczy, które psują połączenie

Komunikat „You do not have sufficient permissions to authorize this request". Mylący, bo sugeruje coś zupełnie innego. Znaczy tylko tyle, że MCP nie jest włączony: „While the server runs, any signed-in user can approve a client. While it's off, n8n refuses everyone."
Reverse proxy obcinający nagłówki. „If your instance runs behind a reverse proxy, load balancer, or web application firewall, make sure it doesn't strip the MCP request headers." Od 2.36.0 n8n przepuszcza w polityce CORS trzy nagłówki: MCP-Protocol-Version, Mcp-Method, Mcp-Name. Bez wpisania ich na allowlistę klient „może nie połączyć się albo cofnąć do starszej wersji protokołu".
Instancja niedostępna z zewnątrz. „Ensure that your n8n instance is publicly accessible if you are using cloud-based MCP clients." Chmurowi klienci nie dostaną się do instancji siedzącej za lokalnym adresem.
Wklejony adres edytora zamiast adresu serwera. Dokumentacja ostrzega wprost: „This isn't the address of your n8n editor. Don't paste the URL from your browser's address bar."
Token widziany raz i zgubiony. Opisałem to przy kroku 2.
Agenci w podglądzie. „Agents are in Preview and may change in future releases. Avoid relying on them in production workflows."
Serwer zewnętrzny i podzielony host. Nie każda konfiguracja instancji jest obsługiwana - ta z osobnym adresem dla MCP („split host") nie.
Węzeł IF bez parametru gałęzi. Pułapka z dokumentacji zewnętrznego serwera: „Without the branch parameter, both connections may end up on the same output, causing logic errors!" Powstają dwa wyjścia prowadzące w to samo miejsce i logika cicho się sypie.

Kiedy n8n-MCP się nie opłaca

Nie każdy proces warto automatyzować, i nie każdy warto podpinać do modelu. Jeśli masz jeden scenariusz i robisz go raz w tygodniu, konfiguracja zajmie więcej czasu niż ręczne kliknięcia. Jeśli Twój przypadek użycia to „wyślij potwierdzenie po płatności", to znane integracje Stripe z n8n zrobią to bez modelu i bez MCP.

MCP zaczyna się opłacać w trzech sytuacjach: masz kilkanaście scenariuszy i często je modyfikujesz, dopiero uczysz się n8n i chcesz prowadzić kogoś za rękę zamiast czytać dokumentację, albo utrzymujesz dużą instancję i potrzebujesz szybkiego audytu - które scenariusze nie działały od 7 dni, co nie odpaliło się od błędu, gdzie są stare węzły bez aktualizacji. To odpowiedzi na pytania, na które bez MCP musisz zaglądać do panelu jeden po drugim.

Zacznij od jednego procesu. Wybierz ten, który jest powtarzalny i policzalny w godzinach, i dopiero potem dokładaj kolejne. Jeśli chcesz to przejrzeć na konkretnym przykładzie, pierwsza automatyzacja w n8n zaczyna się bez modelu językowego, co jest właściwym punktem wyjścia.

Napisz do mnie - odpowiadam zwykle tego samego dnia. Jeśli masz instancję n8n, która działa, ale nie wiesz, od którego procesu warto zacząć, umówmy się na krótką rozmowę.

Robisz coś podobnego u siebie?Napisz do mnie