n8n + MCP Server 深度集成指南：让工作流直连 AI Agent（2026）

零代码打通 n8n 自动化与 MCP 协议，构建真正的 AI 工作流

返回教程列表

进阶约 25 分钟

n8n + MCP Server 深度集成指南：让工作流直连 AI Agent（2026）

零代码打通 n8n 自动化与 MCP 协议，构建真正的 AI 工作流

本教程教你如何将 n8n 自动化平台与 MCP Server 深度集成，让 Claude、Cursor 等 AI 工具直接调用你的 n8n 工作流。涵盖 HTTP Request 节点配置、认证方案、错误处理和 5 个真实案例。

n8nMCP工作流自动化AI Agent集成n8n MCP

n8n + MCP Server 深度集成指南（2026）

直接回答

n8n 与 MCP 集成的本质：把 n8n 的 Webhook 节点暴露为 MCP 工具，让 AI 模型可以通过自然语言触发你的自动化流程。一行配置，AI 就能操控你的 200+ 个 n8n 集成。

最快捷方案：使用社区开源的 n8n-mcp-server 包，5分钟完成配置。

为什么要集成 n8n 和 MCP？

n8n 有 400+ 集成（Slack、Notion、Gmail、GitHub……），MCP 是 AI 工具的通用接口协议。两者结合：

AI 能通过自然语言触发复杂的自动化工作流

n8n 工作流获得 AI 决策能力

无需为每个工具单独写 MCP Server

方案一：使用 n8n-mcp-server（推荐）

安装

bash
npm install -g n8n-mcp-server
或
bun add -g n8n-mcp-server

配置 Claude Desktop

在 ~/.claude/claude_desktop_config.json 中添加：

json
{
  "mcpServers": {
    "n8n": {
      "command": "n8n-mcp-server",
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

配置 Cursor

在 .cursor/mcp.json 中添加同样配置，重启 Cursor 即可。

方案二：自建 MCP Webhook 转发层

适合需要自定义逻辑的场景：

typescript
// mcp-n8n-bridge.ts
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
const server = new Server({ name: 'n8n-bridge', version: '1.0.0' });
// 注册 n8n 工作流为 MCP 工具
server.setRequestHandler('tools/list', async () => ({
  tools: [
    {
      name: 'trigger_workflow',
      description: '触发 n8n 工作流',
      inputSchema: {
        type: 'object',
        properties: {
          workflow_id: { type: 'string' },
          payload: { type: 'object' }
        },
        required: ['workflow_id']
      }
    }
  ]
}));server.setRequestHandler('tools/call', async (req) => {
  const { workflow_id, payload } = req.params.arguments;
  const res = await fetch(${process.env.N8N_BASE_URL}/webhook/${workflow_id}, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload)
  });
  return { content: [{ type: 'text', text: await res.text() }] };
});

5 个真实使用案例

案例1：AI 自动发 Slack 消息

n8n 工作流：Webhook → Slack 节点

MCP 工具：send_slack_message

使用方式：告诉 Claude「把今天的工作总结发到 #daily 频道」

案例2：AI 创建 Notion 任务

n8n 工作流：Webhook → Notion API 节点

MCP 工具：create_notion_page

使用方式：「把这个需求文档保存到 Notion 产品库」

案例3：AI 触发 CI/CD 流水线

n8n 工作流：Webhook → GitHub API

MCP 工具：trigger_deploy

使用方式：「部署 main 分支到测试环境」

案例4：AI 发送营销邮件

n8n 工作流：Webhook → Mailchimp → 日志节点

MCP 工具：send_campaign

使用方式：「给这周注册的新用户发欢迎邮件」

案例5：AI 生成并保存报告

n8n 工作流：Webhook → 数据汇总 → Google Sheets

MCP 工具：generate_report

使用方式：「生成本月销售报告并存入 Google Sheets」

安全配置要点

API Key 权限最小化：n8n API Key 只开 Webhook 执行权限

Webhook 鉴权：启用 n8n 的 Header Auth 或 Basic Auth

速率限制：在 n8n 工作流前加 Rate Limit 节点，防止 AI 误操作刷接口

沙箱测试：正式上线前在 n8n 测试环境验证

故障排查

问题：MCP 工具列表为空

检查 N8N_BASE_URL 是否包含 https://

验证 API Key 是否有 workflows:read 权限

问题：Webhook 触发无响应

确认 n8n 工作流已激活（Active 状态）

检查工作流是否有 Webhook 触发节点

问题：返回数据格式错误

在 n8n 最后加 Respond to Webhook 节点，明确定义返回格式

FAQ

Q：n8n 云版和自托管版都支持 MCP 集成吗？ A：都支持。云版需要开启外网 Webhook 访问，自托管版需要确保 MCP Server 能访问 n8n 实例。

Q：如何让 AI 知道有哪些可用的 n8n 工作流？ A：在 n8n-mcp-server 配置中设置 WORKFLOW_TAGS=mcp-enabled，只有打了该标签的工作流才会暴露为 MCP 工具，避免 AI 误操作其他流程。