n8n und Claude Code verbinden: Komplette Anleitung zur MCP-Integration 2026

n8n und Claude Code verbinden steht im Mittelpunkt dieses Guides. Die Automatisierung von Geschäftsprozessen hat eine neue Dimension erreicht. Mit der Integration von n8n und Claude Code über das Model Context Protocol (MCP) können Sie jetzt komplette Workflows mit einem einzigen Prompt erstellen.

Der n8n-MCP-Server ist eine Open-Source-Bridge, die KI-Assistenten umfassenden Zugriff auf n8ns 1.084 Workflow-Automatisierungsknoten ermöglicht. In diesem Guide zeigen wir Ihnen, wie Sie diese leistungsstarke Kombination einrichten und nutzen.

Das Problem: Manuelle Workflow-Erstellung ist zeitaufwändig — n8n und Claude Code verbinden

Traditionell erfordert das Erstellen von n8n-Workflows mehrere Schritte:

• Manuelle Node-Konfiguration im n8n-Editor
• Testen und Debuggen jeder Verbindung
• Iteration durch Trial-and-Error
• Dokumentation der erstellten Workflows

Ein typischer Workflow kann Stunden an Entwicklungszeit kosten – Zeit, die Sie für wichtigere Aufgaben nutzen könnten.

Die Lösung: KI-gesteuerte Workflow-Automatisierung

Mit der n8n-MCP-Integration wird Claude Code zu Ihrem persönlichen Workflow-Architekten:

┌─────────────────┐     ┌─────────────┐     ┌──────────────┐
│   Claude Code   │────▶│  MCP Server │────▶│     n8n      │
│   (KI-Agent)    │◀────│  (Bridge)   │◀────│  (Workflows) │
└─────────────────┘     └─────────────┘     └──────────────┘
        │                                           │
        └──────── Natürliche Sprache ──────────────┘

Sie beschreiben einfach, was Sie automatisieren möchten, und Claude Code erstellt, validiert und deployt den Workflow automatisch.

Was ist das Model Context Protocol (MCP)?

Das Model Context Protocol (MCP) wurde von Anthropic Ende 2024 eingeführt und ist ein offener Standard, der definiert, wie KI-Modelle mit externen Systemen kommunizieren.

Seit Januar 2026 ist MCP 1.0 der De-facto-Standard für KI-Tool-Integration.

MCP-Kernkonzepte

Warum MCP wichtig ist

• Standardisierung: Einheitliche Schnittstelle für alle KI-Tools
• Sicherheit: Kontrollierter Zugriff auf externe Systeme
• Skalierbarkeit: Einmal entwickelte Server funktionieren mit allen MCP-kompatiblen Hosts
• Interoperabilität: Claude, GPT und andere Modelle können dieselben Tools nutzen

Was ist n8n?

n8n (ausgesprochen "n-eight-n") ist eine Open-Source-Plattform für Workflow-Automatisierung. Sie ermöglicht die visuelle Erstellung von Automatisierungen durch Verbinden verschiedener Nodes.

n8n-Kernfunktionen

• 400+ vorgefertigte Integrationen (Slack, Google, Airtable, etc.)
• Selbst-gehostet oder Cloud: Volle Kontrolle über Ihre Daten
• Fair-Code-Lizenz: Kostenlos für Einzelnutzer
• KI-Nodes: Native Integration von LLMs in Workflows

n8n als MCP-Server: Instanz-Level MCP-Zugang

n8n bietet seit Januar 2026 einen eingebauten MCP-Server, der KI-Clients wie Claude Code oder Claude Desktop direkten Zugriff auf Ihre Workflows ermöglicht.

Was der n8n-MCP-Server kann:

• Workflows durchsuchen, die für MCP aktiviert sind
• Metadaten und Trigger-Informationen abrufen
• Workflows ausführen und Ergebnisse empfangen

Unterschied: Instanz-Level MCP vs. MCP Server Trigger Node

Was ist Claude Code?

Claude Code (Version 2.1, Januar 2026) ist Anthropics CLI-Tool für KI-gestützte Softwareentwicklung. Es basiert auf Claude Opus 4.5 und bietet erweiterte Funktionen für die Automatisierung.

Claude Code 2.1 Features

Warum Claude Code für n8n?

Claude Code eignet sich besonders für n8n-Integration weil:

• Agentic Workflows: Selbständige Ausführung komplexer Aufgaben
• Tool-Nutzung: Direkte Interaktion mit externen APIs
• Persistente Sessions: Kontext bleibt über mehrere Interaktionen erhalten
• Validierung: Automatische Prüfung erstellter Workflows

n8n MCP-Zugang aktivieren (Built-in Server)

Schritt 1: MCP in n8n aktivieren

1. Navigieren Sie zu Settings > Instance-level MCP
2. Aktivieren Sie Enable MCP access (erfordert Admin-Rechte)

Nach der Aktivierung sehen Sie:

• Liste der für MCP freigegebenen Workflows
• Liste verbundener OAuth-Clients
• Hauptschalter für MCP-Zugang
• Button für Verbindungsdetails

Schritt 2: Authentifizierung einrichten

n8n bietet zwei Authentifizierungsmethoden:

Option A: OAuth2 (Empfohlen für Cloud)

1. Kopieren Sie Ihre Instance Server URL aus dem OAuth-Tab
2. Konfigurieren Sie Ihren MCP-Client mit dieser URL
3. Bei Verbindung werden Sie zu n8n weitergeleitet zur Autorisierung

OAuth-Clients verwalten:

• Navigieren Sie zu Settings > Instance-level MCP > Connected clients
• Widerrufen Sie Zugriff über das Aktionsmenü bei jedem Client

Option B: Access Token (Empfohlen für CLI)

1. Öffnen Sie Connection details > Access Token Tab
2. Kopieren Sie Ihren persönlichen MCP Access Token
3. Nutzen Sie Token und Server-URL für die Client-Konfiguration

Wichtig: Kopieren Sie den Token sofort – bei späteren Besuchen wird nur ein maskierter Wert angezeigt!

Token rotieren:

1. Navigieren Sie zu Settings > Instance-level MCP
2. Öffnen Sie Connection details > Access Token Tab
3. Klicken Sie auf Generate new token

Der alte Token wird sofort ungültig. Aktualisieren Sie alle verbundenen Clients!

Claude Code mit n8n MCP verbinden

Der n8n-MCP-Server ist auf GitHub verfügbar: github.com/czlonkowski/n8n-mcp

Methode 1: CLI-Befehl (Schnellste Option)

claude mcp add --transport http n8n-mcp https://ihre-n8n-domain.com/mcp-server/http \
  --header "Authorization: Bearer IHR_N8N_MCP_TOKEN"

Ersetzen Sie:

• ihre-n8n-domain.com – Ihre n8n-Instanz URL
• IHR_N8N_MCP_TOKEN – Ihr generierter MCP Access Token

Methode 2: Konfigurationsdatei

Fügen Sie in Ihrer claude.json hinzu:

{
    "mcpServers": {
        "n8n-local": {
            "type": "http",
            "url": "https://ihre-n8n-domain.com/mcp-server/http",
            "headers": {
                "Authorization": "Bearer IHR_N8N_MCP_TOKEN"
            }
        }
    }
}

Methode 3: Docker Setup

Für isolierte Ausführung:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_MODE=stdio",
        "-e", "LOG_LEVEL=error",
        "-e", "N8N_API_URL=http://host.docker.internal:5678",
        "-e", "N8N_API_KEY=IHR_API_KEY",
        "ghcr.io/czlonkowski/n8n-mcp:latest"
      ]
    }
  }
}

Setup verifizieren

# Liste aller MCP-Server
claude mcp list

# Details zum n8n-Server
claude mcp get n8n-mcp

# In Claude Code: verfügbare Tools anzeigen
/mcp

Claude Desktop mit n8n verbinden

Mit OAuth2

1. Öffnen Sie Settings > Connectors in Claude Desktop
2. Klicken Sie auf Add custom connector
3. Geben Sie ein:
   • Name: n8n MCP
   • Remote MCP Server URL: Ihre n8n Base-URL
4. Speichern und autorisieren Sie den Zugriff

Mit Access Token

Fügen Sie in claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://ihre-n8n-domain.com/mcp-server/http",
        "--header",
        "authorization:Bearer IHR_N8N_MCP_TOKEN"
      ]
    }
  }
}

Voraussetzung: Aktuelle Node.js-Version installiert.

Weitere MCP-Clients verbinden

OpenAI Codex CLI

Fügen Sie in ~/.codex/config.toml hinzu:

[mcp_servers.n8n_mcp]
command = "npx"
args = [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://ihre-n8n-domain.com/mcp-server/http",
    "--header",
    "authorization:Bearer IHR_N8N_MCP_TOKEN"
]

Google ADK Agent

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://ihre-n8n-domain.com"
N8N_MCP_TOKEN = "IHR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={
                    "Authorization": f"Bearer {N8N_MCP_TOKEN}",
                },
            ),
        )
    ],
)

Workflows für MCP freigeben

Workflow-Voraussetzungen

Ein Workflow kann nur für MCP aktiviert werden, wenn er:

1. Veröffentlicht ist
2. Einen dieser Trigger-Nodes enthält:
   • Webhook
   • Schedule
   • Chat
   • Form

Unveröffentlichte Workflows oder Workflows ohne unterstützten Trigger erscheinen nicht in der MCP-Liste.

Workflows aktivieren

Option 1: Über MCP-Einstellungen

1. Klicken Sie auf Enable workflows
2. Suchen Sie den gewünschten Workflow
3. Klicken Sie auf Enable

Option 2: Im Workflow-Editor

1. Öffnen Sie den Workflow
2. Klicken Sie auf ... (Menü) > Settings
3. Aktivieren Sie Available in MCP

Option 3: Aus der Workflow-Liste

1. Öffnen Sie das Menü einer Workflow-Karte
2. Wählen Sie Enable MCP access

Workflow-Beschreibungen

Hilfreiche Beschreibungen erleichtern KI-Clients die Identifikation:

1. Navigieren Sie zu Settings > Instance-level MCP
2. Klicken Sie auf die Beschreibung oder Edit description
3. Beschreiben Sie, was der Workflow tut und welche Inputs erwartet werden

Verfügbare MCP-Tools

Der n8n-MCP-Server stellt 20+ Tools bereit:

Core Tools (7 Tools – immer verfügbar)

Workflow-Management (6 Tools – erfordert API-Key)

Execution-Management (4 Tools – erfordert API-Key)

System-Tools (3 Tools – erfordert API-Key)

Praktische Anwendungsbeispiele

Beispiel 1: Lead-Nurturing-Workflow erstellen

Prompt an Claude Code:

Erstelle einen n8n-Workflow der:
1. Neue Leads von einem Webhook empfängt
2. Die E-Mail-Adresse mit Hunter.io validiert
3. Bei gültiger E-Mail eine personalisierte Nachricht mit Claude generiert
4. Die Nachricht über Instantly.ai versendet
5. Den Lead-Status in Airtable aktualisiert

Claude Code wird:

1. Die benötigten Nodes identifizieren
2. Den Workflow-JSON generieren
3. Alle Verbindungen validieren
4. Den Workflow in Ihrer n8n-Instanz erstellen
5. Optional aktivieren

Beispiel 2: Content-Pipeline automatisieren

Prompt:

Baue einen Workflow für Content-Repurposing:
- Trigger: Neuer YouTube-Video-Upload
- Extrahiere Transkript mit Assembly AI
- Generiere Blog-Post mit Claude
- Erstelle Social-Media-Snippets für LinkedIn und X
- Plane Posts mit Buffer

Beispiel 3: Monitoring und Alerting

Prompt:

Erstelle einen Monitoring-Workflow:
- Prüfe alle 5 Minuten den Status unserer APIs
- Bei Fehlern: Sende Slack-Nachricht an #ops
- Logge alle Checks in Google Sheets
- Erstelle wöchentlichen Uptime-Report

Best Practices für n8n + Claude Code

1. Strukturierte Prompts verwenden

AUFGABE: [Was soll automatisiert werden]
TRIGGER: [Was startet den Workflow]
SCHRITTE: [Nummerierte Liste der Aktionen]
OUTPUT: [Erwartetes Ergebnis]
FEHLERBEHANDLUNG: [Was bei Fehlern passieren soll]

2. Validierung vor Deployment

Claude Code validiert Workflows automatisch, aber Sie sollten zusätzlich:

• Expressions auf Syntax prüfen lassen
• Verbindungen zwischen Nodes verifizieren
• Test-Ausführung mit Beispieldaten durchführen

3. Iteratives Arbeiten

Starten Sie mit einem einfachen Workflow und erweitern Sie schrittweise:

Erste Iteration: Webhook → Slack-Nachricht
Zweite Iteration: + Datenvalidierung
Dritte Iteration: + Fehlerbehandlung
Vierte Iteration: + Logging und Monitoring

4. Workflow-Diff-Operations nutzen

Für kleinere Änderungen nutzen Sie n8n_update_partial_workflow statt kompletter Updates – das spart Tokens und reduziert Fehler.

Troubleshooting

Problem: MCP-Server nicht erreichbar

# Status prüfen
claude mcp list

# Server neu hinzufügen
claude mcp remove n8n-mcp
claude mcp add n8n-mcp [options]

Problem: API-Verbindung fehlgeschlagen

Prüfen Sie:

1. API-URL korrekt? Keine trailing slashes
2. API-Key gültig? In n8n: Settings → API → Create API Key
3. Firewall/Netzwerk? n8n muss von Ihrem System erreichbar sein
4. Instanz öffentlich erreichbar? Für Cloud-basierte MCP-Clients erforderlich

Problem: Workflow-Erstellung schlägt fehl

Häufige Ursachen:

• Fehlende Credentials in n8n
• Ungültige Node-Konfiguration
• Syntax-Fehler in Expressions

Lösung: Nutzen Sie die Validierungstools vor dem Deployment:

validate_workflow_json → validate_workflow_connections → n8n_create_workflow

Problem: Workflow-Timeout

n8n erzwingt ein 5-Minuten-Timeout für MCP-getriggerte Workflows. Längere Workflows:

• In Sub-Workflows aufteilen
• Asynchrone Verarbeitung mit Queue
• Webhook-basiertes Callback-Pattern nutzen

Problem: Binärdaten nicht unterstützt

MCP-Clients können nur textbasierte Inputs liefern. Für Binärdaten:

• Base64-Encoding verwenden
• URL zu externem Speicher übergeben
• Separaten Upload-Workflow erstellen

Zukunft: MCP als Standard für KI-Automatisierung

Die Kombination von n8n und Claude Code über MCP ist erst der Anfang. Wir sehen bereits:

• Multi-Agent-Systeme: Mehrere KI-Agenten, die gemeinsam Workflows orchestrieren
• Selbst-heilende Workflows: KI erkennt Fehler und behebt sie automatisch
• Natürliche Sprache als Interface: Workflows werden durch Konversation erstellt und angepasst

n8n hat MCP nicht nur adoptiert – es wird zu einer Kernkomponente der KI-Automatisierungs-Infrastruktur.

---

Ressourcen

• n8n-MCP GitHub Repository: github.com/czlonkowski/n8n-mcp
• n8n Offizielle Dokumentation: docs.n8n.io
• Claude Code Dokumentation: docs.anthropic.com/claude-code
• MCP-Spezifikation: modelcontextprotocol.io

---

Definition of Done ✅

Ihre n8n + Claude Code Integration ist komplett wenn:

• Claude Code ist installiert (Version 2.1+)
• n8n-MCP-Zugang ist aktiviert (Settings > Instance-level MCP)
• Authentifizierung ist konfiguriert (OAuth2 oder Access Token)
• Claude Code ist mit n8n verbunden (claude mcp list)
• Mindestens ein Workflow ist für MCP freigegeben
• Test-Ausführung war erfolgreich

Frequently Asked Questions (FAQ)

Was ist der Unterschied zwischen n8n als MCP-Server und MCP-Client?

Als MCP-Server stellt n8n Ihre Workflows als Tools bereit, die von KI-Agenten wie Claude aufgerufen werden können.

Als MCP-Client kann n8n selbst externe MCP-Tools in Workflows einbinden. Für die Integration mit Claude Code benötigen Sie den eingebauten n8n-MCP-Server oder einen separaten MCP-Server wie n8n-mcp, der als Bridge zwischen Claude Code und Ihrer n8n-Instanz fungiert.

Benötige ich einen API-Key für die Basis-Funktionen?

Nein. Ohne API-Key haben Sie Zugriff auf die 7 Core Tools: Dokumentation, Node-Suche und Validierung.

Für das tatsächliche Erstellen, Aktualisieren und Ausführen von Workflows benötigen Sie jedoch einen n8n API-Key oder MCP Access Token.

Funktioniert n8n-MCP auch mit Claude Desktop statt Claude Code?

Ja. Der n8n-MCP-Server unterstützt sowohl Claude Code als auch Claude Desktop.

Die Konfiguration erfolgt über die claude_desktop_config.json statt über CLI-Befehle. Die verfügbaren Tools und Funktionen sind identisch.

Wie sicher ist die MCP-Verbindung zu meiner n8n-Instanz?

Die Sicherheit hängt von Ihrer Konfiguration ab: Der Access Token sollte niemals in öffentlichen Repositories gespeichert werden.

Nutzen Sie Umgebungsvariablen und beschränken Sie API-Zugriffe auf notwendige Operationen. Bei selbst-gehosteten n8n-Instanzen empfehlen wir HTTPS und IP-Whitelisting.

Kann ich bestehende n8n-Workflows mit Claude Code modifizieren?

Absolut. Mit n8n_get_workflow rufen Sie den aktuellen Stand ab, beschreiben die gewünschten Änderungen, und Claude Code nutzt n8n_update_workflow oder n8n_update_partial_workflow für die Modifikation.

Die Diff-Operation ist besonders effizient für kleine Änderungen.

Fazit

Die Integration von n8n und Claude Code über MCP transformiert die Art, wie wir Automatisierungen erstellen. Statt stundenlanger manueller Konfiguration beschreiben Sie einfach Ihre Anforderungen – und die KI erledigt den Rest.

Bereit für den nächsten Schritt? Kontaktieren Sie uns per E-Mail für eine individuelle Beratung zur KI-Automatisierung in Ihrem Unternehmen.

---

Dieser Artikel wurde zuletzt am 12. Januar 2026 aktualisiert und spiegelt den aktuellen Stand von Claude Code 2.1, MCP 1.0 und n8n wider.