Menu
Přihlásit
Článek N8N

n8n Skills pro Claude Code: oficiální balíček a MCP

n8n Skills pro Claude Code: oficiální balíček pravidel nad MCP. Zjisti, co obsahuje 14 skills, jak je nainstalovat a kdy stačí komunitní n8n-mcp.

Aktualizováno 8 min čtení 13 sekcí

Obsah článku 13 sekcí

V kostce

  • Oficiální n8n Skills jsou vrstva pravidel nad MCP: MCP dává Claude Codu přístup k instanci, skills říkají, jak workflow stavět.
  • Balíček n8n-io/skills má 14 dovedností a meta-skill, licence Apache 2.0; vyžaduje n8n 2.2.0+ se zapnutým Instance-level MCP.
  • Instalace jsou tři kroky: /plugin marketplace add n8n-io/skills, /plugin install n8n-skills@n8n-io a přihlášení v /mcp.
  • Začni na testovací instanci a žádej nejdřív návrh; komunitní n8n-mcp přidej, až ti bude chybět databáze uzlů nebo validace.
n8n Skills pro Claude Code: oficiální balíček a MCP - ilustrační obrázek

n8n Skills pro Claude Code jsou oficiální balíček markdown dovedností od týmu n8n, který Claude Codu říká, jak se v n8n správně chovat: jak psát výrazy, konfigurovat uzly, ošetřit chyby nebo ladit rozbitý workflow. Samotné skills ale nic nespouštějí. Spojení s instancí zajišťuje oficiální MCP server n8n, a právě to spojení dělá z obou kousků použitelný nástroj. Tenhle článek ukazuje, co balíček obsahuje, jak ho nainstalovat a kdy ti stačí MCP samotné.

Poctivá poznámka k podkladům: Ohlasy z YouTube a X necituji, protože jsem je neověřoval. Všechna fakta níže pocházejí z veřejného repozitáře n8n a z diskuse maintainera komunitního balíčku (odkazy v textu). Instalaci jsem v tomto článku sám nezkoušel na živé instanci, kroky vycházejí z README repozitáře ke dni 2. 11. 2026.

Co jsou n8n Skills a čím se liší od MCP

Rozdíl je jednoduchý, když si ho zapamatuješ jako dvě vrstvy:

  • MCP server je spojení. Claude Code přes něj čte a vytváří workflow ve tvé instanci n8n, spouští je a čte výsledky.
  • Skills jsou standard práce. Krátké dokumenty, které Claude načte, když se úkol týká daného tématu, a řídí se jimi: osvědčené postupy, typické chyby, pravidla pojmenování.

Repozitář n8n-io/skills to shrnuje větou, že MCP vytváří spojení a skills nastavují laťku kvality. Bez skills Claude workflow složí, ale často po svém: špatně zapíše výraz, zbytečně sáhne po Code uzlu nebo zapomene na error handling. Se skills dostane stejný přístup k instanci plus pravidla, jak má vypadat dobrý výsledek.

Pokud MCP ještě neznáš, začni článkem Od n8n workflow k AI nástroji: n8n jako MCP server pro Claude. Obecný princip dovedností vysvětluje Claude Skills: vlastní dovednosti agenta.

Co je uvnitř balíčku

Podle README (stav k 2. 11. 2026) obsahuje balíček 14 dovedností a jednu směrovací. Licence je Apache 2.0, repozitář měl v době psaní kolem 570 hvězdiček a prázdnou sekci Releases, takže oficiální číslované vydání jsem nenašel. Počítej s tím, že se obsah může měnit.

Oblast Skills
Životní cyklus n8n-workflow-lifecycle-official, n8n-subworkflows-official, n8n-extending-mcp-official
Konfigurace n8n-expressions-official, n8n-node-configuration-official, n8n-code-nodes-official, n8n-loops-official
AI v n8n n8n-agents-official, n8n-ai-nodes-official
Provoz a bezpečnost n8n-error-handling-official, n8n-credentials-and-security-official, n8n-debugging-official
Data n8n-binary-and-data-official, n8n-data-tables-official
Směrování using-n8n-skills-official (meta-skill, načítá se při startu relace)

Z praxe nejdůležitější jsou tři: expressions (většina rozbitých workflow padá na výrazech typu {{ $json.pole }}), error handling (webhooky a produkční spolehlivost) a debugging. Pokud stavíš agenty, přidej agents a ai-nodes. Na spolehlivost agentů navazuje N8N AI agent, který nespadne: error handling a retry.

Co potřebuješ před instalací

  • instance n8n na libovolném plánu, Cloud i self-hosted,
  • zapnuté Instance-level MCP (Settings → Instance-level MCP),
  • n8n minimálně ve verzi 2.2.0, doporučená je poslední stabilní,
  • Claude Code s podporou pluginů.

Pokud provozuješ vlastní instanci, projdi si ještě n8n v produkci: self-hosted AI workflow. Přístup k MCP znamená, že agent může měnit tvoje workflow, a to chceš mít zabezpečené.

Jak n8n Skills nainstalovat do Claude Code

Postup z README pro CLI má tři kroky.

1. Přidej marketplace

V relaci claude spusť:

/plugin marketplace add n8n-io/skills

2. Nainstaluj plugin a zadej adresu instance

/plugin install n8n-skills@n8n-io

Instalace se zeptá na základní URL tvé instance, například https://firma.app.n8n.cloud, bez cesty na konci. Potom spusť /reload-plugins.

3. Přihlas MCP

Spusť /mcp, vyber n8n-mcp a zvol Authenticate. Plugin si MCP server přibalí sám, takže ho nemusíš ručně konfigurovat.

Pozor pokud už n8n MCP máš připojené jinde, zakaž duplicitní spojení v /mcp. Dvě kopie téhož serveru mate agenta, který pak nástroje volí náhodně.

V desktopové aplikaci jde o stejný princip: po přidání marketplace přidáš plugin přes + → Plugins, v Settings → Connectors připojíš n8n-mcp a přihlásíš se. Kroky pro Codex a další klienty najdeš přímo v README.

Jak to vypadá v běžném zadání

Dobré zadání říká, co se má stát, ne jak se mají skládat uzly. Skills se načtou samy podle tématu. Příklad:

Vytvoř workflow: webhook přijme objednávku, ověří, že pole email a total
jsou vyplněná, uloží ji do Data Table "objednavky" a při chybě pošle
upozornění do Slacku. Nejdřív mi ukaž návrh, nic neaktivuj.

Co od skills čekat:

  • návrh projde pravidly pro životní cyklus (nejdřív plán, pak teprve změna instance),
  • chyba na webhooku se ošetří podle error-handling skillu,
  • deduplikace objednávek poběží přes Data Tables, ne přes improvizovaný uzel,
  • po vytvoření workflow ti agent řekne, co ještě chybí, třeba přihlašovací údaje.

Doporučený rytmus: požádej o návrh, zkontroluj ho, teprve potom povol vytvoření a nakonec ručně spusť test. Aktivaci produkčního workflow nech vždy na sobě. Obecně k bezpečnému nasazení MCP v týmu viz MCP servery v produkci: jak ochránit AI agenty.

Oficiální balíček, nebo komunitní n8n-mcp a n8n-skills?

Existuje i komunitní projekt czlonkowski/n8n-mcp s vlastním balíčkem n8n-skills. V diskusi z 8. dubna 2026 maintainer popisuje rozdíl takto: skill vede úvahu („takhle přemýšlej, když chce uživatel workflow"), zatímco MCP dodává ground truth, tedy přesná schémata uzlů a šablony. Podle jeho čísel z diskuse pokrývá jeho server přes 1 300 uzlů a víc než 2 700 šablon workflow. Uvedená čísla jsou jeho vlastní tvrzení a mění se s verzemi.

Oficiální n8n-io/skills Komunitní n8n-mcp + n8n-skills
Spojení Instance-level MCP přímo v n8n vlastní MCP server
Skills 14 + meta-skill 7 až 14 (README a wiki se liší)
Silná stránka shoda s produktem, podpora n8n databáze uzlů, šablony, validace před nasazením
Instalace plugin z marketplace plugin nebo ruční kopie

Maintainer komunitního projektu sám doporučuje kombinaci obou přístupů, protože řeší různé věci. Pro začátek bych zvolil oficiální balíček: míň součástí, jeden dodavatel a jasná minimální verze. Komunitní server přidej, až narazíš na to, že ti chybí šablony nebo validace.

Příklad: oprava rozbitého workflow s debugging skillem

Druhý typický úkol je oprava. Místo „oprav to" dej agentovi kontext a omez, co smí udělat:

Workflow "Import objednávek" od včerejška padá na uzlu Set. Najdi poslední
neúspěšné spuštění, vysvětli příčinu a navrhni minimální opravu výrazu.
Workflow neupravuj, dokud nepotvrdím.

Skill pro ladění vede agenta k pořadí, které by zvolil zkušený člověk: nejdřív přečíst chybu a vstupní data neúspěšného běhu, potom ověřit výraz a teprve nakonec měnit konfiguraci uzlu. To je přesně ten rozdíl proti agentovi bez skills, který často začne přepisovat půlku workflow, i když chyba je v jediném výrazu. Výsledek vždy porovnej s tím, co vidíš v editoru n8n; agent může popsat příčinu sebejistě a přesto se mýlit.

Aktualizace a údržba balíčku

Repozitář je živý (v době psaní měl 96 commitů a otevřené issues i pull requesty), takže se obsah dovedností bude měnit. Doporučuju tři návyky:

  • po větší aktualizaci n8n zkontroluj, zda plugin stále odpovídá tvé verzi,
  • občas spusť /reload-plugins, aby se načetly nové verze dovedností,
  • pokud ti skill radí něco, co se liší od dokumentace n8n, věř dokumentaci a založ issue v repozitáři (README žádá otevřít issue před pull requestem).

Takhle udržíš výhodu oficiálního balíčku: je psaný týmem, který produkt vyvíjí, ale jen proto, že ho udržuješ aktuální.

Přihlašovací údaje a bezpečnost

Skill n8n-credentials-and-security-official existuje z dobrého důvodu: nejčastější chyba při stavbě workflow s AI je API klíč vložený rovnou do uzlu nebo do promptu. Správný postup je vytvořit credentials v n8n a v uzlech na ně jen odkazovat. Agent se tím řídit bude, pokud mu to nezakážeš zadáním. Navíc platí obecné pravidlo pro jakýkoli MCP: dej mu jen takový přístup, jaký úkol vyžaduje. Testovací projekt s omezenými právy je lepší než administrátorský účet na produkci, protože případná chyba agenta zůstane v pískovišti. Při schvalování nástrojů si také ověř, odkud plugin pochází; k tomu se hodí text Falešné MCP servery roznášejí malware.

Kdy skills nepotřebuješ

Skills mají smysl, jakmile s agentem workflow opravdu stavíš. Nedávají smysl, když:

  • n8n používáš jen jako cíl a agent tvoje workflow pouze spouští (stačí MCP nebo webhook),
  • máš jednu hotovou automatizaci a nic nového nestavíš,
  • nemáš zapnuté Instance-level MCP, protože bez něj plugin nemá s čím mluvit.

Pokud nevíš, jestli n8n vůbec zvolit, porovnání najdeš v článku N8N vs Make vs Zapier.

Praktický checklist před prvním použitím

  1. Ověř verzi n8n (minimálně 2.2.0).
  2. Zapni Instance-level MCP a vytvoř si testovací instanci nebo projekt.
  3. Nainstaluj plugin, /reload-plugins, v /mcp se přihlas.
  4. Zkontroluj, že v /mcp není duplicitní n8n server.
  5. První zadání formuluj jako „navrhni, nic nevytvářej".
  6. Po každé větší změně si workflow projdi v editoru n8n.
  7. Přihlašovací údaje nikdy nevkládej do promptu, použij credentials v n8n.

Časté otázky

Jsou n8n Skills zdarma?

Samotný balíček je open source pod licencí Apache 2.0. Potřebuješ ale instanci n8n (Cloud i self-hosted, jakýkoli plán) a Claude Code, jehož cenu řeší Kolik stojí Claude Code 2026.

Potřebuju k n8n Skills i MCP server?

Prakticky ano. Skills říkají, jak workflow stavět, ale k instanci se připojuje MCP. Oficiální plugin si MCP přibaluje, takže při instalaci jen zadáš adresu instance a přihlásíš se.

Funguje to s n8n Cloud i self-hosted?

Ano, README uvádí obojí. Podmínka je zapnuté Instance-level MCP a verze minimálně 2.2.0.

Mohu používat oficiální skills spolu s komunitním n8n-mcp?

Technicky ano, ale hlídej duplicitní nástroje. Pokud oba servery nabízejí podobné funkce, agent může volit nepředvídatelně. Začni jedním, druhý přidej cíleně.

Může agent workflow rozbít?

Má přístup k instanci, takže ano, stejně jako každý, kdo do ní smí zapisovat. Proto pracuj na testovacím projektu, žádej nejdřív návrh a produkční workflow aktivuj sám.

Shrnutí

Oficiální n8n Skills jsou vrstva pravidel nad MCP: MCP dává Claude Codu ruce, skills mu říkají, jak s nimi pracovat. Instalace jsou tři příkazy, podmínkou je n8n 2.2.0+ se zapnutým Instance-level MCP. Začni na testovací instanci, žádej návrhy místo okamžitých změn a komunitní n8n-mcp přidej, až ti bude něco chybět. Další kroky najdeš ve článku Remote MCP servery: připoj GitHub, Linear a Notion jedním URL.

Pokračuj dál

Všechny články →