[ PROMPT_NODE_28120 ]
N8n MCP Tools Expert 工作流指南
[ SKILL_DOCUMENTATION ]
# 工作流管理工具指南
创建、更新和管理 n8n 工作流的完整指南。
---
## 工具可用性
**⚠️ 需要 n8n API**: 本指南中的所有工具都需要配置 `N8N_API_URL` 和 `N8N_API_KEY`。
如果不可用,请使用模板示例和仅验证的工作流。
---
## n8n_create_workflow
**成功率**: 96.8% | **速度**: 100-500ms
**使用场景**: 从零开始创建新工作流
**语法**:
javascript
n8n_create_workflow({
name: "Webhook to Slack", // 必填
nodes: [...], // 必填: 节点数组
connections: {...}, // 必填: 连接对象
settings: {...} // 选填: 工作流设置
})
**返回**: 带有 ID 的已创建工作流
**示例**:
javascript
n8n_create_workflow({
name: "Webhook to Slack",
nodes: [
{
id: "webhook-1",
name: "Webhook",
type: "n8n-nodes-base.webhook", // 完整前缀!
typeVersion: 1,
position: [250, 300],
parameters: {
path: "slack-notify",
httpMethod: "POST"
}
},
{
id: "slack-1",
name: "Slack",
type: "n8n-nodes-base.slack",
typeVersion: 1,
position: [450, 300],
parameters: {
resource: "message",
operation: "post",
channel: "#general",
text: "={{$json.body.message}}"
}
}
],
connections: {
"Webhook": {
"main": [[{node: "Slack", type: "main", index: 0}]]
}
}
})
**注意**:
- 创建的工作流默认为 **非激活状态** (需单独激活)
- 创建时会自动运行清理程序
- 为获得最佳结果,请在创建前进行验证
---
## n8n_update_partial_workflow (最常用!)
**成功率**: 99.0% | **速度**: 50-200ms | **使用次数**: 38,287 (最常用工具!)
**使用场景**: 对工作流进行增量更改
**常用模式**: 编辑间平均 56s (迭代构建!)
### 15 种操作类型
**节点操作** (6 种):
1. `addNode` - 添加新节点
2. `removeNode` - 按 ID 或名称移除节点
3. `updateNode` - 更新节点属性
4. `moveNode` - 更改位置
5. `enableNode` - 启用已禁用节点
6. `disableNode` - 禁用已激活节点
**连接操作** (5 种):
7. `addConnection` - 连接节点
8. `removeConnection` - 移除连接
9. `rewireConnection` - 更改目标
10. `cleanStaleConnections` - 自动移除损坏的连接
11. `replaceConnections` - 替换整个连接对象
**元数据操作** (4 种):
12. `updateSet