n8n-mcp MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Full-text search across 500+ n8n nodes with schemas
Workflow JSON validator — catches bad configs before deploy
Template library + fetchable JSON for starting points
Optional: manage workflows on a real n8n instance (create, update, trigger, audit)

Demo ao vivo

Como fica na prática

n8n-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "n8n-mcp",
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "n8n-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "n8n-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add n8n-mcp -- npx -y n8n-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: n8n-mcp

Build an n8n workflow from a plain-English description

👤 Ops engineers, indie hackers using n8n ⏱ ~20 min intermediate

Quando usar: You know what you want ('every new Typeform goes to Notion + Slack') but don't want to click through the n8n UI for 20 minutes.

Pré-requisitos

n8n instance (cloud or self-hosted) — Any working n8n; needed only for deploy step, not for design
N8N_API_URL + N8N_API_KEY — n8n Settings → n8n API → create API key

Fluxo

Search nodes for each step

I want: Typeform webhook → parse → create Notion page → post to Slack. Search for the exact node types I need.✓ Copiado

→ Node names + required credentials identified
Generate the workflow JSON

Generate a complete workflow with those 4 nodes wired in order. Use a template as a base if one matches.✓ Copiado

→ Valid n8n workflow JSON
Validate and deploy

Validate the JSON with validate_workflow. Fix any errors. Then deploy to my n8n as a draft (not active).✓ Copiado

→ Workflow appears in n8n UI in draft state

Resultado: A working n8n workflow, 10x faster than manual clicking, with validation catching misconfigs before you hit Run.

Armadilhas

Credentials have to be set up in n8n first — JSON references them by ID — Create credential entries in n8n UI before deploy; pass the credential IDs to the agent
Agent deploys as active and immediately fires on historical data — Always deploy inactive; activate manually after testing in n8n UI

Audit your n8n instance for broken or dangerous workflows

👤 Ops leads inheriting an n8n instance ⏱ ~30 min intermediate

Quando usar: You took over an n8n instance with 50 workflows, no docs. You need to know what's there and what's risky.

Fluxo

List all workflows

List every workflow with name, active status, last execution time, and node count.✓ Copiado

→ Full inventory
Flag risky patterns

Find workflows with: no error handling, webhook triggers with no auth, HTTP Request nodes to random URLs, or shell command nodes.✓ Copiado

→ Risk list with rationale
Check failure rates

For each active workflow, get last 20 executions. Compute failure rate. Flag anything >20%.✓ Copiado

→ Broken workflow list

Resultado: A risk + health inventory — know what to fix, freeze, or delete.

Armadilhas

Disabling a workflow that other workflows depend on (via Execute Workflow node) — Before disabling, search other workflows for references to the target by ID

Start from a template and customize it

👤 New n8n users ⏱ ~15 min beginner

Quando usar: Someone has likely built something close to what you need — use that as a starting point.

Fluxo

Search templates

Find templates that do: 'sync a CSV to a database with deduplication'.✓ Copiado

→ 3-5 candidate templates ranked by relevance
Fetch and adapt

Get the JSON for the top match. Adapt nodes to use my actual database (Postgres at host X) and my CSV source (S3 bucket Y).✓ Copiado

→ Customized workflow JSON
Validate and deploy

Validate, then deploy as draft to my n8n.✓ Copiado

→ Draft workflow in n8n

Resultado: A working workflow in 10 minutes by standing on someone else's shoulders.

Armadilhas

Templates use deprecated node versions — Check validate_workflow output for version warnings; swap in current nodes

Combinações

Combine com outros MCPs para 10× de alavancagem

n8n-mcp + notion

Scaffold an n8n workflow that writes to a specific Notion database — look up the DB schema first

Look up my Notion 'Leads' database schema. Then build an n8n workflow that takes webhook input and creates matching entries.✓ Copiado

n8n-mcp + linear

Auto-create Linear tickets for n8n workflow failures

Audit my n8n for workflows failing >20% of runs. For each, create a Linear bug.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
tools_documentation	tool_name?	Discover available tools	free
search_nodes	query, limit?	Find which n8n nodes match a need	free
get_node	node_type, mode?	Deep-dive on a specific node before wiring it	free
validate_node	node JSON	Check a single node config	free
validate_workflow	workflow JSON	Always — before any deploy	free
search_templates	query/keywords/nodes	Find prior art before building from scratch	free
get_template	template_id	Fetch a chosen template	free
create_workflow / update_workflow / delete_workflow	requires N8N_API_URL/KEY	Deploy or mutate on the real instance	1 n8n API call
trigger_workflow / get_executions	workflow_id, data?	Test a deployed workflow	1 n8n API call
audit_instance		Periodic instance review	multiple API calls

Custo e limites

O que custa rodar

Cota de API: Search/validate tools: unlimited (local data). Management tools: limited by your n8n instance's capacity.
Tokens por chamada: Node schemas can be large (2-5k tokens); use get_node with mode='minimal' when you just need types
Monetário: Free MCP; n8n has a cloud tier ($20+/mo) or self-host for free
Dica: Design fully with search/validate first (free). Only call create/update once you're sure — each deploy costs a quota slot on n8n cloud

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: N8N_API_KEY in env var — treat like an admin token since it can create workflows

Saída de dados: n8n-mcp MCP itself runs locally. Management tools call your N8N_API_URL.

Solução de problemas

Erros comuns e correções

Management tools not appearing

N8N_API_URL or N8N_API_KEY not set. Management tools only register when both env vars are present at startup.

Verificar: echo $N8N_API_URL && echo $N8N_API_KEY | cut -c1-6

validate_workflow passes but n8n rejects at deploy

Likely a credential reference issue. Credentials are validated against names in your n8n instance — verify the credential names match exactly.

Workflow deploys but fails on first run with 'Node type not found'

You're using a node from a community package not installed on the n8n instance. Install it in n8n first or swap to a core node.

Template JSON uses deprecated node versions

After fetching, pass through validate_workflow — it flags deprecated versions. Upgrade nodes before deploy.

Alternativas

n8n-mcp vs. outros

Alternativa	Quando usar	Troca
Zapier MCP	Your team is on Zapier not n8n	Hosted only; less control but more polished integrations
Make (Integromat) MCP	Your team is on Make	Hosted; scenario model differs from n8n's graph model
Raw n8n REST API	You want code-level control from a custom script	No node catalog or validation — you're on your own for correctness

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills