Accessing n8n MCP server 访问 n8n MCP 服务器#

通过 n8n 内置的 MCP 服务器，将支持的 MCP 客户端连接到你的 n8n 工作流。

该服务器允许客户端（如 Lovable）安全地连接到 n8n 实例。连接后，这些客户端可以：

在标记为可在 MCP 中使用的工作流中搜索
检索工作流的 metadata 和 webhook 信息
使用 webhook 端点触发和运行工作流

Enabling MCP access 启用 MCP 访问#

For Cloud and self-hosted instances 云版本和自托管实例#

导航至 Settings 设置 > MCP Access MCP 访问
切换 Enable MCP access 启用 MCP 访问（需要实例所有者或 Admin 权限）。

启用后，你将看到：

连接说明
暴露给 MCP 客户端的工作流列表

要禁用： 关闭开关。

For self-hosted: Complete disablement 自托管：完全禁用#

要完全移除该功能，请设置环境变量：

N8N_DISABLED_MODULES=mcp

这将移除 MCP 端点并隐藏所有相关的 UI 元素。

Setting up MCP authentication 设置 MCP 身份验证#

MCP Access MCP 访问页面上的 How to connect 如何连接部分为 MCP 客户端提供了两种身份验证方法：

oAuth2
Access Token 访问令牌

Using oAuth2 使用 oAuth2#

从 oAuth 标签页复制你的实例服务器 URL，并使用它配置你的 MCP 客户端。连接后，客户端会将你重定向到 n8n 以授权访问。

Revoking client access 撤销客户端访问#

要撤销已连接的 MCP 客户端的访问：

导航至 Settings 设置 > MCP Access MCP 访问。
确保你在 How to connect 如何连接部分的 oAuth 标签页上。
你应该在 Connected oAuth clients 已连接的 oAuth 客户端部分看到已连接客户端的表格。
使用操作菜单撤销特定客户端的访问。

Using Access Token 使用访问令牌#

使用你的实例服务器 URL 和设置页面上 Access Token 访问令牌标签页中的个人 MCP 访问令牌。

当你首次访问 MCP Access page MCP 访问页面时，n8n 会自动生成一个绑定到你用户账户的个人 MCP 访问令牌。

Info

立即复制你的令牌。在以后的访问中，你只会看到脱敏值，复制按钮将被禁用。

Rotating your token 轮换你的令牌#

如果你丢失了令牌或需要轮换它：

导航至 Settings 设置 > MCP Access MCP 访问。
确保你在 How to connect 如何连接部分的 Access Token 访问令牌标签页上。
生成新令牌。

生成时，之前的令牌会立即被撤销。
使用新值更新所有已连接的 MCP 客户端。

Connecting an MCP client using configuration files 使用配置文件连接 MCP 客户端#

JSON configuration JSON 配置#

对于使用 JSON 配置文件的 MCP 客户端，从 MCP Access 页面复制示例配置：

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://<your-n8n-domain>/mcp-server/http",
        "--header",
        "authorization:Bearer <YOUR_N8N_MCP_TOKEN>"
      ]
    }
  }
}

在此处替换：

<your-n8n-domain>：你的 n8n 基础 URL（显示在 MCP Access MCP 访问页面上）
<YOUR_N8N_MCP_TOKEN>：你生成的令牌

TOML configuration TOML 配置#

对于使用 TOML 配置文件的 MCP 客户端（如 Codex CLI），使用以下配置：

[mcp_servers.n8n_mcp]
command = "npx"
args = [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<your-n8n-domain>/mcp-server/http",
    "--header",
    "authorization:Bearer <YOUR_N8N_MCP_TOKEN>"
]

在此处替换： - <your-n8n-domain>：你的 n8n 基础 URL，显示在 MCP Access 页面上 - <YOUR_N8N_MCP_TOKEN>：你生成的令牌

Exposing workflows to MCP clients 向 MCP 客户端暴露工作流#

Workflow eligibility 工作流资格#

只有活动的、由 webhook 触发的工作流才能暴露给 MCP 客户端。

默认情况下，没有工作流对 MCP 客户端可见。你必须显式启用访问。

Enabling access 启用访问#

选项 1：从工作流编辑器

打开工作流。
转到 Settings 设置。
切换 Available in MCP 在 MCP 中可用。

选项 2：从工作流列表

转到 Workflows 工作流。
打开工作流卡片上的菜单。
选择 Enable MCP access 启用 MCP 访问。

Managing access 管理访问#

MCP Access settings page MCP 访问设置页面显示所有对 MCP 客户端可用的工作流。从此列表中，你可以：

直接打开工作流
使用操作菜单撤销访问（或使用工作流卡片菜单中的 Disable MCP access 禁用 MCP 访问）

Workflow descriptions 工作流描述#

为了帮助 MCP 客户端识别工作流，你可以按以下方式添加自由文本描述：

打开工作流。
点击工作流名称旁边的铅笔图标。
在 Description 描述字段中输入你的描述。

Example: Connecting Lovable to n8n MCP server 示例：将 Lovable 连接到 n8n MCP 服务器#

在 Lovable 中配置 MCP 服务器（oAuth）。
- 导航至 Settings 设置 > Integrations 集成。
- 添加新的 MCP 服务器连接（Custom 自定义）：
  - 输入你想要的连接器名称。
  - 输入 Server URL 服务器 URL（从 n8n 实例设置中复制）。
- 保存连接。成功后，你将被重定向到 n8n 以授权 Lovable。
验证连接性。
- 连接后，Lovable 可以查询启用了 MCP 访问的工作流。
- 示例：要求 Lovable 构建一个列出用户并允许删除用户的工作流 UI。

Info

Lovable 即将推出原生 n8n 连接器。你可以使用它直接与你的服务器 URL 连接。

Troubleshooting 故障排除#

如果连接 MCP 客户端到你的 n8n 实例时遇到问题，请考虑以下事项：

如果你使用的是基于云的 MCP 客户端，请确保你的 n8n 实例可公开访问。
验证 n8n 设置中是否启用了 MCP 访问。
检查你想要访问的工作流是否标记为在 MCP 中可用。
确认身份验证方法（oAuth2 或 Access Token）在你的 MCP 客户端中配置正确。
查看 n8n 服务器日志中与 MCP 连接相关的任何错误消息。
如果你使用的是桌面 MCP 客户端，请确保已安装最新版本的 Node.js。