====== n8n-MCP: MCP server pro n8n ======

[[https://github.com/czlonkowski/n8n-mcp|n8n-MCP]] je open-source MCP server, který dává AI asistentům (Claude, Cursor, Windsurf a dalším) přístup k dokumentaci a správě n8n workflow nodů. Funguje jako most mezi [[https://n8n.io/|n8n]] a AI modely.

Server zpřístupňuje přes 1 000 nodů — jak core, tak komunitní — včetně jejich vlastností, operací a dokumentace. Podporuje také vyhledávání v šablonách, validaci workflow a (volitelně) přímou správu n8n instance přes API.

> ⚠️ **Bezpečnostní varování:** Nikdy needituj produkční workflow přímo pomocí AI. Vždy si nejdříve udělej zálohu nebo pracuj na kopii v testovacím prostředí.

===== Rychlé spuštění =====

Nejjednodušší způsob je přes ''npx'' bez instalace. Do konfigurace MCP klienta přidej:

<code json>
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}
</code>

Pro přístup ke správě workflow (vytváření, spouštění) přidej do ''env'' ještě:

<code json>
"N8N_API_URL": "https://tvoje-n8n-instance.com",
"N8N_API_KEY": "tvuj-api-klic"
</code>

Alternativně je dostupná hostovaná služba na [[https://dashboard.n8n-mcp.com|dashboard.n8n-mcp.com]] (free tier: 100 volání/den).

===== Alternativa: n8n Workflow Builder =====

Jako alternativa existuje [[https://github.com/makafeli/n8n-workflow-builder|n8n Workflow Builder MCP Server]]. Ten se podle README zaměřuje hlavně na přímou správu n8n workflow přes oficiální API. Umí listovat workflow, vytvářet je, upravovat, aktivovat a deaktivovat, spouštět je a mazat. Repozitář zmiňuje také práci s executions, tagy a generování security auditu.

Pro lokální spuštění používá ''npx'' a vyžaduje ''Node.js 18+'', URL n8n instance a API klíč:

<code json>
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@makafeli/n8n-workflow-builder"],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "tvuj-api-klic"
      }
    }
  }
}
</code>

K dispozici je i hostovaná varianta přes [[https://smithery.ai/server/@makafeli/n8n-workflow-builder|Smithery.ai]].

===== Doplňkový zdroj: hotové n8n šablony =====

Jako doplněk k MCP serverům se hodí [[https://github.com/wassupjay/n8n-free-templates|n8n-free-templates]]. Nejde o MCP server, ale o kurátorovanou sadu více než 200 hotových n8n workflow ve formátu JSON, rozdělených do více než 20 kategorií včetně AI/LLM, DevOps, financí nebo IoT.

Použití je jednoduché: vybraný JSON se importuje do n8n, u jednotlivých nodů se doplní credentials a workflow se pak může upravit nebo aktivovat. README zároveň upozorňuje, že část šablon je zatím nekompletní, takže se hodí spíš jako rychlý základ, ukázka nebo reference pro vlastní workflow.

===== Volitelně: Skills pro Claude Code =====

Repozitář [[https://github.com/czlonkowski/n8n-skills|n8n-skills]] obsahuje 7 doplňujících skills pro Claude Code, které učí AI správné vzory pro stavbu n8n workflow — včetně syntaxe výrazů, konfigurace nodů, validace a Code nodů v JavaScriptu i Pythonu.

Instalace přes Claude Code plugin:

<code bash>
/plugin install czlonkowski/n8n-skills
</code>

Skills se aktivují automaticky podle kontextu dotazu.

===== Zdroje =====

  * [[https://github.com/czlonkowski/n8n-mcp|GitHub: czlonkowski/n8n-mcp]] — MCP server, dokumentace, konfigurace
  * [[https://github.com/makafeli/n8n-workflow-builder|GitHub: makafeli/n8n-workflow-builder]] — alternativní MCP server pro správu n8n workflow
  * [[https://github.com/wassupjay/n8n-free-templates|GitHub: wassupjay/n8n-free-templates]] — knihovna hotových n8n workflow šablon
  * [[https://github.com/czlonkowski/n8n-skills|GitHub: czlonkowski/n8n-skills]] — Skills pro Claude Code
  * [[https://dashboard.n8n-mcp.com|dashboard.n8n-mcp.com]] — hostovaná varianta (free tier)
  * [[https://smithery.ai/server/@makafeli/n8n-workflow-builder|Smithery.ai: n8n Workflow Builder]] — hostovaná varianta alternativního serveru
  * [[https://n8n.io/|n8n.io]] — platforma pro workflow automatizaci