Bonus – n8n mit deinem Coding-Agent · Zertifizierte:r KI-Expert:in Produktmanagement (Teil 2)

Bonus, nichts für den Workshop selbst. Du hast schon einen Coding-Agenten wie Claude Code oder Codex? Dann kannst du ihm n8n-mcp geben. Er kennt danach alle n8n-Nodes und kann Workflows für dich bauen, prüfen und verbessern. Mach das gern zu Hause, nach dem Workshop.

Im Workshop-Trial nicht möglich. Die Trial-Instanzen haben keinen API-Zugang. Für die Anbindung an eine echte Instanz brauchst du einen n8n-Account mit API-Key (Settings → n8n API). Ohne API-Key kann der Agent aber trotzdem die Node-Dokumentation nutzen.

Was ist n8n-mcp?

Ein MCP-Server (Open Source, github.com/czlonkowski/n8n-mcp). Er gibt deinem Agenten zwei Fähigkeiten:

Wissen: Dokumentation und Eigenschaften der n8n-Nodes sowie Vorlagen. Der Agent muss Nodes nicht raten.
Handeln (nur mit API-Key): Workflows in deiner n8n-Instanz anlegen, ändern, prüfen und testen.

Voraussetzungen

Ein Coding-Agent mit MCP-Unterstützung (Claude Code, Codex, Cursor …).
Node.js (für npx).
Optional: die Adresse deiner n8n-Instanz (N8N_API_URL) und ein API-Key (N8N_API_KEY).

Anbinden

Claude Code

Diesen Befehl gibst du einmalig in einem normalen Terminal ein, nicht im Chat mit Claude.

claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e LOG_LEVEL=error \
  -e DISABLE_CONSOLE_OUTPUT=true \
  -e N8N_API_URL=https://DEINE-INSTANZ.app.n8n.cloud \
  -e N8N_API_KEY=DEIN_API_KEY \
  -- npx n8n-mcp

Codex

In ~/.codex/config.toml:

[mcp_servers.n8n-mcp]
command = "npx"
args = ["n8n-mcp"]

[mcp_servers.n8n-mcp.env]
MCP_MODE = "stdio"
LOG_LEVEL = "error"
DISABLE_CONSOLE_OUTPUT = "true"
N8N_API_URL = "https://DEINE-INSTANZ.app.n8n.cloud"
N8N_API_KEY = "DEIN_API_KEY"

Claude Desktop

Kein Terminal nötig. Öffne in Claude Desktop Einstellungen → Entwickler → Konfiguration bearbeiten. Dort liegt die Datei claude_desktop_config.json (Mac: ~/Library/Application Support/Claude/). Trage ein und starte Claude Desktop neu:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://DEINE-INSTANZ.app.n8n.cloud",
        "N8N_API_KEY": "DEIN_API_KEY"
      }
    }
  }
}

Wohin mit dem API-Key? Nie in den Chat schreiben. Die Befehle und Dateien oben tippst du in dein Terminal oder deinen Editor, nicht in ein Chatfenster. Der Key steht dann nur in der lokalen Konfigurationsdatei, und das Programm gibt ihn an n8n-mcp weiter. Das Modell bekommt ihn nicht zu sehen.

Andere Agenten

Das Muster ist immer gleich: Befehl npx n8n-mcp mit diesen Umgebungsvariablen. Die genaue Schreibweise für deinen Agenten steht in der README des Projekts.

Ohne Zugriff auf eine Instanz lässt du N8N_API_URL und N8N_API_KEY weg. Dann bekommst du nur den Dokumentationsteil.

Teste die Anbindung: Starte den Agenten neu und frage: „Welche n8n-Tools hast du?“ Er sollte Tools wie search_nodes und get_node nennen.

Optional: n8n-skills

Zu n8n-mcp gibt es vom selben Autor n8n-skills (github.com/czlonkowski/n8n-skills). Der Unterschied:

n8n-mcp gibt dem Agenten Werkzeuge: Nodes suchen, Konfiguration prüfen, Workflows anlegen und ändern.
n8n-skills gibt ihm das Wissen, wie man diese Werkzeuge richtig einsetzt. Es sind 7 kleine Anleitungen, unter anderem zu Ausdrücken ({{ }}), Code-Nodes in JavaScript und Python, Workflow-Mustern und dem Beheben von Validierungsfehlern.

Die Skills laden sich von selbst, wenn dein Auftrag passt. Du musst sie nicht aufrufen. Sie helfen vor allem, wenn der Agent Workflows baut oder repariert. Ohne Skills läuft er eher in Fehlerschleifen.

Installation in Claude Code (in einer Claude-Code-Sitzung, nicht im Terminal):

/plugin marketplace add czlonkowski/n8n-skills

Danach /plugin install eingeben und n8n-mcp-skills auswählen.

Nur mit Skill-Unterstützung. Skills gibt es in Claude Code und in Claude.ai (Skill-Ordner als ZIP hochladen unter Einstellungen → Funktionen → Skills). Ein reiner MCP-Zugang in anderen Programmen nutzt sie nicht. Für den Workshop brauchst du sie nicht, dort baust du von Hand.

Nicht verwechseln: der offizielle n8n-MCP

n8n hat selbst einen MCP-Server eingebaut („Instance-level MCP“, Doku). Er heißt fast gleich wie n8n-mcp, ist aber ein anderes Projekt:

n8n-mcp (Community): läuft bei dir lokal, kennt die Dokumentation aller Nodes und greift über einen API-Key auf deine Instanz zu. Stärke: Der Agent kennt die Nodes und baut daraus Workflows.
Offizieller MCP-Zugang von n8n: ist Teil deiner Instanz. Du schaltest ihn in Settings → Instance-level MCP ein und gibst einzelne Workflows mit „Available in MCP“ frei. Dein Agent kann sie dann suchen, testen und ausführen, laut Doku (ab n8n 2.13.0) auch Workflows und Data Tables erstellen und bearbeiten. Die Anmeldung läuft per OAuth oder Token.

Wofür der offizielle Zugang praktisch ist: Du gibst zum Beispiel Peter und sein Team frei und startest sie aus Claude heraus, statt im n8n-Chat. Beide Wege lassen sich auch kombinieren.

Wichtig zu wissen: Alle verbundenen Programme sehen alle freigegebenen Workflows. Schalte deshalb nur frei, was dein Agent wirklich nutzen soll. Die Adresse ist https://DEINE-INSTANZ/mcp-server/http, nicht die Adresse aus deiner Browserzeile. Die Doku empfiehlt zum Bauen von Workflows Coding-Agenten wie Claude Code. Ob der Zugang in deinem Plan oder im Trial verfügbar ist, nennt die Doku nicht. Schau in Settings nach, ob der Punkt vorhanden ist. Auch n8n bietet eigene Skills an: github.com/n8n-io/skills.

Erste Aufträge

Baue in n8n einen Workflow „Benchmark Ben“: Chat-Trigger, AI Agent mit Websuche
und Memory, Ergebnis in eine Data Table. Prüfe den Workflow, bevor du ihn anlegst.

Schau dir meinen Workflow „News Nina“ an. Was könnte schiefgehen,
und wie würdest du den Prompt verbessern?

Sicher arbeiten

Der API-Key gibt Vollzugriff. Gib ihn nie in Chats, Screenshots oder Git-Repos weiter.
Nicht an produktiven Workflows üben. Nutze eine Test-Instanz oder lass den Agenten mit Kopien arbeiten. Der Agent kann Workflows ändern und löschen.
Prüfe das Ergebnis selbst. Öffne den Workflow in n8n und lies ihn, bevor du ihn veröffentlichst.
Credentials (Zugangsdaten zu Diensten) trägst du am besten selbst in n8n ein.

Weiterlernen

Kurs-Empfehlung: course.aiadvisors.pl
Eine gute Anleitung, um zu Hause weiterzumachen. 14 Tage Kurs inkl. gratis n8n-Übungsinstanz vom Autor des n8n-mcp und n8n-skills. Nach den 14 Tagen wird deine Übungsinstanz automatisch gelöscht.