Blog

n8n MCP: jak podłączyć asystenta AI do n8n i budować przepływy rozmową

Kategoria:

Pod koniec września naprawiłem mój radar pozycji w Google bez otwierania edytora n8n. Dostawca danych przeniósł API pod nowy adres. Asystent AI podłączony do n8n przez MCP odczytał błąd z historii wykonań, znalazł nowy adres w kodzie wtyczki dostawcy, przebudował trzy węzły, uruchomił test bez wysyłania raportu na komunikator i opublikował poprawioną wersję. Ja zleciłem naprawę i przeczytałem raport z testu. Opisuję, jak takie połączenie skonfigurować i jakich zasad pilnuję, żeby asystent nie narobił szkód.

Co to jest MCP i co daje w n8n?

MCP (Model Context Protocol) to otwarty standard, przez który asystent AI łączy się z zewnętrznymi narzędziami i danymi. n8n obsługuje go w dwóch kierunkach:

  • n8n jako serwer MCP. Asystent AI (Claude, Cursor, ChatGPT i inne klienty MCP) widzi przepływy z Twojej instancji: może je wyszukać, odczytać i uruchomić, a przy odpowiednich uprawnieniach także tworzyć i edytować. Wybrane przepływy można też wystawić jako narzędzia przez węzeł MCP Server Trigger.
  • n8n jako klient MCP. Agent AI w przepływie korzysta z cudzych serwerów MCP przez węzeł MCP Client Tool, na przykład z serwera wyszukiwarki albo bazy danych.

Ten tekst dotyczy pierwszego kierunku, bo z niego korzystam codziennie. Drugi opisuję przy okazji agentów w tekście agent AI w n8n.

Jak podłączyć asystenta AI do n8n przez MCP?

  1. W ustawieniach instancji n8n włączam dostęp MCP i generuję token.
  2. W przepływach, które asystent ma widzieć, zaznaczam w ustawieniach dostępność dla MCP. Pozostałe przepływy są dla niego niewidoczne.
  3. W kliencie MCP (Claude, Cursor, VS Code) dodaję serwer: adres instancji i token. Token trzymam w zmiennej środowiskowej, poza plikami konfiguracyjnymi w repozytorium.
  4. Pierwsze polecenie kontrolne: „wypisz moje aktywne przepływy”. Jeśli lista zgadza się z panelem, połączenie działa.

Instancja musi być dostępna z internetu przez HTTPS. Jak postawić własną, opisałem w tekście o n8n na Docker Compose.

Co asystent robi w n8n na co dzień?

  • Diagnoza awarii. Czyta historię wykonań, wskazuje węzeł i komunikat błędu, porównuje dane z ostatnim udanym przebiegiem.
  • Poprawki w przepływach. Zmienia parametry, dokłada węzły, przepina połączenia, poprawia kod w węzłach Code.
  • Testy bez skutków ubocznych. Uruchamia przepływ z przypiętymi danymi (pin data) na węzłach, które wysyłają wiadomości albo publikują treści, więc test nie trafia do klientów ani na komunikator.
  • Budowa nowych przepływów z opisu. Tak powstał u mnie raport, który co poniedziałek zbiera statystyki z sześciu stron i wysyła jedno podsumowanie.

Gdzie trzymać sekrety, gdy pracuje asystent?

W poświadczeniach n8n. Asystent widzi strukturę przepływu i nazwy poświadczeń, a ich zawartości nie odczyta. Klucz API wpisany wprost w parametr węzła zobaczy za to przy pierwszym odczycie przepływu. Takie miejsca przenoszę do poświadczeń, a gdy API dostawcy przyjmuje klucz tylko w treści żądania i przeniesienie się nie da, zlecam asystentowi wyłącznie zmiany punktowe w pozostałych polach.

Druga zasada dotyczy sposobu edycji. Serwer MCP n8n przyjmuje pojedyncze operacje: zmień parametr, dodaj węzeł, przepnij połączenie. Przepływ z poufnymi danymi w innych węzłach nie przechodzi więc w całości przez rozmowę z modelem.

Czego pilnuję, gdy asystent zmienia przepływy?

  • Wersja robocza i publikacja to dwa osobne kroki. Zmiany trafiają do wersji roboczej, a produkcyjny przepływ działa na poprzedniej wersji aż do publikacji.
  • Test przed publikacją. Po każdej zmianie przebieg testowy i odczyt danych z węzłów, które się zmieniły. Sam status „success” nie wystarcza.
  • Historia wersji. n8n przechowuje poprzednie wersje przepływu, więc nieudaną zmianę cofam jednym przywróceniem.
  • Opis przy każdej wersji. Asystent zapisuje, co zmienił i dlaczego. Po miesiącu z takiego opisu odtwarzam powód zmiany szybciej niż z pamięci.

Jedna pułapka techniczna: przepływu, który ma tylko ręczny wyzwalacz, n8n nie opublikuje. Takie przepływy narzędziowe uruchamiam przez przebieg testowy.

Kiedy MCP w n8n się nie sprawdzi?

Gdy przepływy są krytyczne dla firmy, a zmian proponowanych przez asystenta nie czyta osoba, która rozumie te przepływy. Asystent wykona polecenie dokładnie i może przy tym przeoczyć skutek w innym miejscu. Po wstawieniu nowego węzła między dwa istniejące kolejny węzeł czyta dane z nowego sąsiada, więc w jednej z moich zmian wyrażenia w dalszym węźle trzeba było przepiąć na odwołania do właściwego źródła. Dlatego przy przepływach produkcyjnych wymagam od asystenta testu i raportu z danych przed publikacją.

Jeśli chcesz tak pracować z własną instancją, wdrażam n8n w firmach, a dostęp asystenta AI przez MCP konfiguruję w ramach wdrożenia. Przykłady przepływów, które utrzymuję w ten sposób, opisałem w tekście n8n: przykłady użycia.