MCP-Server mit n8n
Wie richte ich einen MCP-Server mit n8n ein?
n8n ist eine Workflow-Automatisierungsplattform, mit der Sie ohne tiefe Programmierkenntnisse einen MCP-Server aufbauen. Jeder Tool-Aufruf Ihres Agents wird dabei als eigener n8n-Workflow abgebildet.
Wenn Sie monday.com oder commercetools anbinden möchten, brauchen Sie mit sigpate sona keinen eigenen MCP-Server. Dafür gibt es fertige Playbooks aus der Bibliothek.
Schritt 1: MCP-Server-Workflow anlegen
Öffnen Sie Ihre n8n-Instanz und legen Sie einen neuen Workflow an.
Wählen Sie als Trigger-Node den MCP Server Trigger.
n8n generiert automatisch eine Webhook-URL für Ihren MCP-Server – notieren Sie diese, Sie benötigen sie später in sipgate.
Schritt 2: Tools als Workflows definieren
Ein Tool ist eine einzelne Fähigkeit, die Ihr Agent während des Gesprächs nutzt, etwa eine Kundennummer nachschlagen, eine Verfügbarkeit prüfen oder einen Termin buchen. Jedes Tool entspricht genau einem n8n-Workflow: Ihr Agent entscheidet im Gespräch, wann er ein Tool braucht, und n8n führt die dahinterliegende Logik aus.
Jedes Tool, das Ihr Agent nutzen soll, wird als eigenständiger Workflow angelegt:
Legen Sie pro Tool einen neuen Workflow an.
Verwenden Sie ebenfalls den MCP Server Trigger als Einstiegspunkt.
Bauen Sie die gewünschte Logik dahinter: Datenbankabfragen, API-Calls, Berechnungen.
Geben Sie am Ende ein strukturiertes Ergebnis zurück, das Ihr Agent verwenden kann.
Schritt 3: Tool-Beschreibungen in n8n hinterlegen
Damit Ihr Agent weiß, wann er welches Tool einsetzen soll, müssen Sie in n8n Beschreibungen hinterlegen:
Tool-Name: eindeutig und sprechend, maximal 28 Zeichen
Tool-Beschreibung: ein bis zwei Sätze dazu, was das Tool tut und wann es genutzt werden soll
Parameter-Beschreibungen: was erwartet wird, in welchem Format und ob der Parameter optional ist
Beispiel für eine gute Tool-Beschreibung:
„Gibt den vollständigen Namen und die Kundennummer eines Kunden zurück. Eingabe: Telefonnummer im Format +49…"
Schritt 4: MCP-Server in sipgate hinterlegen
Kopieren Sie die Webhook-URL Ihres n8n-MCP-Workflows.
Öffnen Sie die Agentenübersicht, klicken Sie auf Ihren Agent und wählen Sie Tools. Klicken Sie auf Tool hinzufügen.
Tragen Sie die URL ein. Haben Sie in n8n ein Token vergeben, geben Sie es im Feld Token ein.
Speichern Sie. sipgate prüft die Verbindung und zeigt die erkannten Tools an.
MCP-Server testen
Bevor Sie Ihren Agent produktiv einsetzen, empfehlen wir diese Tests:
Verbindungsstatus prüfen. Öffnen Sie die Tools-Übersicht in sipgate und klicken Sie auf Aktualisieren. Wenn alle Tools geladen werden, steht die Verbindung.
Manuelle Testanrufe. Lösen Sie das Playbook aus und prüfen Sie in n8n, ob die Workflows korrekt aufgerufen werden und die Antworten stimmen.
Server-Logs prüfen. Schauen Sie in den n8n-Ausführungsprotokollen nach, ob Anfragen ankommen und ob Fehler aufgetreten sind.
Fehlerbehandlung. Stellen Sie sicher, dass Ihr Workflow im Fehlerfall eine verständliche Fehlermeldung zurückgibt. Ihr Agent nutzt sie, um sein Verhalten anzupassen.
Best Practices
Verwenden Sie n8n für deterministische Aufgaben: Daten abrufen, schreiben, berechnen.
Überlassen Sie dem AI-Agenten die nichtdeterministischen Entscheidungen: Was er tut, in welcher Reihenfolge, wie er antwortet.
Validieren Sie alle eingehenden Parameter serverseitig. Ihr Agent übergibt nicht immer exakt das, was Sie erwarten.
Liefern Sie saubere, strukturierte Antworten zurück. Unklare Rückgaben führen zu unzuverlässigem Verhalten des Agenten.
Zuletzt aktualisiert