SuperAPI AI 工具集

n8n-multi-instance

智能体与模型

查看项目

更新于 10-15 20:30

技能介绍

用途:当 n8n-mcp 账户启用多实例模式(存在 n8n_instances 工具)时,一个 MCP 连接可访问多个 n8n 实例。除 n8n_instances 外的所有 n8n 工具(如 n8n_get_workflow、n8n_list_workflows、n8n_update_partial_workflow、n8n_manage_datatable、n8n_manage_credentials、n8n_executions、n8n_test_workflow)都作用于当前会话所选实例,没有按调用传实例的参数,只能通过切换改变目标。若不存在 n8n_instances 工具,则为单实例,直接使用 n8n 工具即可。

主要能力:n8n_instances 有两种模式。{mode:"list"} 返回 current、default、available,无副作用,available 中每项带 isCurrent;{mode:"switch", name:"<名称>"} 将本会话绑定到指定实例,返回 previous 与 current,名称大小写不敏感。切换绑定在会话内持续(约 24 小时,可跨重连、空闲与后端部署),其他会话相互独立。

使用方式:先 list 了解实例名与当前实例;对非默认实例操作前先 switch,且切换必须单独一轮调用,不能与依赖它的操作放在同一并行批次;高风险操作(创建/更新/删除凭据、破坏性工作流编辑)前立即再 list 确认 current。跨实例复制时按“切到 A 读取 → 单独切到 B → list 确认 → 在 B 创建”的顺序逐步执行。

限制与错误:错误返回 {error, message, …},常见有 UNKNOWN_INSTANCE、NAME_REQUIRED、MULTI_INSTANCE_DISABLED、NO_SESSION、UNKNOWN_MODE、INVALID_CONTEXT。凭据写入路径可能返回 INSTANCE_AMBIGUOUS:当会话自身从未切换、却继承了指向非默认实例的切换时,服务器会拒绝写入(不触达 n8n、不计配额),需在本会话执行 switch 确认目标后重试。意外的 NOT_FOUND 通常是实例错位而非对象被删,应核对实例后重试,不要重建对象。若所选实例被删除,后续调用会静默回退到默认实例。凭据读取不受该保护,仍可能读到错误实例的数据。n8n_manage_credentials 的 CRUD 与 getSchema 细节由 n8n-mcp-tools-expert 技能负责。