让 Claude Code 搭建 n8n 工作流
通过 n8n-MCP 为 Claude Code 提供节点文档、参数结构及工作流创建能力,让自然语言需求转为自动化流程。实践要求将密钥放入环境变量、先查节点文档,并在保存前完成校验。
AI 深度解读
让 Claude Code 搭 n8n 工作流,真正省下的是拖节点、查字段名的重复劳动。作者的做法是接入 n8n-MCP,让它查文档、生成并校验工作流,再由人检查和测试。
这套方案值得看,重点在于给 AI 划清操作边界:先查再用、校验后保存、复制后测试、不向真实客户发消息。作者已经在客户项目中使用,但没有提供效率提升或错误率的对照数据。
接上 n8n-MCP,Claude Code 才有依据可查
作者的团队每周为客户搭建 n8n 自动化,过去最耗时的是连接节点、寻找正确的字段名。现在,他们用自然语言描述流程,让 Claude Code 在 n8n 实例里搭建,再人工审核。
这里的关键组件是开源的 n8n-MCP server。它给 Claude Code 提供 n8n 节点的文档和结构定义(schema),以及创建、更新工作流的工具。AI 因而可以先查节点支持什么参数,再动手配置。
准备工作有三项:安装 Claude Code;准备可访问的 n8n 实例,自托管或云端均可;从 n8n → Settings → n8n API 获取 API key。
随后,把 n8n URL 和 API key 作为环境变量,添加到 Claude Code 的 n8n-MCP 配置中。原文只给出了 claude mcp add … 这个命令轮廓,完整命令需要查看 n8n-MCP README,不能直接照这段执行。
重启 Claude Code 后,让它列出已有工作流。能列出来,就完成了连接检查。API key 应放在环境变量中,不要写进提示词,也不要放进会提交到仓库的文件。
四条规则分别挡住什么问题
让 AI 能创建工作流之前,先规定它必须如何创建。
作者给 Claude Code 的四条规则,对应四类常见风险:
- 使用节点前先搜索节点文档。作者观察到,不查文档时,模型会凭记忆猜参数名,结果经常只猜对一部分。
- 保存前先校验。n8n-MCP 提供校验工具,校验通过后才允许创建工作流。原文没有给出这个工具的准确调用名。
- 不直接修改正在运行的工作流。先建副本,用固定样本数据(pinned sample data)测试,再替换线上流程。
- 测试时只用测试数据,不向真实客户发送消息。涉及 WhatsApp 或 email 的流程尤其需要这条限制。
这几条并不复杂,但覆盖了从配置错误到外部误操作的不同阶段。参数校验解决配置是否合规,副本和测试数据则限制试错会影响谁。
提示词要交代流程,也要交代停止条件
作者给出的提示词同时说明触发条件、等待时间、字段映射和操作限制:
Build an n8n workflow: when a new row is added to the "Leads" Google Sheet, wait 5 minutes, send a WhatsApp message to the number in column C using the template in column D, and log the result in column E. Search the node docs first, validate before saving, and don't activate it.
尤其要看最后一句:先查文档,保存前校验,并且不要激活。前面写清楚了流程要做什么,最后一句限定了 AI 做到哪里必须停下。
其中,Leads 表新增行是触发条件,等待时间是 5 分钟,C 列存号码,D 列存模板,E 列记录结果。这类明确的字段对应关系,比「帮我做一个线索跟进自动化」更容易检查。
但作者也列出了仍需人工处理的部分:凭据要自己在 n8n 中连接;涉及金额、价格或客户承诺时,要逐行检查 AI 节点使用的提示词;错误处理必须明确提出,否则可能只得到一条成功路径,失败时没有有效反馈。
我的判断
这套方法最有价值的地方,是把 AI 的产出放进一个可审核的交付过程。查文档比凭记忆配置更有依据,先复制再测试也适合已有线上流程的团队。
不过,作者没有提供搭建耗时、校验失败率或上线事故率,所谓提效仍属于团队经验,不能据此判断普通团队能节省多少时间。
还要分清校验通过和业务正确。节点参数合法,不代表选对了收件人、消息模板符合预期,或者失败后能被发现。四条规则写进提示词,也不等于工具层面已经强制执行;原文没有说明是否存在这样的约束。
与手工搭建相比,这种方式把劳动转向了需求描述和结果审核。对于分支很多、客户承诺复杂的流程,审核仍可能是主要工作。
能拿来做什么
- 给日常自动化任务写需求时,把触发条件、字段映射、等待时间和停止条件一起写清楚,可以直接参考原文的
Leads示例。 - 在项目的
CLAUDE.md中记录查文档、保存前校验、使用副本和测试数据等规则。作者提到团队有这样的系统提示词,但没有公开完整内容,需要自行整理。 - 测试 WhatsApp 或 email 流程时,准备固定样本,并检查实际收件对象;保留「不要激活」的要求,审核完成后再切换。
- 单独要求错误处理,并验证失败后能否留下可检查的结果。涉及金额、价格和客户承诺时,把 AI 节点提示词列入人工审核范围。