n8n-MCP
n8n-MCP to serwer MCP, który daje Twojemu asystentowi AI szczegółową wiedzę o węzłach, szablonach i workflow w n8n. Dzięki niemu możesz projektować, sprawdzać i poprawiać automatyzacje w n8n z pomocą AI. Serwer udostępnia informacje o 1 650 węzłach n8n, ich właściwościach, operacjach, dokumentacji, przykładach i szablonach workflow. n8n-MCP pomaga AI lepiej rozumieć, jak budować workflow. Może też łączyć się z Twoją instancją n8n, jeśli skonfigurujesz adres API i klucz API.Najważniejsze możliwości
- Możesz korzystać z wiedzy o 820 węzłach core i 830 węzłach społecznościowych.
- Możesz sprawdzać właściwości węzłów z pokryciem na poziomie 99%.
- Możesz analizować dostępne operacje węzłów z pokryciem 63,6%.
- Możesz korzystać z dokumentacji n8n z pokryciem 87%.
- Możesz wyszukiwać 2 352 szablony workflow.
- Możesz korzystać ze 156 przykładów konfiguracji z popularnych szablonów.
- Możesz pracować z 265 wariantami narzędzi AI wykrytymi w n8n.
Podstawowe narzędzia MCP
- tools_documentation – pokazuje dokumentację narzędzi MCP i pomaga zacząć pracę od właściwych zasad oraz dobrych praktyk.
- search_nodes – przeszukuje wszystkie węzły n8n pełnotekstowo, w tym węzły core, community i verified, oraz może zwracać przykładowe konfiguracje.
- get_node – pobiera szczegółowe informacje o wybranym węźle, jego właściwościach, dokumentacji, wersjach, migracjach i zmianach łamiących zgodność.
- validate_node – sprawdza konfigurację pojedynczego węzła w trybie szybkim lub pełnym, aby wykryć braki przed budową workflow.
- validate_workflow – sprawdza cały workflow, w tym połączenia, wyrażenia i elementy związane z AI Agentami.
- search_templates – wyszukuje szablony workflow po słowach kluczowych, typach węzłów, zadaniach lub metadanych, takich jak złożoność i grupa odbiorców.
- get_template – pobiera kompletny szablon workflow w trybie samych węzłów, struktury albo pełnego pliku JSON.
Narzędzia do zarządzania n8n
Te narzędzia wymagają konfiguracji N8N_API_URL oraz N8N_API_KEY. Dzięki nim AI może pracować bezpośrednio z Twoją instancją n8n.- n8n_create_workflow – tworzy nowe workflow w n8n wraz z węzłami i połączeniami.
- n8n_get_workflow – pobiera workflow w różnych trybach, od podstawowych informacji po pełną strukturę.
- n8n_update_full_workflow – aktualizuje cały workflow przez pełne zastąpienie jego zawartości.
- n8n_update_partial_workflow – wprowadza częściowe zmiany w workflow za pomocą operacji różnicowych.
- n8n_delete_workflow – trwale usuwa wybrane workflow z instancji n8n.
- n8n_list_workflows – wyświetla listę workflow z obsługą filtrowania i paginacji.
- n8n_validate_workflow – sprawdza poprawność workflow znajdującego się już w n8n na podstawie jego ID.
- n8n_autofix_workflow – automatycznie poprawia typowe błędy wykryte w workflow.
- n8n_workflow_versions – zarządza historią wersji workflow i umożliwia rollback.
- n8n_deploy_template – wdraża szablony z n8n.io bezpośrednio do Twojej instancji i może zastosować automatyczne poprawki.
- n8n_test_workflow – testuje lub uruchamia workflow, na przykład przez webhook, formularz albo czat.
- n8n_executions – zarządza wykonaniami workflow, w tym listą, szczegółami i usuwaniem wykonań.
- n8n_manage_credentials – zarządza poświadczeniami n8n, w tym listą, tworzeniem, aktualizacją, usuwaniem i pobieraniem schematu.
- n8n_audit_instance – wykonuje audyt bezpieczeństwa instancji n8n i głębiej skanuje workflow.
- n8n_health_check – sprawdza połączenie z API n8n oraz dostępne funkcje instancji.
Szablony i przykłady
n8n-MCP stawia duży nacisk na pracę z szablonami. Zamiast budować workflow od zera, możesz najpierw sprawdzić gotowe rozwiązania. Serwer pozwala wyszukiwać szablony według zadania, użytych węzłów, wymaganej usługi, złożoności i grupy docelowej. Dzięki temu AI może szybciej znaleźć punkt startowy do automatyzacji.Walidacja workflow
n8n-MCP pomaga sprawdzać workflow na kilku poziomach. Możesz walidować pojedynczy węzeł, cały workflow, połączenia oraz wyrażenia używane w automatyzacji. To ważne, ponieważ błędne domyślne parametry mogą powodować problemy podczas uruchamiania workflow. Serwer wspiera podejście, w którym kluczowe ustawienia są konfigurowane jawnie.Sposoby uruchomienia
Możesz skorzystać z wersji dostępnej przez dashboard.n8n-mcp.com. Dostępny jest darmowy limit 100 wywołań narzędzi dziennie. Możesz też samodzielnie hostować n8n-MCP. Dokumentacja przewiduje warianty przez npx, Docker, Railway oraz instalację lokalną.
⚠️ Uwaga: Nie edytuj produkcyjnych workflow bezpośrednio z pomocą AI. Najpierw zrób kopię, przetestuj zmiany, wykonaj backup i sprawdź workflow przed wdrożeniem.
Jak działa n8n-MCP?
n8n-MCP działa jak most między Twoim asystentem AI a wiedzą o n8n. Przepływ wygląda tak: Ty → AI → n8n-MCP → dokumentacja, szablony lub Twoja instancja n8n. Ty opisujesz automatyzację, a AI korzysta z narzędzi n8n-MCP, aby dobrać węzły, sprawdzić konfigurację i zweryfikować workflow. Jeśli podłączysz własną instancję n8n przez N8N_API_URL i N8N_API_KEY, AI może też tworzyć, pobierać, aktualizować, testować i sprawdzać workflow bezpośrednio w n8n.Podstawowy przepływ pracy
- Ty opisujesz zadanie, na przykład automatyzację z webhookiem, Slackiem albo Google Sheets.
- AI sprawdza dostępne narzędzia i korzysta z tools_documentation, aby dobrać właściwy sposób pracy.
- n8n-MCP przeszukuje węzły lub szablony, aby znaleźć najlepszy punkt startowy.
- AI pobiera szczegóły węzłów, ich właściwości, operacje, przykłady i dokumentację.
- n8n-MCP waliduje konfigurację, aby wykryć braki i błędy przed użyciem workflow.
- AI przygotowuje workflow albo, przy konfiguracji API, pracuje bezpośrednio na Twojej instancji n8n.
Praca z szablonami
n8n-MCP pozwala najpierw sprawdzić gotowe szablony workflow. To pomaga szybciej zacząć pracę i ograniczyć budowanie automatyzacji od zera. Możesz szukać szablonów po słowach kluczowych, typach węzłów, zadaniu, wymaganej usłudze, złożoności albo grupie docelowej. AI może potem pobrać wybrany szablon jako pełny workflow JSON.
💡 Wskazówka: Jeśli chcesz prostą automatyzację, poproś AI o szablony o niskiej złożoności. Możesz też wskazać usługę, na przykład OpenAI, Slack albo Google Sheets.
Praca z węzłami n8n
Gdy nie ma odpowiedniego szablonu, AI może wyszukać właściwe węzły. n8n-MCP udostępnia informacje o węzłach core, community i verified. AI może pobrać podstawowe dane węzła, pełną konfigurację, dokumentację albo konkretne właściwości. Może też sprawdzić wersje, migracje i zmiany wpływające na zgodność.Walidacja przed uruchomieniem
n8n-MCP pomaga sprawdzić konfigurację zanim workflow trafi do użycia. Najpierw można wykonać szybki test wymaganych pól, a potem pełną walidację. Po zbudowaniu workflow można sprawdzić połączenia, wyrażenia i elementy związane z AI Agentami. Dzięki temu łatwiej wykryjesz błędy przed wdrożeniem.Praktyczne przykłady użycia
1. Stworzenie workflow od szablonu
Możesz poprosić AI o automatyzację konkretnego zadania. n8n-MCP najpierw wyszuka pasujące szablony. AI może pobrać wybrany szablon, sprawdzić jego strukturę i przygotować go do dalszej pracy. Jeśli szablon pochodzi z n8n.io, trzeba zachować informację o autorze i źródle.2. Dobór i konfiguracja węzłów
Możesz opisać, co ma robić workflow, nawet bez znajomości nazw węzłów. AI użyje search_nodes, aby znaleźć pasujące elementy. Następnie może użyć get_node, aby sprawdzić wymagane pola, dokumentację i przykładowe konfiguracje. To pomaga uniknąć przypadkowego pominięcia ważnych parametrów.3. Sprawdzenie gotowego workflow
Możesz poprosić AI o ocenę workflow przed wdrożeniem. n8n-MCP może sprawdzić cały workflow, połączenia i wyrażenia. Jeśli masz skonfigurowane API n8n, AI może też zweryfikować workflow już zapisany w Twojej instancji. Może również wykonać automatyczne poprawki typowych błędów.Praca bezpośrednio z instancją n8n
Po skonfigurowaniu N8N_API_URL i N8N_API_KEY AI może korzystać z narzędzi zarządzania n8n. Może tworzyć nowe workflow, pobierać istniejące, aktualizować je, testować i sprawdzać wykonania. Może też zarządzać poświadczeniami, wersjami workflow oraz wykonać audyt bezpieczeństwa instancji. Te funkcje wymagają dostępu do Twojego n8n przez API.
⚠️ Uwaga: Nie edytuj produkcyjnych workflow bezpośrednio z pomocą AI. Najpierw zrób kopię, przetestuj zmiany w bezpiecznym środowisku i wykonaj backup ważnych workflow.
Dlaczego ważna jest jawna konfiguracja?
n8n-MCP wspiera podejście, w którym kluczowe parametry ustawiasz wprost. Nie warto polegać wyłącznie na wartościach domyślnych. Brak jawnych ustawień może prowadzić do błędów podczas działania workflow. Dlatego AI może używać walidacji, aby wykryć brakujące pola i poprawić konfigurację przed uruchomieniem.Instalacja n8n-MCP
n8n-MCP możesz uruchomić na kilka sposobów: przez gotowy dashboard, samodzielny hosting albo integrację z wybranym narzędziem AI. Najprostszy wariant nie wymaga instalacji lokalnej. Możesz zacząć przez dashboard.n8n-mcp.com, pobrać klucz API i połączyć swój klient MCP.
⚠️ Uwaga: Nie edytuj produkcyjnych workflow bezpośrednio z pomocą AI. Najpierw zrób kopię, test i backup.
Najszybszy start przez dashboard
Najprostsza ścieżka to użycie gotowego dashboardu n8n-MCP.- Wejdź na dashboard.n8n-mcp.com.
- Załóż konto.
- Pobierz swój klucz API.
- Połącz n8n-MCP z wybranym klientem MCP.
- Zacznij budować workflow z pomocą AI.
ℹ️ Info: Darmowy plan obejmuje 100 wywołań narzędzi dziennie.
Samodzielny hosting
Jeśli chcesz mieć większą kontrolę nad środowiskiem, możesz samodzielnie hostować n8n-MCP. Dostępne są warianty uruchomienia przez:- npx – do uruchomienia pakietu bez pełnej ręcznej instalacji.
- Docker – do pracy w kontenerze.
- Railway – do wdrożenia w chmurze.
- instalację lokalną – do uruchomienia we własnym środowisku.
Połączenie z własną instancją n8n
Jeśli chcesz, aby AI pracowało bezpośrednio z Twoją instancją n8n, skonfiguruj dostęp do API. Do narzędzi zarządzania n8n potrzebujesz dwóch wartości:- N8N_API_URL – adres Twojej instancji n8n.
- N8N_API_KEY – klucz API do Twojej instancji n8n.
⚠️ Uwaga: Klucz API daje dostęp do Twojej instancji n8n. Nie publikuj go i nie wklejaj w publicznych miejscach.
Połączenie z narzędziami AI i IDE
n8n-MCP możesz połączyć z różnymi narzędziami wspierającymi pracę z AI.- Claude Code – do pracy z Claude w CLI.
- Visual Studio Code – do integracji z VS Code i GitHub Copilot.
- Cursor – do pracy w środowisku Cursor IDE.
- Windsurf – do integracji z regułami projektu.
- Codex – do pracy z Codex.
- Antigravity – do integracji z Antigravity.
Opcjonalne Claude Skills
Możesz dodać specjalne umiejętności Claude Skills dla n8n. Pomagają one AI budować bardziej dopracowane workflow produkcyjne. To opcjonalny dodatek. Nie jest wymagany do podstawowego działania n8n-MCP.Konfiguracja projektu Claude
Przy pracy z Claude Projects możesz dodać instrukcje systemowe dla n8n-MCP. Takie instrukcje uczą AI właściwego procesu pracy z workflow. Obejmują między innymi wyszukiwanie szablonów, dobór węzłów, walidację i ostrożne wdrażanie zmian.
💡 Wskazówka: Zacznij od dashboardu, jeśli chcesz szybko przetestować n8n-MCP. Samodzielny hosting wybierz wtedy, gdy potrzebujesz większej kontroli.
Bezpieczny proces wdrożenia
Przed użyciem AI do pracy z workflow przygotuj bezpieczny proces testowania.- Zrób kopię workflow.
- Przetestuj zmiany w środowisku developerskim.
- Wyeksportuj backup ważnych workflow.
- Zweryfikuj zmiany przed wdrożeniem na produkcję.
FAQ – n8n-MCP
Do czego służy n8n-MCP?
n8n-MCP pomaga Twojemu asystentowi AI lepiej rozumieć n8n. Możesz dzięki temu wyszukiwać węzły, sprawdzać ich konfigurację, korzystać z szablonów i walidować workflow.
Czy n8n-MCP może pracować z Twoją instancją n8n?
Tak, ale wymaga to konfiguracji dostępu do API n8n. Potrzebujesz wartości N8N_API_URL oraz N8N_API_KEY. Po konfiguracji AI może tworzyć, pobierać, aktualizować, testować i sprawdzać workflow.
Czy możesz korzystać z n8n-MCP bez instalacji lokalnej?
Tak. Możesz zacząć przez dashboard.n8n-mcp.com, pobrać klucz API i połączyć klienta MCP. Darmowy plan obejmuje 100 wywołań narzędzi dziennie.
Czy n8n-MCP pomaga budować workflow od zera?
Tak, ale najpierw może sprawdzić gotowe szablony. Serwer udostępnia bibliotekę 2 352 szablonów workflow. Dzięki temu AI może szybciej znaleźć punkt startowy zamiast tworzyć wszystko od początku.
Jakie informacje o węzłach n8n są dostępne?
n8n-MCP udostępnia informacje o 1 650 węzłach n8n. Obejmuje to węzły core, węzły społecznościowe, właściwości, operacje, dokumentację i przykładowe konfiguracje.
Czy n8n-MCP sprawdza poprawność workflow?
Tak. Możesz sprawdzać pojedyncze węzły oraz całe workflow. Walidacja obejmuje między innymi wymagane pola, konfigurację, połączenia, wyrażenia i elementy związane z AI Agentami.
Czy AI może automatycznie poprawiać workflow?
Tak, jeśli masz skonfigurowane API n8n. Narzędzie n8n_autofix_workflow może poprawiać typowe błędy workflow. Nadal warto sprawdzić zmiany przed użyciem ich w produkcji.
Czy możesz edytować produkcyjne workflow bezpośrednio z pomocą AI?
Nie jest to bezpieczne podejście. Najpierw zrób kopię workflow, wykonaj backup i przetestuj zmiany w środowisku developerskim. Dopiero po walidacji przenieś zmiany na produkcję.
Kompatybilne między innmi z:
SZYBKA INSTALACJA
Code
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": [
"n8n-mcp"
],
"env": {
"MCP_MODE": "stdio",
"LOG_LEVEL": "error",
"DISABLE_CONSOLE_OUTPUT": "true"
}
}
}
}