自动化与运维

n8n 多实例定位助手

帮助 MCP 会话安全选择、验证并切换目标 n8n 实例,避免误读和误写。

51/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code · Claude.ai · Claude API(部分支持)
Star 数
★ 6.4k
最近更新
19 天前
License
MIT
n8nmcpworkflow-automationmulti-instance
+2credential-managementerror-recovery

这个 Skill 能做什么,适合哪些场景?

这是 n8n-skills 仓库中的一个独立 Agent Skill,专门处理 n8n-mcp 连接访问多个 n8n 实例的情况。它指导助手先发现可用实例,再按名称切换当前会话目标,并在凭据写入或破坏性操作前验证目标。它还覆盖错误实例导致的 NOT_FOUND、空数据和 INSTANCE_AMBIGUOUS 场景。该 Skill 只负责实例定位与恢复流程,不替代其他 Skill 对工作流或凭据字段的具体操作指导。

指导助手调用 n8n_instances 的 list 模式读取 current、default 和 available 实例;调用 switch 模式按名称绑定当前 MCP 会话;要求将切换与后续依赖操作分开执行;在凭据创建、更新、删除及删除性工作流编辑前重新确认 current;针对 UNKNOWN_INSTANCE、INSTANCE_AMBIGUOUS、NOT_FOUND 和错误或空数据提供恢复步骤;指导在不同实例之间读取并复制工作流或凭据。

适合
  • 管理生产和预发布两个 n8n 实例的用户,需要在操作前确认当前会话指向正确环境。
  • 服务多个团队或客户、每个团队拥有独立 n8n 实例的用户,需要按实例名称切换目标。
  • 已知工作流或数据表存在却收到 NOT_FOUND 的用户,需要判断是否误连了其他实例。
  • 准备创建、更新或删除凭据的用户,需要在写入秘密前重新验证目标实例。
  • 凭据操作返回 INSTANCE_AMBIGUOUS 的用户,需要在当前会话中明确执行切换后重试。

如何安装这个 Skill?

使用前请注意
  • 显式切换到错误实例不会被 INSTANCE_AMBIGUOUS 拦截;凭证写入前必须人工确认 current,普通写操作也应先核验目标。
  • 目标 skill 未包含自动化测试或 CI 证据;部署前应在隔离的 staging 实例验证切换、删除实例后的 fallback 和误路由恢复行为。
  • 文档未说明中文支持或中国大陆网络可达性;实际采用前需确认 n8n-mcp 服务和相关 MCP 连接可访问。
开始前你需要
Agent 需要具备
  • MCP Server
需要预先安装
  • n8n-mcp MCP server

该 Skill 随 n8n-skills 集合安装。Claude Code 推荐执行:/plugin install czlonkowski/n8n-skills。手动安装可先运行 git clone https://github.com/czlonkowski/n8n-skills.git,再将 n8n-skills/skills/* 复制到 ~/.claude/skills/。使用前还需要已安装并配置 n8n-mcp MCP server,以及配置 .mcp.json。Claude.ai 可下载 skills/n8n-multi-instance 文件夹并通过 Settings → Capabilities → Skills 上传。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/n8n-multi-instance" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 切换到 prod 实例后查看工作流
  • 凭据写入返回 INSTANCE_AMBIGUOUS,如何安全恢复?

当 n8n_instances 工具可用、需要操作多个 n8n 环境,或出现错误实例、空数据、NOT_FOUND、INSTANCE_AMBIGUOUS 时使用。例如:"切换到 prod 实例后查看工作流",或"凭据写入返回 INSTANCE_AMBIGUOUS,如何安全恢复?"。实际操作依赖当前 MCP 会话中可用的 n8n 工具。

这个 Skill 有哪些优点和局限?

优点
  • 明确规定先列出实例、再切换并验证目标,降低静默误路由风险。
  • 特别强调凭据写入前的目标确认,并解释 INSTANCE_AMBIGUOUS 的 fail-closed 行为。
  • 提供针对 NOT_FOUND、空数据和实例删除后回退默认实例等情况的恢复流程。
  • 覆盖跨实例复制工作流或凭据的操作顺序。
局限
  • 必须使用提供 n8n_instances 工具的 n8n-mcp 多实例环境;单实例账户应直接使用 n8n 工具。
  • Skill 主要解决实例选择和恢复,不提供其他 n8n 工具的完整 CRUD 参数说明。
  • 源材料没有给出独立于 Claude Code、Claude.ai 或 MCP 会话的运行方式。
  • 显式切换到错误实例仍可能静默写入,安全性仍依赖操作者正确确认目标。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
n8n 多实例定位助手 本页 51 · 谨慎使用 ★ 6.4k 19 天前 MIT
n8n MCP 工具专家 45 · 不推荐 ★ 6.4k 19 天前 MIT
n8n 故障处理指南 53 · 谨慎使用 ★ 6.4k 19 天前 MIT
n8n MCP 工作流路由器 50 · 谨慎使用 ★ 6.4k 19 天前 MIT
n8n 验证专家 46 · 谨慎使用 ★ 6.4k 19 天前 MIT

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
51/ 100 五分制 2.6 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全14 / 25 · 2.8/5

文档明确要求先发现实例、切换后确认 current,并在凭证写入前再次核验;对 INSTANCE_AMBIGUOUS 设有 fail-closed 处理,也提醒凭证属于高风险数据。扣分在于普通读写和显式错误切换仍可能静默误路由,未提供通用回滚或撤销方案,敏感数据处理主要依赖未包含的其他 skill,且发布者身份未被验证。

2可靠稳定9 / 20 · 2.3/5

SKILL.md 提供了较完整的工具模式、错误代码、恢复步骤和并行调用陷阱,正常路径具有可执行性。扣分在于仅有静态文档证据,没有针对关键路径的提交测试或 CI 复现;README 还将规则数量描述为“五条”而正文实际列出六条,降低了一致性和故障诊断信心。

3适用触发10 / 15 · 3.3/5

触发条件、适用的多实例环境、单实例不适用边界和典型场景都较明确,并覆盖复制、误路由和凭证操作。扣分在于未说明中文交互支持、未讨论中国大陆网络可达性,也未充分界定 n8n-mcp 版本或工具变体差异。

4规范维护8 / 15 · 2.7/5

文档结构清晰,包含核心规则、工具形状、恢复表、快速参考、集成关系、版本 1.0.0、兼容性说明和 MIT 许可。扣分在于没有变更日志、明确维护责任人或更新路径,README 与目标 skill 的规则数量存在不一致,且 README 的仓库级测试声明不能证明该 skill 的覆盖情况。

5有效结果6 / 15 · 2.0/5

该 skill 直接给出 list、switch、核验、重试和跨实例复制的操作顺序,能够覆盖其声明的核心决策问题,预计可减少错误重建和误写凭证。扣分在于未执行验证,且没有可复现的代表性输出或第三方结果证据;复制工作流和凭证仍依赖其他 skill 的具体参数知识。

6证据核验4 / 10 · 2.0/5

源文件包含具体调用形状、错误代码、响应字段、恢复表和版本信息,具备有限的审计性。扣分在于提供的“真实响应”“生产测试”等说法未由目标 skill 内的测试套件、CI 或第三方证据独立 corroborate,静态审查无法验证行为是否与 n8n-mcp 实际实现一致。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 05eea4848c12 评估证据[1][2][3][4]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个 Skill 是否免费?
仓库采用 MIT 许可证。使用它仍需要配置 n8n-mcp MCP server,源材料未说明相关服务或 n8n 实例本身的费用。
它会自动切换到正确的 n8n 实例吗?
不会替用户推断目标。它要求先列出实例,并按用户确认的名称执行 switch;切换后还应验证 current。
收到 NOT_FOUND 是否意味着对象被删除?
在多实例场景中,Skill 将意外 NOT_FOUND 视为可能的错误实例路由,建议先检查 current、切换到目标实例并重试,而不是立即重建对象。
凭据写入遇到 INSTANCE_AMBIGUOUS 怎么办?
在当前会话中明确调用 n8n_instances 的 switch 模式选择目标实例,确认目标后再重试写入,不要盲目重复请求。

同仓库的其他 Skills

均来自 czlonkowski/n8n-skills

自动化与运维

n8n MCP 工具专家

指导 AI 正确搜索、验证、创建和维护 n8n 工作流。

★ 6.4k FS 45 不推荐 19 天前
自动化与运维

n8n 故障处理指南

让 n8n 工作流的失败可路由、可告警、可恢复。

★ 6.4k FS 53 谨慎使用 19 天前
自动化与运维

n8n MCP 工作流路由器

为 n8n-mcp 工作流任务匹配正确技能并降低生产故障。

★ 6.4k FS 50 谨慎使用 19 天前
自动化与运维

n8n 验证专家

帮助 AI 解释 n8n 验证结果,并逐步修复会阻止工作流运行的问题。

★ 6.4k FS 46 谨慎使用 19 天前
自动化与运维

n8n 子工作流架构指南

帮助你把 n8n 中可复用的多步逻辑封装成清晰、可测试、可被智能体调用的子工作流。

★ 6.4k FS 49 谨慎使用 19 天前
开发与工程

n8n 表达式语法助手

帮助你编写、检查并修复 n8n 工作流表达式。

★ 6.4k FS 47 谨慎使用 19 天前
自动化与运维

n8n 节点配置助手

按操作和字段依赖配置 n8n 节点,减少验证错误与静默失败。

★ 6.4k FS 46 谨慎使用 19 天前
自动化与运维

n8n 工作流架构模式

用经过验证的架构模式设计、验证和部署可靠的 n8n 工作流。

★ 6.4k FS 40 不推荐 19 天前
开发与工程

n8n AI 代码工具指南

帮助你为 n8n AI Agent 编写符合工具运行契约的 JavaScript 或 Python 代码。

★ 6.4k FS 54 谨慎使用 19 天前
自动化与运维

n8n 文件与二进制数据指南

帮助你在 n8n 中正确传递文件、处理二进制数据,并让 AI 工具和聊天界面可靠使用文件。

★ 6.4k FS 53 谨慎使用 19 天前
自动化与运维

n8n AI Agent 架构指南

帮助你为 n8n AI Agent 正确选择节点、连接工具并处理记忆、结构化输出与人工审核。

★ 6.4k FS 50 谨慎使用 19 天前
开发与工程

n8n Python 代码节点指南

帮助你在 n8n Code 节点中可靠编写受限环境下的 Python。

★ 6.4k FS 49 谨慎使用 19 天前
开发与工程

n8n JavaScript 代码节点助手

帮助你在 n8n Code 节点中编写可靠、高效的 JavaScript。

★ 6.4k FS 47 谨慎使用 19 天前
自动化与运维

n8n 自托管部署助手

在 Linux 服务器上通过 Docker、Caddy 和自动 HTTPS 部署生产级自托管 n8n。

★ 6.4k FS 46 谨慎使用 19 天前

相关 Skills