跳到主要内容

MCP 服务器触发节点#

使用 MCP 服务器触发节点可使 n8n 作为模型上下文协议(MCP)服务器运行,从而向 MCP 客户端提供 n8n 工具和工作流。

凭据配置

此节点的认证信息请查阅此处

MCP 服务器触发节点运行机制#

MCP 服务器触发节点作为 MCP 客户端访问 n8n 的入口点,通过暴露可交互的 URL 使客户端能够调用 n8n 工具。

与传统触发节点(响应事件并将输出传递至后续连接节点)不同,MCP 服务器触发节点仅连接并执行工具节点。客户端可枚举可用工具并调用具体工具执行任务。

通过连接自定义 n8n 工作流工具节点,可将 n8n 工作流对客户端开放。

服务器推送事件与流式 HTTP 支持

该节点同时支持基于 HTTP 的长连接传输方式服务器推送事件以及客户端与服务器间的流式 HTTP连接,目前暂不支持标准输入输出传输

节点参数#

通过以下参数配置节点:

MCP 网址#

MCP 服务器触发节点提供测试与生产两种MCP 网址,节点面板顶部会显示当前选中的网址。

通过切换测试网址生产网址选项控制 n8n 显示的网址类型:

  • 测试模式:当选择监听测试事件或执行未激活的工作流时,n8n 将注册测试 MCP 网址。调用该网址时,工作流中会显示数据详情
  • 生产模式:工作流激活后 n8n 将注册生产 MCP 网址。使用生产网址时工作流界面不显示数据,但仍可通过工作流的执行记录选项卡查看具体执行数据

认证方式#

可为 MCP 网址连接设置客户端认证要求,支持以下认证方式:

  • Bearer 令牌认证
  • 请求头认证

各认证类型的详细设置请参阅 HTTP 请求凭据文档。

路径#

此字段默认包含随机生成的 MCP 网址路径,以避免与其他 MCP 服务器触发节点冲突。

支持手动指定 URL 路径(可包含路由参数),例如在使用 n8n 进行 API 原型设计时需要保持端点 URL 一致性的场景。

模板与示例#

构建集成谷歌日历与自定义函数的 MCP 服务器

作者:Solomon
查看模板详情

构建专属 N8N 工作流 MCP 服务器

作者:Jimleuk
查看模板详情

基于 MCP 构建集成谷歌 Gemini、Gmail 与日历的个人助手

作者:Aitor | 1Node
查看模板详情

浏览 MCP 服务器触发节点集成模板搜索全部模板

与 Claude Desktop 集成#

可通过运行网关代理 SSE 消息至基于 stdio 的服务器,实现从 Claude Desktop 连接 MCP 服务器触发节点。

具体操作需在 Claude Desktop 配置中添加以下内容:

{ "mcpServers": { "n8n": { "command": "npx", "args": [ "mcp-remote", "<MCP_URL>", "--header", "Authorization: Bearer ${AUTH_TOKEN}" ], "env": { "AUTH_TOKEN": "<MCP_BEARER_TOKEN>" } } } }

请务必将 <MCP_URL><MCP_BEARER_TOKEN> 占位符替换为您的 MCP 服务器触发器节点参数和凭据中的实际值。

限制#

使用 Webhook 副本配置 MCP 服务器触发器节点#

MCP 服务器触发器节点依赖于服务器发送事件(SSE)或可流式传输的 HTTP,这要求同一服务器实例处理持久连接。根据您的 Webhook 处理器 配置,在 队列模式 下运行 n8n 时可能会引发问题:

  • 若在队列模式下使用 单个 Webhook 副本,MCP 服务器触发器节点可正常工作。
  • 若运行 多个 Webhook 副本,则需将所有 /mcp* 请求路由至单个专用 Webhook 副本。请为 MCP 请求创建仅包含一个 Webhook 容器的独立副本集,随后更新入口或负载均衡器配置,将所有 /mcp* 流量定向至该实例。

多 Webhook 副本运行注意事项

若在多个 Webhook 副本环境下运行 MCP 服务器触发器节点,且未将所有 /mcp* 请求路由至专用 Webhook 副本,您的 SSE 及可流式传输 HTTP 连接将频繁中断或无法可靠传递事件。

相关资源#

n8n 同时提供 MCP 客户端工具 节点,支持将 n8n AI 智能体连接至外部工具。

有关协议、服务器与客户端的详细信息,请参阅 MCP 文档MCP 规范

常见问题#

以下是 MCP 服务器触发器节点的常见错误与问题及其解决步骤。

通过反向代理运行 MCP 服务器触发器节点#

在 nginx 等反向代理后运行 n8n 时,若 MCP 端点未针对 SSE 或可流式传输 HTTP 进行配置,可能会遇到问题。

具体需为该端点禁用代理缓冲。其他可调整项包括:禁用 gzip 压缩(n8n 会自行处理)、禁用分块传输编码,并将 Connection 设为空字符串以从转发标头中移除。在 MCP 端点中显式禁用这些配置可确保其不会从 nginx 配置的其他位置继承。

适用于 MCP 流量的 nginx location 区块配置示例如下:

location /mcp/ { proxy_http_version 1.1; proxy_buffering off; gzip off; chunked_transfer_encoding off; proxy_set_header Connection ''; # The rest of your proxy headers and settings # . . . }