0%

n8n集成MCP服务

将 n8n 与 MCP (Model Context Protocol) 结合,是目前 AI 自动化领域非常前沿且强大的玩法。n8n 可以同时作为 MCP 客户端(Client)MCP 服务器(Server),和外部 MCP 生态双向集成。

一、作为 MCP 客户端:在 AI Agent 里调用外部 MCP Server

使用 MCP Client Tool 节点 来把外部 MCP server 暴露的工具接入到 n8n 的 AI Agent。[MCP Client Tool]

  1. 在 AI Agent 中添加 MCP Client Tool 工具节点。
  2. 配置:
    • Endpoint:填入外部 MCP server 的 url地址。
    • Authentication:如果对方需要鉴权,可选:
      • Bearer Token
      • 自定义 Header(基于 HTTP Request 凭据)[MCP Client Tool]
  3. Tools to Include:控制要暴露给 Agent 的工具:

示例:连接 Smithery 的 MCP server 时,官方做法是用 HTTP Streamable 类型的凭据配置带 key 的 URL,然后在 MCP Client Tool 中引用该凭据作为 SSE 端点即可。[Smithery 论坛贴]

二、作为 MCP 服务器:把 n8n 工具 / 工作流暴露给外部 MCP 客户端

1. 使用 MCP Server Trigger 节点(工作流级 Server)

在具体工作流中用 MCP Server Trigger 节点,把该工作流里的工具节点暴露给 MCP 客户端。[MCP Server Trigger; Release 1.88.0]

  • 节点会生成 MCP URL(Test / Production 两个),客户端通过这个 URL 连接(SSE 或 streamable HTTP)。[MCP Server Trigger]
  • 只会执行连接在它后面的 Tool 节点(比如 Workflow Tool、HTTP Request Tool 等)。[MCP Server Trigger]
  • 可以给 MCP URL 配置 Bearer / Header 鉴权。[MCP Server Trigger]

文档中提供了如何在 Claude Desktop 里通过 mcp-remote 连接该触发器的 JSON 配置示例。[MCP Server Trigger templates]

2. 实例级 MCP Server(统一访问工作流)

n8n 还有一个内置 MCP Server,面向整个平台暴露工作流给支持 MCP 的客户端(如 Lovable)。[Accessing n8n MCP server]

步骤:

  1. 启用 MCP 功能

  2. 标记可被 MCP 访问的工作流

  3. 配置认证方式

    • Settings > MCP Access 里选择:
  4. 在 MCP 客户端中配置

    • 对于通过配置文件的客户端,文档给出示例(基于 npx supergateway 转换为 streamable HTTP):[Accessing n8n MCP server]

      JSON 示例(片段):

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      {
      "mcpServers": {
      "n8n-mcp": {
      "command": "npx",
      "args": [
      "-y",
      "supergateway",
      "--streamableHttp",
      "https://<your-n8n-domain>/mcp-server/http",
      "--header",
      "authorization:Bearer <YOUR_N8N_MCP_TOKEN>"
      ]
      }
      }
      }
  5. 典型场景:将 Lovable 连接到 n8n

    • 在 Lovable 里添加自定义 MCP server,填 n8n 的 server URL,用 OAuth 流程授权;之后 Lovable 就能查询已开启 MCP 的工作流并通过其 webhook 触发执行。[Lovable 示例]

三、与第三方 MCP(如 GA4、Smithery、VAPI AI)集成时的注意点

  • 只要第三方提供已经部署好的 MCP server(带 SSE / streamable HTTP 端点),就能通过 MCP Client Tool 直接连,不需要你自己再搭 server。[AI agent frameworks blog; GA4 论坛贴]
  • 有些项目(如 Google Analytics MCP)目前只提供源码,需要你自己部署 MCP server,n8n 才能作为 client 连接。[GA4 论坛贴]
  • 像 VAPI AI 这类平台,可以把 n8n 的 MCP Server Trigger 暴露出来,它们作为客户端调用;实战经验是要保证:
    • n8n 更新到最新版本
    • Webhook/MCP URL 使用正确的 HTTP 方法(如 POST)与响应格式
    • 在对方平台中设置合适的超时时间(例如 30 秒)[VAPI 论坛贴]