将 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]
- 在 AI Agent 中添加 MCP Client Tool 工具节点。
- 配置:
- Endpoint:填入外部 MCP server 的 url地址。
- Authentication:如果对方需要鉴权,可选:
- Bearer Token
- 自定义 Header(基于 HTTP Request 凭据)[MCP Client Tool]
- Tools to Include:控制要暴露给 Agent 的工具:
- All / Selected / All Except。[MCP Client Tool]
示例:连接 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]
步骤:
启用 MCP 功能
- 到 Settings > MCP Access,开启 Enable MCP access。[Accessing n8n MCP server]
标记可被 MCP 访问的工作流
- 仅支持:已激活 + Webhook 触发的工作流。[Exposing workflows]
- 在工作流编辑器:Settings → Available in MCP 打开。[Exposing workflows]
配置认证方式
- 在 Settings > MCP Access 里选择:
- OAuth2:客户端用 oAuth server URL 连接,用户在 n8n 授权;支持在页面上撤销客户端访问。[Accessing n8n MCP server]
- Access Token:使用个人 MCP Access Token + server URL。[Accessing n8n MCP server]
- 在 Settings > MCP Access 里选择:
在 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>"
]
}
}
}
典型场景:将 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 论坛贴]