用途:该技能用于把 n8n 工作流作为工具暴露给编码智能体按名称调用,适用于两类场景。其一,封装 MCP 尚未原生暴露的 n8n API 能力,例如文件夹 CRUD、标签重命名与删除、实例元数据、凭据创建等;其二,把与 n8n 本身无关的通用工作流(调用第三方 API、执行业务逻辑、查询私有系统)变成 MCP 可调用工具,让智能体在编码会话中执行真实操作。MCP 调用工作流的方式等同于调用原生工具:输入来自 Execute Workflow Trigger,输出取自工作流最后一个节点。
主要能力:构建无状态、可查询的封装工具(适合场景一,无副作用),或按项目需要构建带业务逻辑的工具(场景二,允许有副作用,但必须在工具描述中写明)。常见场景一封装包括文件夹创建(输入 projectId、name、parentFolderId,输出 id、name、projectId、parentFolderId)与实例信息查询(输出 version、edition、integrations、limits)。
使用方式:先搜索已有封装,使用 search_workflows({ tags: ['tool'] }) 及能力关键词检索,命中则复用。构建前必须先征得用户同意,因为会在其实例上创建工作流并涉及凭据。凭据必须通过 credential 使用,禁止硬编码,可用 n8nApi 或相应 header 认证。封装 n8n 自身 API 可从 REST 参考 https://docs.n8n.io/api/api-reference/ 入手,自托管实例地址为 <instance-url>/api/v1/。工作流结构为:Execute Workflow Trigger 声明输入、主体节点实现逻辑、最后节点返回结构化输出。完成后需验证、测试、发布,可主动提出在智能体的上下文文件(如 CLAUDE.md、AGENTS.md、GEMINI.md)中直接添加该工具条目,但需先询问。调用分两步:先用 search_workflows({ query: '<keyword>' }) 发现,筛选 availableInMCP: true;再用 get_workflow_details 读取输入结构,最后 execute_workflow({ workflowId, inputs }) 执行。智能体创建的工作流默认 availableInMCP: true,UI 创建的可能需手动在设置中开启。
适用场景:文件夹 CRUD、标签重命名/删除、实例元数据、凭据创建等 MCP 未覆盖的 n8n 操作;需要固化的重复性智能体任务;访问智能体无法直接触达的私有或第三方系统。
限制与注意:一次性问题、MCP 已原生暴露的能力不应使用此方案。避免未经询问创建、不记录工具条目、硬编码令牌、未说明副作用的工具、无 dry-run 的批量或破坏性操作、返回凭据值,以及跳过验证测试流程。资料未提供具体收费与价格信息。