用途
当单个 MCP 连接可以访问多个 n8n 实例（例如生产、预发，或每个客户/团队一个实例）时，本技能用于在操作前明确当前会话指向哪个实例，并在需要时切换目标，防止读错数据或写错环境。
主要能力
- 通过
n8n_instances({mode:"list"})查看当前实例、默认实例和可用实例列表。 - 通过
n8n_instances({mode:"switch", name:"<实例名>"})将当前会话绑定到指定实例，名称不区分大小写。 - 在凭证创建/更新/删除等高危操作前，要求重新确认当前实例。
- 处理
UNKNOWN_INSTANCE、INSTANCE_AMBIGUOUS等错误，避免盲目重试或重建对象。
使用方式
- 先调用
n8n_instances({mode:"list"})发现实例与当前目标。 - 如需切换，单独调用 switch，等待返回并确认
current.name符合预期。 - 再执行依赖该实例的操作（如
n8n_list_workflows、n8n_get_workflow等）。 - 在凭证写入前，再次调用 list 确认 current，然后执行
n8n_manage_credentials。
禁止将 switch 与依赖操作放在同一并行批次中；切换后应独立完成再继续。遇到 INSTANCE_AMBIGUOUS 时，应在当前会话显式执行 switch 确认目标后再重试写入。
适用场景
- 在多个 n8n 环境之间复制工作流或凭证。
- 执行凭证管理操作前需要确保目标环境正确。
- 读取结果异常或出现意外
NOT_FOUND时，排查是否指向了错误实例。
限制
- 实例发现与切换依赖连接的 n8n MCP 服务器暴露多实例工具。
- 成功切换不代表授权变更，也不证明所选环境适合当前任务。
- 数据为空或缺失可能由其他原因导致，应先验证再切换。
- 会话生命周期、回退与凭证保护行为取决于服务器版本，需以实际 schema 和解析目标为准。
- 凭证读取可能返回脱敏数据，复制工作流不会复制其凭证，也不授权生产激活。