Oficjalne MCP n8n w Claude Code: konfiguracja i pierwsze workflow

Co naprawdę zmienia TypeScript zamiast JSON

Oficjalne MCP n8n generuje TypeScript zamiast surowego JSON – walidacja odbywa się po stronie serwera MCP zanim workflow dotrze do twojej instancji. To jedna zmiana, ale przestawia całą logikę procesu.

Wyobraź sobie e-mail z ważnym załącznikiem. Nieoficjalne MCP to jak wysłanie go od razu i czekanie na odpowiedź „brakuje załącznika”. Oficjalne MCP działa jak Gmail z weryfikacją na żywo: problem wychodzi zanim klikniesz wyślij. Claude generuje TypeScript, serwer n8n sprawdza kod, a ty dostajesz działający workflow zamiast komunikatu o błędzie.

Nieoficjalne MCP od Romualda obsługuje więcej nodów i gotowych szablonów; oficjalne wygrywa stabilnością i weryfikacją przed deployem. To rzeczywista różnica, nie marketingowa. Jeśli budujesz nowe workflows od zera i zależy ci na stabilności, oficjalne MCP jest lepszym wyborem. Nie wyrzucaj nieoficjalnego jednak – do niszowych integracji wciąż przydaje się bardziej.

Jest jednak jeden haczyk, o którym rzadko się mówi. Oficjalne MCP ma niepełne pokrycie nodów – w wersji preview (maj 2026) nie wszystkie moduły n8n są w pełni obsługiwane przez schemat TypeScript. Przy bardziej egzotycznych integracjach Claude robi fallback na klasyczne podejście. I wtedy różnica względem nieoficjalnego MCP mocno się zaciera.

Konfiguracja MCP n8n w Claude Code – krok po kroku

Konfiguracja w aplikacji desktopowej Clauda zajmuje mniej niż minutę, jeśli masz zainstalowaną najnowszą wersję n8n. Nie potrzebujesz znać TypeScripta. Nie musisz edytować żadnych plików JSON ręcznie.

1. Zaktualizuj n8n do najnowszej wersji – oficjalne MCP działa wyłącznie z najnowszą wersją. Jeśli widzisz powiadomienie o aktualizacji w lewym dolnym rogu, zainstaluj ją zanim ruszysz dalej.
2. Włącz MCP w ustawieniach instancji – wejdź w Settings (lewy dolny róg), następnie Instance Level MCP. Funkcja ma etykietę „preview”, bo jest wciąż w fazie beta. Upewnij się, że przełącznik świeci na zielono.
3. Skopiuj dane połączenia – kliknij Connection Details, przejdź do zakładki Access Token. Znajdziesz tu Server URL i prywatny token dostępowy. Token to twoje hasło – nie pokazuj go nikomu.
4. Dodaj konektor w aplikacji desktopowej Clauda – kliknij plusik na dole, wybierz Connectors, Add Connectors, wyszukaj „n8n”. Kliknij Connect, zaloguj się na swojej instancji, przyznaj dostęp. Gotowe.
5. Sprawdź połączenie – zapytaj Clauda: „Powiedz mi, ile workflows widzisz w moim n8n. Skorzystaj z MCP.” Jeśli zwróci liczbę i nazwy workflows, wszystko działa.

Jeden szczegół łatwy do przeoczenia: jeśli chcesz, żeby Claude mógł edytować istniejące workflows przez MCP, wejdź do ustawień każdego workflow w n8n i zaznacz opcję „Available via MCP”. Bez tego Claude widzi workflow, ale nie może go modyfikować.

Pierwszy test: tygodniowy briefing z Hacker News

Żeby nie mówić tylko o teorii – sprawdźmy co MCP faktycznie robi w praktyce. Dobry punkt wyjścia to coś prostego, ale użytecznego: automatyczny monitoring newsów o Claude Code i Codex, uruchamiany co poniedziałek o 9:30.

Prompt wyglądał tak: „Stwórz workflow w n8n, które co poniedziałek o 9:30 przeszuka Hacker News i znajdzie pięć najciekawszych artykułów dotyczących Claude Code i Codex.” Nic więcej. Żadnych instrukcji technicznych.

Co zrobił Claude? Załadował narzędzia MCP, pobrał SDK reference, równolegle wyszukał odpowiednie nody. W pewnym momencie wyłapał problem: zamiast właściwego kroku do łączenia wyników użył struktury, która by nie zadziałała przy generowaniu raportu. Zamienił na pojedynczy string z literalami new line i wznowił pracę. Całość zajęła niecałe 5 minut. Zużycie tokenów: 1-2% pięciogodzinnego limitu (plan Max 20x).

Wynik? Działający workflow z harmonogramem, który przy ręcznym uruchomieniu wyciągnął pięć prawdziwych artykułów z Hacker News z ostatnich 7 dni, posortowanych według aktywności (plus counts). Jedna rzecz do ręcznego ustawienia: strefa czasowa Europe/Warsaw w triggerze czasowym.

Rozbudowany workflow: agregator newsów prosto na Gmail

4 źródła jednocześnie. AI wybiera top 5. Sformatowany HTML ląduje na skrzynce. To jest test, przy którym różnica między MCP a ręcznym budowaniem workflow robi się naprawdę odczuwalna – i przy którym wychodzą też ograniczenia obecnej wersji.

Źródła w tym przypadku to Hacker News, Product Hunt (RSS), The Verge i Devto. Model do selekcji: Gemini 2.5 Flash przez Open Router. Claude sam sprawdził właściwy prefix modelu w dokumentacji Open Routera, zamiast zgadywać. Node Open Router Chat Model jest dostępny w n8n bezpośrednio, więc nie było konieczności żadnych obejść.

Przy bardziej złożonym promptcie warto włączyć tryb planowania – Claude buduje plan przed przystąpieniem do generowania kodu. Trwa to dłużej… ale TypeScript jest dłuższy niż JSON. Każda iteracja zużywa więcej tokenów; na planie Pro to odczuwalne. W tym teście zużycie (włącznie z poprzednim demo) wyniosło 3% limitu na planie Max 20x. Jeśli testujesz MCP na planie Pro, zacznij od prostszych workflows i sprawdź zużycie w praktyce zanim wejdziesz w bardziej rozbudowane automatyzacje.

Workflow przeszło walidację przez MCP przy 15 nodach. Wynik? Sformatowany mail HTML na skrzynce, z linkami i krótkimi opisami artykułów po polsku. Każdy link działał. Gemini 2.5 Flash poprawnie wybrał i zdeduplikował artykuły ze wszystkich czterech źródeł.

Jedno zastrzeżenie: Claude dodał notatki do interfejsu workflow, które wizualnie się „rozjechały”. To kosmetyka, nie błąd funkcjonalny – ale świadczy o tym, że czytelność diagramu w n8n nie jest mocną stroną aktualnej wersji MCP. Warto to wiedzieć, zanim pokażesz taki workflow klientowi.

Kiedy oficjalne MCP n8n naprawdę się opłaca – i kiedy nie

To zależy od jednej zmiennej: czy zależy ci bardziej na stabilności przed deployem, czy na szerokości dostępnych nodów.

Oficjalne MCP wygrywa, gdy budujesz nowe workflows od zera, masz najnowszą wersję n8n i nie potrzebujesz bardzo niszowych integracji. W tych warunkach walidacja TypeScript faktycznie eliminuje klasę błędów, które wcześniej wychodziły na produkcji. Serwer MCP korzysta też z dokumentacji SDK na żywo: Claude nie zgaduje nazw nodów, tylko sprawdza co istnieje w twojej instancji.

Nieoficjalne MCP od Romualda trzyma przewagę w dwóch scenariuszach: potrzebujesz nodów, których oficjalny MCP jeszcze nie obsługuje (pokrycie jest częściowe w wersji preview), albo pracujesz z istniejącymi workflows ze specyficzną konfiguracją. Tu szerokość szablonów i nodów robi różnicę.

Możesz używać obu serwerów MCP równocześnie w Claude Code i sięgać po każdy tam, gdzie ma przewagę. Oficjalny do nowych, prostych automatyzacji; nieoficjalny do integracji z mniej popularnymi modułami lub modyfikacji starszych workflows. Każdy to osobna skrzynka z narzędziami – nie ma sensu wyrzucać żadnej.

Jedna kwestia, o której warto pamiętać: to wciąż wersja preview. Beta znaczy beta. Coś może się zmienić w kolejnej aktualizacji n8n – zarówno na plus (pełniejsze pokrycie nodów), jak i na minus (nieoczekiwane zmiany API serwera MCP). Nie buduj krytycznych automatyzacji produkcyjnych wyłącznie na tej integracji bez planu awaryjnego.