> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/n8n-mcp.md).

# N8N mcp

N8N MCP lets your AI agent use the tools that your n8n instance publishes. You add the MCP server URL and an Authorization header once in Third party apps.

***

### Prerequisites

* A BotPenguin account with access to the More menu.
* An n8n instance with MCP turned on.&#x20;
* Your n8n MCP URL and authentication header from your n8n instance.

***

### Key Definitions

| Term           | Meaning                                                                                 |
| -------------- | --------------------------------------------------------------------------------------- |
| MCP            | Model Context Protocol. A standard way for an AI agent to use the tools of another app. |
| MCP server URL | The address of the MCP server.                                                          |
| Tool           | An action that the app publishes. The app decides which tools exist.                    |
| Connection     | One saved account that your agents can use.                                             |

***

### Steps

1. Click **More** in the left menu, then click Third party apps.

![Click More, then Third party apps](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/6fuQlxboTgCya1aD3q0L/images/n8n-mcp-step-1.png)

2. Type n8n MCP in the search box, then open the **n8n MCP** card.&#x20;

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FexCsjnopIRIB45zTQkQV%2Fimage.png?alt=media&amp;token=db36e952-348c-4ed9-b30b-d8404d3fd159" alt=""><figcaption></figcaption></figure>

3. On the Connected accounts tab, click **Add connection**.
4. In the configuration panel, type a **Connection name**.
5. Enter the **MCP server URL**. This field is required. Copy it from your n8n instance.
6. Under headers, enter the **Header name** Authorization and the **Value** from n8n. Both are required. Click Add header to add another pair.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F0L3F3JPYJ8mWA0PpOOi4%2Fimage.png?alt=media&amp;token=6a99fe9d-907e-4e18-9d7c-470290a5f124" alt=""><figcaption></figcaption></figure>

7. Click **Save Configuration**. BotPenguin tests the connection and saves it only if the server answers.
8. Check the Connected accounts tab. Your n8n MCP configuration appears in the list with an Active status.

***

### Common Errors

<details>

<summary>I do not see Third party apps in the More menu</summary>

Click More in the left menu and look under Connections for Third party apps. If it is still missing, your role may not allow it. Ask your account owner.

</details>

<details>

<summary>Save Configuration is grey</summary>

Fill in every required field. The URL must start with https\://.

</details>

<details>

<summary>BotPenguin says authentication is required</summary>

The token or header is missing or wrong. Copy the key again from n8n and save again.

</details>

<details>

<summary>BotPenguin says the server could not be found</summary>

The URL is wrong or the server is down. Check the URL in n8n and save again.

</details>

<details>

<summary>My agent says the credentials were rejected</summary>

The key was regenerated or deleted in n8n. Add the connection again with the new key.

</details>

<details>

<summary>The tools in my agent changed</summary>

n8n publishes the tools, not BotPenguin. Sync the tools again in your agent and select the ones you need.

</details>

<details>

<summary>Can I connect more than one n8n MCP account?</summary>

Yes. Click Add connection again. Give each one a clear name so you can pick the right one when you build an agent.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
