> 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/en/connections-and-integrations/mcp-server-mit-n8n.md).

# MCP Server with n8n

## How do I set up an MCP server with n8n?

n8n is a workflow automation platform that lets you build an MCP server without deep programming knowledge. Each tool call from your AI agent is represented as its own n8n workflow.

{% hint style="info" %}
**Prerequisite:** You need a running n8n instance (self-hosted or n8n Cloud) as well as basic familiarity with the n8n interface.
{% endhint %}

***

### Step 1: Create MCP server workflow

1. Open your n8n instance and create a new workflow.
2. Select the **MCP Server Trigger**.
3. n8n automatically generates a webhook URL for your MCP server — make a note of it, you will need it later in sipgate.

***

### Step 2: Define tools as workflows

Each tool your AI agent should use is created as a separate workflow:

1. Create a new workflow for each tool.
2. Also use the **MCP Server Trigger** as the entry point.
3. Build the desired logic behind it: database queries, API calls, calculations.
4. At the end of the workflow, return a structured result that the AI agent can use.

{% hint style="info" %}
**Tip:** Keep each workflow focused on a single, clearly defined task. Simple, deterministically operating workflows are more reliable than complex branches.
{% endhint %}

***

### Step 3: Store tool descriptions in n8n

So that the AI agent knows when to use which tool, you need to store descriptions in n8n:

* **Tool name:** Choose a unique, descriptive name — maximum **28 characters**.
* **Tool description:** Explain in 1–2 sentences what the tool does and when it should be used.
* **Parameter descriptions:** Describe each parameter: what is expected, in which format, and whether it is optional.

**Example of a good tool description:**

> "Returns the full name and customer number of a customer. Input: telephone number in the format +49…"

***

### Step 4: Store MCP server in sipgate

1. Copy the webhook URL of your n8n MCP workflow.
2. Open your AI agent in app.sipgate.com → **Integrations → Live call functions → Add**.
3. Enter the URL and save.
4. sipgate checks the connection and shows you the detected tools.

***

### Test MCP server

Before using the AI agent in production, we recommend the following tests:

* **Check connection status:** Open the Live Call Functions overview in sipgate and refresh the connection to the MCP server. If all tools are loaded, the connection was successful.
* **Manual test calls:** Trigger the playbook manually and check in n8n whether the workflows are called correctly and the responses are correct.
* **Check server logs:** Look in the n8n execution logs to see whether requests are coming in and whether errors have occurred.
* **Error handling:** Make sure your workflow returns a comprehensible error message in the event of an error — the AI agent uses this to adapt its behavior.

{% hint style="info" %}
**Tip:** Structure your error messages so that the AI agent can infer what went wrong and whether it should try again.
{% endhint %}

***

### Best practices

* Use n8n for **deterministic tasks**: retrieve data, write, calculate.
* Leave the **non-deterministic decisions**: what it does, in what order, how it responds.
* Validate all incoming parameters server-side — the AI agent does not always pass exactly what you expect.
* Return clean, structured responses. Unclear returns lead to unreliable agent behavior.


---

# 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.de/ai-agents/en/connections-and-integrations/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.