在 2026 年,AI Agent 已经从概念走向生产。但大多数团队面临一个共同挑战:如何让 AI Agent 调用企业内部的业务系统?传统的 API 集成需要为每个系统编写胶水代码,而 MCP(Model Context Protocol)协议的出现,正在改变这一局面。
本教程将带你实战 n8n 1.0 的核心新特性 —— AI Agent 节点与 MCP 协议的深度集成。你将学会如何将 n8n 工作流暴露为 MCP 工具,让任意支持 MCP 的 AI Agent(如 Claude、Cursor)直接调用你的自动化工作流。
- 理解 MCP 协议的原理与架构
- 掌握 n8n MCP Server 与 Client 节点的配置方法
- 实战构建一个可通过 AI 对话调用的智能工作流
- 学习生产环境的部署与最佳实践
核心概念与原理
什么是 MCP 协议?
MCP(Model Context Protocol)是一种标准化的 AI 工具集成协议。它定义了 AI Agent 与外部工具之间的发现、调用及响应机制,支持基于 Server-Sent Events(SSE)或 HTTP Streamable 的实时通信。
简单来说,MCP 让 AI Agent 可以像人类使用软件一样:
- 发现工具:自动识别可用的功能列表
- 理解参数:获取每个工具的输入输出规范
- 调用执行:发送请求并获取结果
- 流式响应:实时接收处理进度和结果
n8n 的 MCP 实现
n8n 通过社区节点 n8n-nodes-mcp 提供完整的 MCP 支持:
环境准备与依赖
前置要求
- n8n Cloud 账户或自托管 n8n 实例(建议 v1.0+)
- Node.js 18+(自托管时需要)
- OpenAI API Key(用于 AI Agent 节点)
- Redis(生产环境队列模式需要)
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true 以允许 AI Agent 使用 MCP 工具。
安装 MCP 社区节点
在 n8n 设置中,进入「Community Nodes」页面,搜索并安装 n8n-nodes-mcp。或者在自托管环境中运行:
npm install n8n-nodes-mcp
实战步骤:构建智能工作流
创建工作流并添加触发器
新建 n8n 工作流,添加 Chat Trigger 节点作为入口。这个节点将接收来自 AI Agent 的请求。
{
"nodes": [
{
"name": "Chat Trigger",
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"parameters": {}
}
]
}
添加 AI Agent 节点
添加 AI Agent 节点,配置连接的聊天模型(如 OpenAI GPT-4o-mini)。在「System Message」中输入任务描述:
你是一个智能助手,负责调用可用的工具完成用户请求。
你有以下工具可用:MCP 工具、HTTP 请求、数据处理节点。
请根据用户需求选择最合适的工具组合。
配置 MCP Server Trigger
添加 MCP Server Trigger 节点,将工作流暴露为 MCP 工具:
{
"name": "MCP Server",
"type": "n8n-nodes-mcp.serverTrigger",
"parameters": {
"connectionType": "HTTP Streamable",
"toolName": "customer_data_lookup",
"toolDescription": "查询客户数据,支持按邮箱或公司名搜索",
"authToken": "your-secure-random-token-here"
}
}
添加业务逻辑节点
在 MCP Server Trigger 后添加实际的业务逻辑节点,例如 HTTP Request 调用 CRM API:
{
"name": "HTTP Request",
"type": "n8n-nodes-base.httpRequest",
"parameters": {
"requestMethod": "GET",
"url": "={{ $json.query.endpoint }}",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "email",
"value": "={{ $json.query.email }}"
}
]
}
}
}
(可选)添加 MCP Client 调用外部工具
如果需要调用外部 MCP 服务(如 Brave Search),添加 MCP Client Tool 节点:
{
"name": "MCP Client",
"type": "n8n-nodes-mcp.client",
"parameters": {
"connectionType": "HTTP Streamable",
"serverUrl": "https://mcp.brave.com/mcp",
"credentials": "Brave Search Credentials",
"operation": "executeTool",
"toolName": "brave_search",
"parameters": {
"query": "={{ $json.query }}"
}
}
}
测试工作流
激活工作流后,使用以下方法测试:
- 通过 n8n 的「Execute Workflow」手动触发
- 使用 curl 测试 MCP 端点:
curl -X POST https://your-n8n.com/mcp/tools/customer_data_lookup \
-H "Authorization: Bearer your-secure-token" \
-H "Content-Type: application/json" \
-d '{"query": {"email": "test@example.com"}}'
与 AI Agent 集成
工作流发布后,可以在支持 MCP 的 AI Agent 中配置调用。以 Claude Code 为例,在配置文件中添加:
{
"mcpServers": {
"n8n-workflow": {
"command": "curl",
"args": [
"-X", "POST",
"https://your-n8n.com/mcp/tools/customer_data_lookup",
"-H", "Authorization: Bearer your-secure-token",
"-H", "Content-Type: application/json",
"-d", "$INPUT"
]
}
}
}
配置完成后,Claude 可以直接调用你的工作流:
用户:帮我查询 test@example.com 的客户信息
Claude: 正在调用 n8n-workflow 工具查询客户数据...
查询结果:张三,ABC 公司,最后登录 2026-03-20
常见问题与解决方案
进阶技巧与最佳实践
版本控制与预发布
n8n 支持工作流的版本控制。在发布新版本前:
- 导出当前工作流作为备份
- 在预发布环境测试新版本
- 使用 Git 进行版本管理(自托管用户)
- 灰度发布,逐步切换流量
总结
- MCP 协议是 2026 年 AI 工具集成的标准,支持运行时工具发现和流式响应
- n8n 通过 MCP Server 和 Client 节点,实现工作流的双向集成
- 生产环境需要启用队列模式、添加错误处理、实现安全认证
- 结合 AI Agent,可以构建自然语言驱动的智能自动化系统