> For the complete documentation index, see [llms.txt](https://help.sipgate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.com/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 können. Jeder Tool-Aufruf Ihres AI-Agenten wird dabei als eigener n8n-Workflow abgebildet.

{% hint style="info" %}
**Voraussetzung:** Sie benötigen eine laufende n8n-Instanz (selbst gehostet oder n8n Cloud) sowie grundlegende Kenntnisse in der n8n-Oberfläche.
{% endhint %}

***

### 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.

***

### Schritt 2: Tools als Workflows definieren

Jedes Tool, das Ihr AI-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 des Workflows ein strukturiertes Ergebnis zurück, das der AI-Agent verwenden kann.

{% hint style="info" %}
**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 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

1. Kopieren Sie die Webhook-URL Ihres n8n-MCP-Workflows.
2. Öffnen Sie in app.sipgate.com Ihren AI-Agenten → **Integrationen → Live-Call-Funktionen → Hinzufügen**.
3. Tragen Sie die URL ein und speichern Sie.
4. 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.

{% hint style="info" %}
**Tipp:** Bauen Sie Ihre Fehlermeldungen so, dass der AI-Agent daraus schließen 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 – 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.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sipgate.com/anbindungen-and-integrationen/mcp-server-mit-n8n.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.