Issue 2 10.05.2026 · Lesezeit 7 Min Beta

Claude Code redet jetzt direkt mit deinem n8n.

n8n hat im April 2026 einen Instance-level MCP-Server gelauncht. OAuth oder Token, drei Client-Typen, acht Workflow-Tools — und ein klarer Unterschied zum bekannten MCP Server Trigger Node, den die meisten verwechseln.

Setup-Bundle

Copy-Paste-Configs · Velo-CLAUDE.md-Vorlage (4 KB)

Claude Code, Claude Desktop, Codex CLI Templates plus Velo-Konventionen.

Herunterladen (4 KB)

Doku-Quelle: docs.n8n.io · Status: Beta (April 2026)

Worum es geht

Bisher musstest du, um Claude Code mit n8n zusammenarbeiten zu lassen, jeden Workflow als Webhook bauen oder den MCP Server Trigger Node innerhalb eines einzelnen Workflows verwenden. Beides funktioniert — aber es ist pro Workflow, nicht pro Instanz.

Was im April neu kam: Instance-level MCP. Eine zentrale Verbindung pro n8n-Instanz mit zentraler Authentifizierung. Du toggelst MCP global an, gibst pro Workflow frei welche der MCP-Client sehen darf, und Claude Code kann dann alle freigegebenen Workflows in einem Rutsch durchsuchen, ausführen, testen und (ab v2.13) sogar bauen.

Der Unterschied in einem Satz: MCP Server Trigger Node = ein einzelner Workflow stellt Tools bereit. Instance-level MCP = die ganze n8n-Instanz wird zum MCP-Server für Claude.

Was ist MCP eigentlich? (90 Sekunden)

Falls du noch nie mit MCP gearbeitet hast: Model Context Protocol ist ein offener Standard, den Anthropic Ende 2024 vorgestellt hat. Vereinfacht: Eine Tür, durch die ein LLM — in unserem Fall Claude — mit externen Systemen sprechen kann, ohne dass du jeden Workflow neu erklären musst. Der Server bietet Tools an, der Client (Claude Code) entdeckt sie automatisch beim Start und kann sie aufrufen.

Drei Dinge solltest du kennen, dann reicht's:

1. Transport-Typen

  • stdio — lokales Programm wird als Subprozess gestartet (z. B. ein npm-Paket)
  • http — remote Server, klassische REST-Verbindung mit Auth-Header (so läuft n8n)
  • sse — Server-Sent-Events für Streaming (älteres Pattern, immer seltener)

Bei n8n nutzen wir http — deine n8n-Domain ist der Endpoint, der Token geht im Authorization: Bearer ...-Header mit.

2. Wie MCP-Server in Claude Code landen

Zwei Wege, beide gleichwertig:

# Weg A: per CLI (empfohlen)
claude mcp add <name> <command-or-url>
claude mcp list
claude mcp remove <name>

# Weg B: ~/.claude.json direkt editieren
{
  "mcpServers": {
    "n8n": {
      "type": "http",
      "url": "https://...",
      "headers": { "Authorization": "Bearer ..." }
    }
  }
}

Nach dem Eintragen Claude Code neu starten. Die neuen Tools tauchen automatisch auf — mit /mcp im Chat siehst du alle aktiven MCP-Server und ihre Tools.

3. Project- vs. Global-Scope

MCP-Server kannst du global einrichten (gilt für alle Projekte) oder pro Projekt:

  • Global: ~/.claude.json — einmal eintragen, immer da
  • Pro Projekt: .claude/settings.local.json im Projekt-Root — geht nur in diesem Verzeichnis

Empfehlung für n8n: Pro Projekt, falls du verschiedene n8n-Instanzen für verschiedene Kunden hast. Sonst global.

Das war's. Mehr Theorie brauchst du erstmal nicht. Vertieft erklärt es Anthropic unter docs.claude.com/.../claude-code/mcp. Jetzt zum n8n-Teil.

Die acht zentralen Tools

Der MCP-Server bündelt Tools für drei Bereiche: Workflow-Management, Workflow-Building (v2.13+) und Data Tables. Hier die wichtigsten Workflow-Tools:

search_workflows

Sucht alle Workflows auf die der User Zugriff hat — auch ohne MCP-Freigabe. Liefert nur Vorschauen (Name, Description, IDs), nicht den vollen Graph. Filter: query, projectId, limit (max 200).

get_workflow_details

Volle Workflow-Details: alle Nodes, Connections, Tags, Trigger-Info als Klartext. Sensible Credential-Daten werden vor dem Returnen automatisch gestrippt.

execute_workflow

Führt einen Workflow aus. Default: production (published Version). Mit manual: aktuelle (unpublished) Version. Inputs: chat, form oder webhook. Returnt Execution-ID + Status.

test_workflow v2.15+

Testet einen Workflow mit Pin Data — Trigger, Credentialed Nodes und HTTP Requests werden simuliert. Set/If/Code-Nodes laufen normal. Ideal um Workflow-Logik zu validieren ohne externe Services zu triggern.

get_execution v2.12+

Execution-Details — Default Metadata, mit includeData=true volle Daten. Filter auf bestimmte Nodes per nodeNames, Truncate per truncateData. Unverzichtbar bei großen Executions.

create_workflow + update_workflow v2.13+

Workflows von Claude Code aus bauen oder editieren lassen. Volle Reference: docs.n8n.io/.../mcp_tools_reference.

Tipp aus der n8n-Doku: „Consider using coding agents (such as Claude Code or Google ADK agents) instead of chat clients as your MCP clients.“ Coding-Agents sind besser darin, valides TypeScript zu generieren — und n8n-Workflows sind im Kern eben das.

Setup in 4 Schritten

1. MCP-Zugriff aktivieren

n8n öffnen → Settings → Instance-level MCP → Toggle Enable MCP access. Du brauchst Owner- oder Admin-Rechte.

Self-Hosted komplett deaktivieren: N8N_DISABLED_MODULES=mcp als Env-Var. Alle MCP-Endpoints + UI verschwinden.

2. Token kopieren

Connection details → Tab Access Token. n8n generiert beim ersten Besuch automatisch einen Personal Access Token, an deinen User gebunden.

Wichtig: Token nur einmal sichtbar. Beim nächsten Besuch siehst du nur den redacted Wert. Direkt kopieren oder rotieren über Generate new token.

3. Workflows freigeben

Default: kein Workflow ist MCP-sichtbar. Drei Wege zum Freischalten:

  • MCP-Settings-Page (ab v2.2.0): Button Enable workflows
  • Im Workflow-Editor: Menü (...) → Settings → Available in MCP togglen
  • Workflow-Liste: Karten-Menü → Enable MCP access

Workflow-Beschreibungen pflegen — der MCP-Client nutzt sie, um den richtigen Workflow zu finden.

4. Client verbinden

Drei Wege je nach Setup — alle nutzen die gleiche URL https://<deine-domain>/mcp-server/http:

Drei Client-Setups

Claude Code (CLI)

claude mcp add --transport http n8n-mcp \
  https://YOUR-N8N-DOMAIN/mcp-server/http \
  --header "Authorization: Bearer YOUR_TOKEN"

Alternativ: Eintrag in ~/.claude.json (Template im Setup-Bundle). Nach Restart von Claude Code stehen die n8n-Tools direkt zur Verfügung.

Claude Desktop

Variante A — OAuth2: Settings → Connectors → Add custom connector. Name: n8n MCP, URL: deine n8n Base-URL. Auf Authorize klicken — n8n leitet zur Bestätigung weiter.

Variante B — Access Token: Eintrag in claude_desktop_config.json:

"mcpServers": {
  "n8n-local": {
    "type": "http",
    "url": "https://YOUR-N8N-DOMAIN/mcp-server/http",
    "headers": {
      "Authorization": "Bearer YOUR_TOKEN"
    }
  }
}

Codex CLI

Eintrag in ~/.codex/config.toml:

[mcp_servers.n8n_mcp]
url = "https://YOUR-N8N-DOMAIN/mcp-server/http"
http_headers = { "authorization" = "Bearer YOUR_TOKEN" }

Sicherheit & Limits

Was sicher ist

  • Credentials werden vor dem MCP-Output gestrippt
  • Token ist persönlich, an User-Account gebunden
  • OAuth-Clients siehst und revokest du im UI
  • Workflows sind opt-in — nichts ist standardmäßig sichtbar

Was du beachten musst

  • search_workflows sieht alle Workflows auf die du Zugriff hast
  • Connected Clients sehen alle freigegebenen Workflows — nicht client-spezifisch
  • n8n-Instanz muss public erreichbar sein für Cloud-MCP-Clients
  • Multi-Step-Forms und Human-in-the-Loop werden nicht via MCP unterstützt

Wann es sich lohnt — und wann nicht

Lohnt sich

  • Du hast n8n self-hosted und 5+ Workflows die du regelmäßig anpasst
  • Du willst Claude Code beim Workflow-Bauen unterstützen lassen (v2.13+)
  • Du baust einen eigenen Coding-Agent der n8n-Workflows als Tools nutzen soll
  • Test-Cycles ohne externe Services via test_workflow + Pin Data

Lohnt sich (noch) nicht

  • Produktiv-kritische Pipelines — das Beta-Label ist real, Breaking Changes sind möglich
  • Du arbeitest mit human-in-the-loop oder Multi-Step-Forms
  • Deine n8n-Instanz ist hinter Firewall ohne öffentlichen Zugang (Cloud-Clients erreichen sie nicht)
  • Du willst den klassischen MCP Server Trigger Node behalten — der bleibt unabhängig nutzbar

Mein Fazit

Das ist die Brücke, die n8n und Claude Code seit Monaten gebraucht haben. Wer schon mit n8n arbeitet und Claude Code nicht nur als Code-Assistent, sondern als Operations-Layer nutzen will, sollte heute aktivieren. Die acht Tools decken den Workflow-Lifecycle komplett ab — von Discovery über Test bis Production-Run.

Mein Tipp: Token rotieren-Plan setzen (alle 90 Tage), Workflows einzeln freigeben statt blind alles, und die Velo-CLAUDE.md-Vorlage aus dem Bundle in dein Projekt kopieren — sie hält Claude bei den Konventionen, die im Beta-Stadium wichtig sind (immer test_workflow vor execute_workflow, Pin Data nutzen, keine Production-Mode-Surprises).

Jetzt einrichten

n8n-MCP Setup-Bundle

Configs für Claude Code, Claude Desktop, Codex CLI plus Velo-CLAUDE.md-Vorlage mit n8n-Konventionen.

Herunterladen (4 KB ZIP)

Original-Doku: docs.n8n.io


Das war Issue 2 der wöchentlichen Velo-Wissen-Reihe. Jeden Sonntag um 15 Uhr eine Empfehlung — ein Tool, eine Bibliothek, ein Workflow oder ein Skill, das ich selbst getestet habe und für nützlich halte.