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 können. Jeder Tool-Aufruf Ihres AI-Agenten wird dabei als eigener n8n-Workflow abgebildet.
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.
Tipp: Sichern Sie Ihren MCP-Server-Workflow zusätzlich mit einem Token ab. Aktivieren Sie dazu im MCP Server Trigger die Bearer- oder Header-Authentifizierung und vergeben Sie ein Token. So kann nur sipgate mit Ihrem Server kommunizieren.
Schritt 2: Tools als Workflows definieren
Ein Tool ist eine einzelne Fähigkeit, die Ihr AI-Agent während des Gesprächs nutzen kann, etwa eine Kundennummer nachschlagen, eine Verfügbarkeit prüfen oder einen Termin buchen. Jedes Tool entspricht dabei genau einem n8n-Workflow: Der Agent entscheidet im Gespräch, wann er ein Tool braucht, und n8n führt die dahinterliegende Logik aus.
Jedes Tool, das Ihr AI-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 des Workflows ein strukturiertes Ergebnis zurück, das der AI-Agent verwenden kann.
Schritt 3: Tool-Beschreibungen in n8n hinterlegen
Damit der AI-Agent weiß, wann er welches Tool einsetzen soll, müssen Sie in n8n Beschreibungen hinterlegen:
Tool-Name: Vergeben Sie einen eindeutigen, sprechenden Namen – maximal 28 Zeichen.
Tool-Beschreibung: Erklären Sie in 1–2 Sätzen, was das Tool tut und wann es genutzt werden soll.
Parameter-Beschreibungen: Beschreiben Sie jeden Parameter: was erwartet wird, in welchem Format und ob er 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 in app.sipgate.com Ihren AI-Agenten → Integrationen → Live-Call-Funktionen → Hinzufügen.
Tragen Sie die URL ein. Haben Sie in n8n ein Token vergeben, geben Sie es im Feld Token (optional) ein.
Speichern Sie. sipgate prüft die Verbindung und zeigt Ihnen die erkannten Tools an.
MCP-Server testen
Bevor Sie den AI-Agenten produktiv einsetzen, empfehlen wir folgende Tests:
Verbindungsstatus prüfen: Öffnen Sie in sipgate die Live-Call-Funktionen-Übersicht und aktualisieren Sie die Verbindung zum MCP-server. Wenn alle Tools geladen werden, ist die Verbingund erfolgreich.
Manuelle Testanrufe: Lösen Sie das Playbook manuell 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 – der AI-Agent nutzt diese, 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 – der AI-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