name: using-n8n-mcp-skillsdescription: 将 n8n MCP 工作流设计、编辑、验证、测试、部署、凭证、执行和调试任务路由到专家指南。risk: criticalsource: https://github.com/czlonkowski/n8n-skills/tree/main/skills/using-n8n-mcp-skillssource_repo: czlonkowski/n8n-skillssource_type: communitydate_added: “2026-07-21”author: Romuald Czlonkowskilicense: MITlicense_source: https://github.com/czlonkowski/n8n-skills/blob/main/LICENSE使用 n8n-mcp Skills使用时机在任何 n8n MCP 工作流设计、检查、编辑、验证、测试、部署、凭证、执行或排障任务开始时使用此路由器以便先加载相关的专家指南。从只读发现和实时 schema 检查开始。绝不要将秘密复制到提示词或工作流字段中绝不要推断目标实例并且在有副作用的测试、激活、删除、凭证变更或其他外部可见更改之前获得批准。这是一个路由器不是参考资料。它告诉你哪个技能拥有你即将要做的事情的规则。技能正文包含实际指南——用 Skill 工具调用它们。拿不准时多加载技能而不是少加载。社区n8n-mcp服务器和 n8n 本身比任何模型的训练截止日期发展得快。工具名称、参数、节点typeVersion和默认行为在各版本之间漂移。当你发现漂移时——技能提到的工具不存在、参数形状与get_node返回的不匹配、行为与技能描述的有所不同——相信实时工具告诉用户并建议更新技能包和实例。不可协商项三条没有例外的规则。每一条都防止一类看起来正确但在生产中崩溃的工作流。在任何 n8n 操作之前调用相关技能——不仅仅是在 MCP 调用之前。在编写表达式、配置节点、设计工作流、接线连接或编写 Code 之前调用匹配的技能。PreToolUse Hook 只在安装了插件包时在最关键的调用上提醒你在 Claude.ai纯技能上传无 Hook上责任完全在你。激活前验证并核实。在激活前运行validate_workflow或按 id 运行n8n_validate_workflow并在每次创建或更新后调用n8n_get_workflow检查connections对象。仅验证会漏掉静默丢弃的连线、Merge 索引差一错误以及从未接线的错误输出。验证通过只意味着 JSON 格式良好——并不意味着工作流正确。秘密绝不进入文本字段。令牌、API 密钥和密码始终通过 n8n 凭证系统。如果没有原生节点使用带官方凭证类型的 HTTP Request 节点。一个通过{{ $json.token }}引用的持有令牌的 Set 节点是带额外步骤的泄露。参见n8n-mcp-tools-expert。依赖技能而不是训练数据n8n 不断变化。记住的参数名常常是静默错误的——它们作为纯字符串验证通过然后在运行时什么也不做。相信技能和实时工具get_node、search_nodes、tools_documentation而不是记忆。如果技能与你的记忆矛盾相信技能。如果get_node与技能矛盾相信工具并标记漂移。强默认值每个技能拥有自己的例外这些是默认值。Code 节点是最后手段。先表达式然后是 Edit Fields 中的箭头函数只有两者都不能完成时才用 Code 节点。参见n8n-code-javascript。喂给 0-1 个消费者的 Set 节点几乎总是错误的。改为在消费者处内联表达式。参见n8n-expression-syntax。逐项迭代是自动的。当默认的逐项执行已处理该情况时不要添加 Loop Over Items 节点来让它循环。从实时 schema 配置绝不凭记忆。设置参数前先get_node。参见n8n-node-configuration。危险信号“即将___” → 调用___如果你发现自己有这些想法中的任何一个停下来并先调用指定的技能。想法调用“这个工作流很简单我就直接构建”n8n-workflow-patterns——大多数简单流程交付时都有 10 个节点“我加个 Set 节点来映射这些字段”n8n-expression-syntax——Set 喂给 ≤1 个消费者是第一大反模式“我就用 Code 节点更容易”n8n-code-javascript——门槛很高大多数需求用表达式或 Edit Fields“用户提到了数据我写 Python”n8n-code-javascript——默认 JSPythonn8n-code-python仅在明确要求时“我在写 AI Agent 会调用的代码”n8n-code-tool——与 Code 节点不同的运行时约定“日期计算——我放个 DateTime 节点”n8n-expression-syntax——内联 Luxon 几乎总是正确的“我接一个 3 来源的 Merge”n8n-node-configuration——Merge 默认为 2 个输入第 3 个会静默丢弃“验证通过了我可以激活了”n8n-validation-expertn8n-workflow-patterns——运行反模式扫描“验证抛出一个我不理解的错误”n8n-validation-expert——每个错误和警告的含义哪些是必修的与哪些是最佳实践建议“我在这里引用$json.x”n8n-expression-syntax——在分支工作流中优先$(Node).item.json.x“这个 webhook/定时流程只考虑正常路径”n8n-error-handling——在每个可能失败的节点上接错误分支4xx 是调用方错误5xx 是你的“我把这个文件/图像作为 JSON 传过去”n8n-binary-and-data——文件内容存在于$binary不能跨越 agent 工具边界“我接一个 AI agent 并给模型一些工具”n8n-agents——工具名称和描述就是提示词记忆、结构化输出和拓扑有陷阱“我把这个逻辑复制到另一个工作流” / “这个越来越大了”n8n-subworkflows——提取可复用的子工作流先搜索再构建“我创建那个凭证 / 打开那个工作流”账户有 1 个实例n8n-multi-instance——每个调用都命中当前定向的实例读取静默误路由歧义凭证写入以INSTANCE_AMBIGUOUS失败关闭技能索引技能何时使用using-n8n-mcp-skills本路由器自动加载。指出拥有你任务的技能。n8n-mcp-tools-expert选择或调用任何 n8n-mcp 工具节点发现凭证数据表安全审计模板n8n-workflow-patterns设计或构建工作流选择架构webhook / HTTP API / 数据库 / AI agent / 定时 / 批处理n8n-node-configuration配置任何节点感知操作的必填字段属性依赖外科手术式字段编辑n8n-expression-syntax编写{{ }}、$json/$node/$now在节点间映射数据转换把关人Set 节点纪律n8n-validation-expert解读验证错误/警告误报验证循环自动修复审查现有工作流n8n-code-javascript任何 JavaScript Code 节点数据访问this.helpersDateTimeSplitInBatches 循环模式n8n-code-python明确要求 Python 的 Code 节点标准库限制n8n-code-toolAI-agent 可调用的自定义代码工具toolCode——返回字符串无$fromAI/$inputn8n-error-handlingWebhook/API 或无人值守工作流接线错误输出重试4xx/5xx 响应形状静默失败n8n-binary-and-data文件、图像、PDF、附件、上传/下载、视觉在 agent 工具之间传递文件n8n-subworkflows可复用/多步骤构建Execute Workflow提取共享逻辑Define-Below 输入all-vs-each将工作流暴露为 agent 工具n8n-agentsAI Agent / LLM-with-tools / Text Classifier工具设计与$fromAI系统提示结构化输出记忆RAG人工审查聊天机器人n8n-multi-instance有多个实例的账户n8n_instances工具存在切换目标实例凭证写入前验证从意外的NOT_FOUND、错误/空读取或INSTANCE_AMBIGUOUS凭证写入失败关闭中恢复n8n-mcp 工具——从第一轮开始的工作知识限定名称看起来像mcp__server__toolserver通常是n8n-mcp。这弥补了工具完整描述在首次使用前未加载的差距。发现与文档tools_documentation——每个工具的元文档{topic:ai_agents_guide, depth:full}获取 agent 指南。search_nodes——按关键词查找节点。get_node——节点信息。接受单个短格式nodeTypenodes-base.httpRequest、nodes-langchain.agent外加detailminimal/standard/full和modeinfo/docs/search_properties/versions。validate_node——孤立验证一个节点的配置profileminimal/runtime/ai-friendly/strict。search_templates/get_template——模板库按关键词、节点、任务、元数据。构建与编辑n8n_create_workflow——从完整工作流 JSON 创建。n8n_update_partial_workflow——增量 diff 操作{id, operations:[…]}addNode、updateNode、patchNodeField、addConnection、activateWorkflow 等。编辑首选。n8n_update_full_workflow——完全替换。n8n_autofix_workflow——自动修复常见问题。n8n_deploy_template——将模板部署到实例。验证必要但不充分——始终与反模式扫描配对validate_workflow——完整 JSON 输入错误/警告/修复输出。这里的节点类型是长格式n8n-nodes-base.set。n8n_validate_workflow——按{id}验证已部署的工作流没有节点 JSON 可检查。检查与生命周期n8n_get_workflow——获取工作流full / structure / active / filtered / minimal。编辑后用其验证connectionsmodefilterednodeNames读取单个重型节点例如长 Code 源码而不拉取整个工作流后者可能在客户端截断。n8n_list_workflows——列出/过滤在复制逻辑前先搜索。n8n_delete_workflow、n8n_workflow_versions历史/回滚、n8n_instances仅多实例账户列出/切换目标实例——参见n8n-multi-instance、n8n_health_check返回解析出的instanceName。测试与运行n8n_test_workflow——运行真实节点Code、HTTP、DB 写入、发送全部会触发。存在副作用时在运行前询问用户。n8n_executions——列出/检查执行。没有execute_workflow工具。n8n_evaluations——读取评估测试运行n8n ≥ 2.30列出运行、聚合指标、逐用例结果。只读——运行从 n8n 编辑器启动而不是 API403 通常意味着 API 密钥早于 2.30为 testRun 范围重新创建它。数据、凭证、审计n8n_manage_datatable——Data Table CRUD、过滤、dry-run。n8n_manage_credentials——凭证 CRUD getSchema发现。n8n_audit_instance——安全审计硬编码秘密、未认证 webhook、错误处理缺口。节点类型形式陷阱get_node/validate_node接受短格式nodes-base.setvalidate_workflow/n8n_create_workflow内的工作流 JSON 使用长格式n8n-nodes-base.set。混淆它们是常见、静默的错误——参见n8n-mcp-tools-expert。协议按顺序从索引中识别匹配的技能并在第一次 MCP 调用之前调用它。如果不确定每个会话浏览一次tools_documentation以刷新工具表面。配置任何节点之前get_node——读取实时 schema不要假设。构建/编辑然后激活前validate_workflow之后**n8n_get_workflow** 检查connections。表面化你注意到的任何漂移缺失工具、更改的参数、不同的行为。拿不准时找不到用户用 UI 构建的工作流最常见的原因是逐工作流 MCP 访问被关闭。请他们在 n8n 中打开它进入 Settings 并启用 MCP 访问。用户说它坏了相信他们。对照get_node重新检查参数追踪数据引用检查执行。参见n8n-validation-expert。没有技能匹配且任务不平凡在猜测前询问。这些是有主见的最佳实践不是法律。不同意某个判断都是 markdown——编辑技能。示例request:构建一个验证输入、调用 API 并返回结构化错误的 webhook。specialists:[n8n-workflow-patterns,n8n-node-configuration,n8n-error-handling]sequence:-检查目标实例和实时节点 schema-构建并验证图-预览副作用并获得批准-写入更改用 n8n_get_workflow 获取保存的工作流并重新验证-仅在批准后激活和测试局限性路由器描述的是一个不断变化的 n8n MCP 表面实时工具 schema 和目标实例覆盖过时示例。生命周期、凭证、评估和多实例工具的可用性取决于服务器版本和权限。路由到专家技能不授权变更、执行、激活、删除或凭证更改。