n8n MCP 工具专家
指导 AI 正确搜索、验证、创建和维护 n8n 工作流。
文档说明凭据响应会脱敏、审计会掩码秘密，并提供dryRun、校验、回滚和清理连接等机制；但对创建、删除凭据、修改数据表、部署及激活工作流缺少明确的用户确认、最小权限和统一的数据流披露。示例还直接展示令牌格式，故扣分。
工具分类、参数格式、错误类型和恢复路径较完整，且明确列出API依赖与部分不可修复问题；但性能、成功率和平均耗时缺乏可验证证据，示例中的人类可读节点ID又与要求UUID v4相冲突，并存在validate_workflow与n8n_validate_workflow命名混用，故扣分。
目标用户、触发词、典型场景和API不可用时的替代路径较清晰；但未声明充分的非适用范围、未提供中文使用支持说明，也未证明n8n-mcp核心依赖对中国大陆网络的可达性，故扣分。
目录按搜索、验证、工作流和运维指南分层，含示例、依赖说明、局限与MIT许可信息；但版本策略、变更日志、维护责任和更新路径不完整，README声称文件数与提供材料不一致，且若干工具/操作数量描述不一致，故扣分。
内容直接覆盖节点发现、配置验证、工作流编辑、凭据和审计等核心任务，示例通常可直接改写使用；但没有文件内的第三方执行结果或关键路径测试证据，且部分外部工具行为和性能声明无法静态确认，因此按静态上限给7分并扣除不确定性。
材料提供了大量参数、返回结构、错误分类和失败边界，具备一定审计性；但没有随材料提供可复现的CI、测试套件或独立第三方执行证据，性能、成功率及评估覆盖率主要是作者陈述，故扣分。
- 不要把文档中的性能、成功率、平均耗时或“40+工具”覆盖声明视为已验证事实。
- 执行凭据删除、数据表删除/更新、模板部署或工作流激活前，应要求用户确认目标、影响范围和回滚方案。
- 检查实际n8n-mcp版本、工具名称和节点ID要求；示例中的非UUID节点ID可能导致界面问题。
- 若面向中国大陆用户，应单独验证n8n-mcp及相关模板/服务的网络可达性。
这个 Skill 能做什么，适合哪些场景？
这是 n8n-skills 仓库中的一个独立 Agent Skill，专门指导如何有效使用 n8n-mcp MCP 工具。它覆盖节点发现、配置验证、工作流管理、模板部署、数据表、凭据管理和实例安全审计。内容还规定了不同工具所需的 nodeType 格式、验证配置、工作流迭代方式以及凭据和节点 JSON 的常见陷阱。它适合已经配置 n8n-mcp、希望通过 AI 操作 n8n 的用户；不应被当作整个仓库其他技能的替代品。
指导 AI 选择并调用 search_nodes、get_node、validate_node、validate_workflow、n8n_create_workflow、n8n_update_partial_workflow、n8n_deploy_template、n8n_manage_datatable、n8n_manage_credentials 和 n8n_audit_instance 等工具；说明参数格式、nodeType 前缀、验证 profile、智能分支参数和 intent 的使用；提供节点搜索、配置验证、工作流创建与迭代、模板部署、凭据操作及安全审计的步骤和示例；解释工具可用性、响应时间和常见错误。
- 使用 n8n-mcp 搜索 Slack、Webhook 或 HTTP Request 节点时，需要先确认正确的节点类型和详情级别。
- 创建或修改 n8n 工作流时，需要避免错误的凭据结构、节点 ID 和 typeVersion。
- 节点或完整工作流验证失败时，需要按 profile 读取错误、修复配置并重复验证。
- 需要从模板库查找并部署工作流，或在 n8n 实例中管理数据表和行。
- 管理、轮换凭据或检查实例中的硬编码密钥、未认证 Webhook 和错误处理问题。
这个 Skill 有哪些优点和局限？
- 覆盖从节点发现到工作流迭代、模板、数据表、凭据和安全审计的完整工具选择指导。
- 明确区分搜索/验证工具与工作流工具所需的两种 nodeType 格式。
- 提供凭据占位符、UUID v4 节点 ID、typeVersion、验证 profile 和智能参数等具体防错规则。
- 包含工具可用性、性能特征、常见错误和可复用操作模式。
- 依赖 n8n-mcp MCP 服务器；部分工作流、凭据、数据表和审计操作还需要 n8n API。
- 技能只指导 n8n-mcp 工具使用，不负责表达式、节点配置、代码或部署等其他主题。
- 来源没有提供该独立技能的单独测试结果或完整 API/SDK 安装步骤。
- README 的安装方式主要面向整个 15 技能集合，单独安装路径信息有限。
如何安装这个 Skill？
前提是已安装并配置 n8n-mcp MCP 服务器，并准备好 Claude Code、Claude.ai 或 Claude API 访问权限。安装整个仓库可执行：
/plugin install czlonkowski/n8n-skills
也可以克隆仓库后，将 skills/n8n-mcp-tools-expert 文件夹放入 Claude Code 的技能目录 ~/.claude/skills/。Claude.ai 支持下载并上传该技能文件夹；来源未提供单独安装此技能的 API/SDK 命令。
如何使用这个 Skill？
技能会在涉及 n8n、工作流、节点或自动化时自动激活。可使用提示："Find me a Slack node"、"Validate this n8n node configuration" 或 "Create and iteratively validate this workflow"。若直接使用工具，应遵循 search_nodes → get_node → validate_node 的节点流程，以及创建、验证、迭代后再激活工作流的顺序。需要 n8n API 的操作还要求配置 N8N_API_URL 和 N8N_API_KEY。