MCP 服务器触发节点
使用 MCP Server Trigger 节点允许 n8n 充当 Model Context Protocol (MCP) 服务器,使 n8n 工具和工作流可供 MCP 客户端使用。
提示
Credentials 凭证
有关此节点的身份验证信息,请参阅 HTTP Request 凭据文档。
MCP 服务器触发节点如何工作
MCP Server Trigger 节点充当 MCP 客户端进入 n8n 的入口点。它通过公开一个 URL 来运行,MCP 客户端可以与该 URL 交互以访问 n8n 工具。
与传统的触发器节点^1不同,传统触发器节点会响应事件并将输出传递给下一个相连的节点,而 MCP Server Trigger 节点只会连接并执行工具节点。客户端可以列出可用工具,并逐一调用工具来完成任务。
您可以通过 Custom n8n Workflow Tool 节点附加 n8n 工作流,将其公开给客户端。
提示
Server-Sent Events (SSE) and streamable HTTP support 服务器发送事件 (SSE) 和流式 HTTP 支持
MCP Server Trigger 节点同时支持 Server-Sent Events (SSE)(一种基于 HTTP 构建的长连接传输)和用于客户端与服务器之间连接的 streamable HTTP。它目前不支持标准输入/输出 (stdio) 传输。
节点参数
使用这些参数配置您的节点。
MCP URL
MCP Server Trigger 节点有两个 MCP URLs MCP URL:测试和生产。n8n 在节点面板顶部显示 URL。
选择 Test URL 测试 URL 或 Production URL 生产 URL 来切换 n8n 显示的 URL。
- Test 测试:当您选择 Listen for Test Event 监听测试事件 或 Execute workflow 执行工作流(如果工作流未处于活动状态)时,n8n 会注册测试 MCP URL。当您调用 MCP URL 时,n8n 会在工作流中显示数据。
- Production 生产:当您发布工作流时,n8n 会注册生产 MCP URL。使用生产 URL 时,n8n 不会在工作流中显示数据。您仍然可以查看生产执行的工作流数据:在工作流中选择 Executions 执行 选项卡,然后选择您要查看的工作流执行。
认证
您可以要求连接到 MCP URL 的客户端进行身份验证。可选择:
- None 无
- n8n User Auth (OAuth2):节点版本 2 及更高版本可用。调用方必须同意使用其 n8n 账户。
- Bearer auth Bearer 认证
- Header auth 标头认证
选择 n8n User Auth (OAuth2) 后,会出现额外的参数。可用参数取决于节点版本:
- Require Workflow Execute Permission 要求工作流执行权限:触发用户是否还必须拥有在工作流所属项目中执行该工作流的权限。默认启用。
- Trusted Source Name or ID 受信任来源名称或 ID:其访问令牌可以调用此 MCP 服务器的身份提供商。
- Include User in Output 在输出中包含用户:节点版本 2.1 及更高版本可用。是否在触发器输出以及所连接工具收到的请求中包含调用用户的 ID、电子邮件和姓名。默认启用。
有关设置每种凭证类型的更多信息,请参阅 HTTP Request 凭据文档。
路径
默认情况下,此字段包含随机生成的 MCP URL 路径,以避免与其他 MCP Server Trigger 节点发生冲突。
您可以手动指定 URL 路径,包括添加路由参数。例如,如果您使用 n8n 来原型化 API 并希望一致的端点 URL,您可能需要这样做。
说明
MCP 客户端连接时发送给它们的可选说明(Instructions)。支持服务器说明的客户端通常会将其添加到模型的系统提示词中。可用于跨多个工具的指导,例如工具选择规则或多步骤工作流。
模板和示例
浏览 MCP 服务器触发器节点文档集成模板 或 搜索所有模板
与 Claude 桌面 集成
您可以通过运行网关将 SSE 消息代理到基于 stdio 的服务器,从 Claude Desktop 连接到 MCP Server Trigger 节点。
为此,请将以下内容添加到您的 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 Server Trigger 节点参数和凭据中的值。
限制
使用 Webhook 副本 配置 MCP 服务器触发器节点
MCP 服务器触发器节点依赖于服务器发送事件 (SSE) 或可流式 HTTP,这需要相同的服务器实例来处理持久连接。在 队列模式 下运行 n8n 时,这可能会导致问题,具体取决于您的 webhook 处理器 配置:
- 如果您使用队列模式与 单个 webhook 副本,MCP Server Trigger 节点将按预期工作。
- 如果您运行 多个 webhook 副本,您需要将所有
/mcp*请求路由到单个专用 webhook 副本。为 MCP 请求创建一个带有一个 webhook 容器的单独副本集。之后,更新您的入口或负载均衡器配置,将所有/mcp*流量定向到该实例。
警告
Caution when running with multiple webhook replicas 使用多个 Webhook 副本运行时的注意事项
如果您运行具有多个 Webhook 副本的 MCP 服务器触发器节点,并且不将所有 /mcp* 请求路由到单个专用 Webhook 副本,则您的 SSE 和可流式 HTTP 连接将频繁中断或无法可靠地传送事件。
Authentication 设为 None 时,claude.ai 仍要求用户登录
即使将 Authentication 身份验证设为 None 无,claude.ai 自定义连接器仍会要求您登录 n8n。目前已知只有 claude.ai 会出现此行为。
您的实例会为其他触发器提供 n8n 用户身份验证,而 claude.ai 会假定您域名下的所有 MCP endpoint 都使用该身份验证方式。
相关资源
n8n 还提供 MCP 客户端工具 节点,允许您将 n8n AI 代理连接到外部工具。
有关协议、服务器和客户端的更多详细信息,请参阅 MCP 文档和 MCP 规范。
常见问题
以下是 MCP Server Trigger 节点的一些常见错误和问题以及解决或故障排除步骤。
使用反向代理运行 MCP 服务器触发器节点
在像 nginx 这样的反向代理后面运行 n8n 时,如果 MCP 端点未配置为 SSE 或可流式 HTTP,您可能会遇到问题。
具体来说,您需要为端点禁用代理缓冲。您可能想要调整的其他项目包括禁用 gzip 压缩(n8n 自己处理这个)、禁用分块传输编码,以及将 Connection 设置为空字符串以从转发的标头中删除它。在 MCP 端点中显式禁用这些确保它们不会从 nginx 配置中的其他地方继承。
用于使用这些设置为 MCP 流量提供服务的示例 nginx 位置块可能如下所示:
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
# . . .
}