> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/ai-agents/anbindungen-and-integrationen/mcp-server-mit-n8n.md). # 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. {% hint style="info" %} **Voraussetzung:** Eine laufende n8n-Instanz, selbst gehostet oder n8n Cloud, sowie grundlegende Kenntnisse der n8n-Oberfläche. Die Anbindung eigener Tools steht ab dem Tarif Scale zur Verfügung. Mehr dazu unter [Tarife & Kosten](/ai-agents/tarife-and-kosten/sipgate-sona-tarife-and-kosten.md). {% endhint %} Wenn Sie monday.com oder commercetools anbinden möchten, brauchen Sie mit sigpate sona keinen eigenen MCP-Server. Dafür gibt es [fertige Playbooks](/ai-agents/verhalten/playbooks.md#playbooks-aus-der-bibliothek) aus der Bibliothek. *** ### Schritt 1: MCP-Server-Workflow anlegen 1. Öffnen Sie Ihre n8n-Instanz und legen Sie einen neuen Workflow an. 2. Wählen Sie als Trigger-Node den **MCP Server Trigger**. 3. n8n generiert automatisch eine Webhook-URL für Ihren MCP-Server – notieren Sie diese, Sie benötigen sie später in sipgate. {% hint style="warning" icon="lightbulb" %} **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. {% endhint %} *** ### 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: 1. Legen Sie pro Tool einen neuen Workflow an. 2. Verwenden Sie ebenfalls den **MCP Server Trigger** als Einstiegspunkt. 3. Bauen Sie die gewünschte Logik dahinter: Datenbankabfragen, API-Calls, Berechnungen. 4. Geben Sie am Ende ein strukturiertes Ergebnis zurück, das Ihr Agent verwenden kann. {% hint style="warning" icon="lightbulb" %} **Tipp:** Halten Sie jeden Workflow auf eine einzelne, klar abgegrenzte Aufgabe fokussiert. Einfache, deterministisch arbeitende Workflows sind zuverlässiger als komplexe Verzweigungen. {% endhint %} *** ### 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 1. Kopieren Sie die Webhook-URL Ihres n8n-MCP-Workflows. 2. Öffnen Sie die Agentenübersicht, klicken Sie auf Ihren Agent und wählen Sie **Tools**. Klicken Sie auf **Tool hinzufügen**. 3. Tragen Sie die URL ein. Haben Sie in n8n ein Token vergeben, geben Sie es im Feld **Token** ein. 4. 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. {% hint style="info" %} **Tipp:** Formulieren Sie Fehlermeldungen so, dass Ihr Agent daraus ableiten kann, was schiefgelaufen ist und ob er es erneut versuchen soll. {% endhint %} *** ### 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.sipgate.de/ai-agents/anbindungen-and-integrationen/mcp-server-mit-n8n.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.