Claude Code + n8n MCP: automatizace z promptu

Představ si, že si do terminálu napíšeš „postav mi workflow, který každou hodinu kontroluje nové leady, nechá Claude ohodnotit jejich kvalitu a ty nejlepší pošle do Slacku“ — a o pět minut později máš v n8n hotový, otestovaný a publikovaný workflow. Přesně tohle dnes umí kombinace Claude Code a n8n MCP serveru a je to téma, které během posledních týdnů ovládlo AI kanály na YouTube. V tomto článku ti ukážu, jak propojení Claude Code a n8n přes MCP rozjet krok za krokem, co si od něj reálně čekat — a kde je potřeba zastavit a převzít kontrolu.

01Co vlastně je n8n MCP server

n8n má od verze 2.13 vestavěný MCP server na úrovni celé instance. Zapneš ho v nastavení Settings → Instance-level MCP a n8n ti vygeneruje URL, které končí na /mcp-server/http. Tu jednu adresu pak přidáš do Claude Code a od té chvíle agent vidí přímo do tvé instance: umí prohledávat existující workflow, číst jejich konfiguraci, vytvářet nové workflow, editovat je, validovat, testovat a publikovat.

Přesně to je rozdíl oproti všemu, co tu dřív bylo. Dosud jsi musel workflow buď klikat ručně v editoru, nebo nechat Claude vygenerovat JSON, který jsi ručně importoval. S MCP serverem se celá smyčka uzavírá uvnitř jednoho rozhovoru: popíšeš úkol, agent workflow postaví, rovnou v n8n zkontroluje, jestli je validní, spustí test a výsledek ti ukáže.

Konkrétní nástroje, které agent přes MCP server dostane, pokrývají celý životní cyklus: search_workflows a get_workflow_details pro orientaci v existující automatizaci, create_workflow_from_code a update_workflow pro stavbu a úpravy, validate_workflow, test_workflow a publish_workflow pro kontrolu a vydání, execute_workflow a search_workflow_executions pro běh a ladění. K tomu přibývají nástroje pro složky, tagy, credentials, datové tabulky i n8n Agenty.

Je dobré vědět, že n8n má vlastně dva MCP mechanismy, které se často zaměňují:

• Instance-level MCP — jedno připojení na celou instanci, centrální přihlášení, sám si vybíráš, které workflow budou přes MCP dostupné. Tohle je cesta pro Claude Code.
• MCP Trigger node — uzel přímo uvnitř jednoho workflow, kterým vystavíš jeho nástroje ven. Hodí se, když chceš pro jeden konkrétní workflow vyladit chování jako MCP serveru. Tuhle variantu, tedy opačný směr (n8n workflow jako nástroj pro Claude), jsme podrobně rozebírali v článku od n8n workflow k AI nástroji.

Podobný vzorec „agent v terminálu + MCP vrstva nad automatizační platformou“ jsme tu měli i u Claude Code a Zapier MCP. n8n má ale dvě velké výhody: automatizace jsou v něm sice složitější, ale mnohem mocnější — a hlavně o celý MCP stack se stará přímo tým n8n, od serveru přes dokumentaci až po skills plugin.

02Co potřebuješ, než začneš

Seznam je krátký, ale jsou v něm dvě tvrdá pojistky:

• Instanci n8n od verze 2.13. Prohlížet a spouštět workflow jde přes MCP i na starších verzích, ale vytvářet a upravovat workflow umí MCP server až od 2.13.0. Pokud provozuješ vlastní n8n (jak popisuje náš průvodce self-hosted instancí), zkontroluj si aktuální verzi; na n8n Cloud ji mít budeš automaticky.
• Práva vlastníka nebo admina na dané instanci — MCP přístup zapne jen on.
• Nainstalovaný Claude Code. Pokud s ním teprve začínáš, mrkni na náš kompletní průvodce Claude Code.
• Rozmyslet, které workflow agent uvidí. MCP neodhalí slepě celou instanci: každý workflow musíš pro MCP přístup individuálně povolit (přepínač Available in MCP).

Pozor všichni připojení klienti vidí všechny workflow, které pro MCP povolíš. Pokud připojíš Claude Code i ChatGPT, oba uvidí totéž — per-klient omezení tu není.

03Jak propojit Claude Code s n8n krok za krokem

Zapni MCP na instanci n8n

V n8n otevři Settings → Instance-level MCP a klikni na Enable MCP access. Od verze 2.33 je k dispozici dialog Connect a client: vybereš klienta (Claude Code, Codex, Gemini CLI, Cursor, Windsurf…) a n8n ti ukáže Server URL, které končí na /mcp-server/http. Tuhle adresu si zkopíruj — není to adresa editoru z prohlížeče, ale samostatný endpoint přímo pro MCP.

Připoj Claude Code přes OAuth

Doporučená cesta je OAuth. V terminálu stačí jeden příkaz:

claude mcp add --transport http n8n https://<tvoje-n8n-domena>/mcp-server/http

Pak v Claude Code spusť /mcp, vyber server n8n a potvrď autorizaci — otevře se prohlížeč, přihlásíš se do n8n a hotovo. Nikam nedoplňuješ žádný token ručně.

Alternativa: API token

Pokud nechceš OAuth (třeba na lokální instanci bez prohlížeče), vygeneruj v n8n token a připoj se s hlavičkou:

claude mcp add --transport http n8n-mcp https://<tvoje-n8n-domena>/mcp-server/http \
  --header "Authorization: Bearer <TVUJ_N8N_MCP_TOKEN>"

Funguje úplně stejně, jen token musíš občas rotovat (n8n na to má v nastavení tlačítko) a pamatovat na něj.

Zkratka: oficiální plugin n8n-skills

Tým n8n vydal repozitář n8n-io/skills (vznikl v dubnu 2026 a průběžně se aktualizuje), který celé nastavení ještě zjednodušuje a hlavně agenta výrazně zlepšuje. V Claude Code stačí:

/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io

Instalátor se sám zeptá na URL tvé instance (doplní /mcp-server/http za tebe), po /reload-plugins a OAuth přes /mcp máš vše připojené. Navíc dostaneš sadu dovedností (k 2. 11. 2026 jich README uvádí 14 plus jednu směrovací) pokrývající celý životní cyklus workflow — od sub-workflow, výrazů a stránkování po error handling a credentials — plus 50+ referenčních dokumentací a ukázkových JSON, které se agentovi načítají podle potřeby. Rozdíl v kvalitě vygenerovaných workflow je znát: agent zná úskalí každého node, takže první verze bývá použitelná místo „skoro použitelná“.

04Automatizace z promptu v praxi: reálný příklad

Takto vypadá typický průchod, když v Claude Code napíšeš třeba: „V n8n mi postav workflow: nové řádky z Google Sheet každé ráno v 8 projde AI agentem, který leady ohodnotí 0–100 a ty nad 70 zapíše do Slack kanálu #sales.“

1. Kontrola, zda už něco podobného neexistuje. Agent zavolá search_workflows a podívá se po workflow s podobným názvem nebo tagem, než začne stavět nový.
2. Návrh a vytvoření. Pomocí create_workflow_from_code a update_workflow poskládá celý workflow včetně triggerů, nodů a propojek.
3. Validace před spuštěním. Nástrojem validate_workflow nechá n8n zkontrolovat konfiguraci — chybějící povinná pole nebo špatně propojené nody odhalíš dřív, než cokoli spustíš.
4. Test a publikace. test_workflow spustí nepublikovanou verzi s testovacími daty a publish_workflow ji pak vydá do produkce.

Agent přitom vidí i historii provedení (search_workflow_executions), takže když test spadne, dočte se proč a opraví to. A pokud má tvoje instance agents feature, umí přes MCP stavět a publikovat i n8n Agenty.

Realistická očekávání ale nastav hned teď: na rutinní workflow (notifikace, synchronizace, jednoduché AI zpracování) je to zázrak a ušetří ti hodiny. U komplexních, hodně specifických workflow se zkušenosti z komunity shodují, že agent řeší tak polovinu práce — zbytek doděláš v editoru sám. To pořád znamená, že ti píše složité JSON nastavení uzlů místo tebe.

Světová komunita přitom reálně staví i velké věci: na fóru n8n běžně najdeš popisy produkčních workflow s desítkami uzlů postavených ve spolupráci Claude × n8n přes MCP, včetně ladění chyb přímo z terminálu. Fungující pracovní návyk je stejný jako u každého AI agenta: nech agenta navrhnout a zvalidovat, pak si výsledek otevři v editoru, projdi propojení a teprve potom publikuj. Agent ti může přidávat jako druhého pilota, ale řízení držíš pořád ty.

Pro koho se to hodí pro každého, kdo už n8n používá a chce zrychlit stavbu automatizací; pro vývojáře, kteří spravují větší farmu workflow; a pro neprogramátory, kterým Claude Code píše skripty za ně a teď jim postaví i celý integrační workflow.

05Oficiální skills proti komunitnímu n8n-mcp

Než přišel oficiální MCP server, fungovala tahle kombinace přes populární komunitní řešení czlonkowski/n8n-mcp (23 000+ hvězd, aktivně vyvíjený od června 2025): open-source server, který AI asistentům dává kompletní dokumentaci zhruba 525 n8n uzlů včetně vlastností a operací. Funguje s Claude Code, Cursorem, Windsurfem i VS Code a pořád je skvělá volba, pokud máš starší n8n (pod 2.13), kde se přes oficiální MCP ještě nedají workflow vytvářet, nebo chceš agenta hlavně doučit znalosti n8n.

Pro nové nasazení bych šel do oficiální stacku: instance-level MCP pro spojení a n8n-skills pro znalosti. Oficiální cestu udržuje přímo výrobce, OAuth funguje bez tahání tokenů a nástroje jako validate_workflow drží agenta na krátkém vodítku.

06Limity a bezpečnost: co hlídat, než agenta pustíš k produkci

• Workflow musíš povolit jednotlivě. Available in MCP je vypnuté defaultně, takže agent nevidí nahodile polovinu instance. Povol jen to, k čemu ho skutečně potřebuješ.
• execute_workflow spouští publikovanou verzi. Produktivní režim bere to, co je publikované — rozpracované změny v editoru se netýkají toho, co přes MCP skutečně běží.
• Credentials zůstávají v n8n. Agent může seznam credentials procházet, ale tajemství nevidí. Stejně je dobré mít pro agenta samostatný API klíč s minimálními právy a tokeny pravidelně rotovat.
• Přístup lze kdykoli revokovat. V Settings → Instance-level MCP vidíš připojené klienty a můžeš je odpojit jedním klikem.
• Falešné MCP servery existují. Neinstaluj nic mimo oficiální repozitáře a vlastní instanci; jak ověřovat MCP nástroje před instalací jsme řešili v článku o falšovaných MCP serverech.

Více o MCP bezpečnosti obecně najdeš v našem průvodci nasazení MCP serverů ve firmě.

07Časté otázky