SuperAPI AI 工具集

n8n-multi-instance

智能体与模型

查看项目

更新于 10-15 20:30

技能介绍

用途:当 n8n-mcp 账号面向多个 n8n 实例时,用本技能管理“当前会话指向哪个实例”。若 n8n_instances 工具不存在,则为单实例,直接使用 n8n 工具即可。

主要能力:n8n_instances 支持两种模式。{mode:"list"} 返回 current、default、available,无副作用;{mode:"switch", name:"<实例名>"} 将本会话绑定到指定实例,返回 previous 与 current,名称大小写不敏感。切换后,其余 n8n 工具(n8n_get_workflow、n8n_list_workflows、n8n_update_partial_workflow、n8n_manage_datatable、n8n_manage_credentials、n8n_executions、n8n_test_workflow 等)都作用于当前实例,没有按调用传实例的参数。

使用方式:先 n8n_instances({mode:"list"}) 了解实例名与当前实例;再单独一次调用 switch 绑定目标,等其返回后再执行依赖操作,切勿把切换与依赖调用放在同一并行批次。高风险操作(创建/更新/删除凭据、破坏性工作流编辑)前,紧邻地用 list 复核 current。跨实例复制时,先切到 A 读取,再单独切到 B,确认 current 为 B 后创建。

限制与错误:UNKNOWN_INSTANCE 表示名称不匹配,按错误中 available 重试;NAME_REQUIRED 需补 name;MULTI_INSTANCE_DISABLED 表示多实例模式关闭;NO_SESSION 需重连初始化会话;UNKNOWN_MODE 只能用 list 或 switch;INVALID_CONTEXT 属服务端问题。凭据写入若会话未自行切换而继承了别处的切换,会以 INSTANCE_AMBIGUOUS 失败关闭,需在本会话 switch 确认后重试。意外的 NOT_FOUND 通常是实例错位而非被删除,应复核实例后重试,不要重建对象。所选实例被删除后会静默回退到默认实例。切换绑定持续整个会话(约 24 小时),其他会话相互独立。