跳到主要内容

访问 n8n MCP 服务器#

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

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

  • 在标记为在 MCP 中可用的工作流中进行搜索
  • 检索工作流的元数据和 Webhook 信息
  • 使用 Webhook 端点触发并运行工作流

启用 MCP 访问#​

对于云实例和自托管实例#​

  1. 导航至 设置 > MCP 访问
  2. 切换 启用 MCP 访问（需要实例所有者或管理员权限）。

enable-mcp-access.png

启用后，您将看到：

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

要禁用： 将开关切换为关闭状态。

对于自托管：完全禁用#​

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

N8N_DISABLED_MODULES=mcp

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

设置 MCP 身份验证#​

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

  • oAuth2
  • 访问令牌

使用 oAuth2#​

从 oAuth 选项卡复制您的实例服务器 URL，并使用它来配置您的 MCP 客户端。 连接后，客户端将重定向您到 n8n 以授权访问。

撤销客户端访问权限#​

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

  1. 导航至 设置 > MCP 访问。
  2. 确保您在 如何连接 部分的 oAuth 选项卡上。
  3. 您应该在 已连接的 oAuth 客户端 部分看到一个已连接客户端的表格。
  4. 使用操作菜单撤销特定客户端的访问权限。

使用访问令牌#​

使用您的实例服务器 URL 以及来自设置页面 访问令牌 选项卡下的您的个人 MCP 访问令牌。

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

信息

请立即复制您的令牌。在以后的访问中，您将只看到一个脱敏的值，并且复制按钮将被禁用。

轮换您的令牌#​

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

  1. 导航至 设置 > MCP 访问。

  2. 确保您在 如何连接 部分的 访问令牌 选项卡上。

  3. 生成一个新令牌。

    生成新令牌后，之前的令牌会立即被撤销。

  4. 使用新值更新所有已连接的 MCP 客户端。

使用配置文件连接 MCP 客户端#​

JSON 配置#​

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

{
  "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 访问 页面）
  • <YOUR_N8N_MCP_TOKEN>：您生成的令牌

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 访问页面）
  • <YOUR_N8N_MCP_TOKEN>：您生成的令牌

向 MCP 客户端开放工作流#​

工作流适用条件#​

仅处于激活状态的 Webhook 触发型工作流可向 MCP 客户端开放。

默认情况下，MCP 客户端不可见任何工作流。您需要显式启用访问权限。

启用访问权限#​

选项 1：通过工作流编辑器

  1. 打开工作流
  2. 进入设置
  3. 切换在 MCP 中可用选项

选项 2：通过工作流列表

  1. 进入工作流
  2. 点击工作流卡片上的菜单按钮
  3. 选择启用 MCP 访问

管理访问权限#​

MCP 访问设置页面将显示所有对 MCP 客户端可用的工作流。通过此列表您可以：

  • 直接打开工作流
  • 通过操作菜单撤销访问权限（或使用工作流卡片菜单中的禁用 MCP 访问）

工作流描述#​

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

  1. 打开工作流

  2. 点击工作流名称旁的铅笔图标

  3. 在描述字段中输入说明内容

    mcp-access-workflow-descriptions.png

示例：将 Lovable 连接至 n8n MCP 服务器#​

  1. 在 Lovable 中配置 MCP 服务器（oAuth）
    • 进入设置 > 集成
    • 添加新的 MCP 服务器连接（自定义）：
      • 输入您期望的连接器名称
      • 输入服务器 URL（从 n8n 实例设置中复制）
    • 保存连接。成功后，您将被重定向至 n8n 以授权 Lovable
  2. 验证连通性
    • 连接成功后，Lovable 可查询已启用 MCP 访问的工作流
    • 示例：要求 Lovable 构建一个列出用户并支持删除操作的工作流界面

提示

Lovable 即将推出原生 n8n 连接器。您可直接使用服务器 URL 进行连接。

故障排除#​

若遇到 MCP 客户端连接 n8n 实例的问题，请检查以下事项：

  • 若使用基于云的 MCP 客户端，请确保 n8n 实例可公开访问
  • 确认 n8n 设置中已启用 MCP 访问功能
  • 检查目标工作流已标记为在 MCP 中可用
  • 验证 MCP 客户端中的认证方式（oAuth2 或访问令牌）配置正确
  • 查看 n8n 服务器日志中与 MCP 连接相关的错误信息
  • 若使用桌面版 MCP 客户端，请确保已安装最新版 Node.js