---

name: n8n-mcp-tools-expert description: 使用n8n-mcp MCP工具的专家指南。用于搜索节点、验证配置、访问模板、管理工作流或使用任何n8n-mcp工具时。提供工具选择指导、参数格式和常见模式。 risk: unknown source: community

n8n MCP工具专家

使用n8n-mcp MCP服务器工具构建工作流的完整指南。

何时使用

• 你正在使用n8n-mcp工具集来发现节点、验证配置或管理工作流。
• 任务涉及选择正确的MCP工具或理解其预期参数和使用模式。
• 你需要通过n8n MCP而非仅通过n8n UI来创建或编辑工作流的指导。

---

工具类别

n8n-mcp提供按类别组织的工具：

1. 节点发现 → SEARCH_GUIDE.md
2. 配置验证 → VALIDATION_GUIDE.md
3. 工作流管理 → WORKFLOW_GUIDE.md
4. 模板库 - 搜索和部署2,700+个真实工作流
5. 文档和指南 - 工具文档、AI代理指南、代码节点指南

---

快速参考

最常用工具（按成功率）

| 工具 | 使用场景 | 速度 | |------|----------|-------| | search_nodes | 按关键词查找节点 | <20ms | | get_node | 了解节点操作（detail="standard"） | <10ms | | validate_node | 检查配置（mode="full"） | <100ms | | n8n_create_workflow | 创建工作流 | 100-500ms | | n8n_update_partial_workflow | 编辑工作流（最常用！） | 50-200ms | | validate_workflow | 检查完整工作流 | 100-500ms | | n8n_deploy_template | 将模板部署到n8n实例 | 200-500ms |

---

工具选择指南

查找正确的节点

工作流：

1. search_nodes({query: "keyword"})
2. get_node({nodeType: "nodes-base.name"})
3. [可选] get_node({nodeType: "nodes-base.name", mode: "docs"})

示例：

// 步骤1：搜索
search_nodes({query: "slack"})
// 返回：nodes-base.slack

// 步骤2：获取详情
get_node({nodeType: "nodes-base.slack"})
// 返回：操作、属性、示例（标准详情）

// 步骤3：获取可读文档
get_node({nodeType: "nodes-base.slack", mode: "docs"})
// 返回：markdown文档

常见模式：搜索 → get_node（平均18秒）

验证配置

工作流：

1. validate_node({nodeType, config: {}, mode: "minimal"}) - 检查必填字段
2. validate_node({nodeType, config, profile: "runtime"}) - 完整验证
3. [重复] 修复错误，再次验证

常见模式：验证 → 修复 → 验证（每个周期23秒思考，58秒修复）

管理工作流

工作流：

1. n8n_create_workflow({name, nodes, connections})
2. n8n_validate_workflow({id})
3. n8n_update_partial_workflow({id, operations: [...]})
4. n8n_validate_workflow({id}) 再次验证
5. n8n_update_partial_workflow({id, operations: [{type: "activateWorkflow"}]})

常见模式：迭代更新（编辑间平均56秒）

---

关键：nodeType格式

两种不同格式用于不同工具！

格式1：搜索/验证工具

// 使用短前缀
"nodes-base.slack"
"nodes-base.httpRequest"
"nodes-base.webhook"
"nodes-langchain.agent"

使用此格式的工具：

• search_nodes（返回此格式）
• get_node
• validate_node
• validate_workflow

格式2：工作流工具

// 使用完整前缀
"n8n-nodes-base.slack"
"n8n-nodes-base.httpRequest"
"n8n-nodes-base.webhook"
"@n8n/n8n-nodes-langchain.agent"

使用此格式的工具：

• n8n_create_workflow
• n8n_update_partial_workflow

转换

// search_nodes返回两种格式
{
  "nodeType": "nodes-base.slack",          // 用于搜索/验证工具
  "workflowNodeType": "n8n-nodes-base.slack"  // 用于工作流工具
}

---

常见错误

错误1：错误的nodeType格式

问题："Node not found"错误

// 错误
get_node({nodeType: "slack"})  // 缺少前缀
get_node({nodeType: "n8n-nodes-base.slack"})  // 错误前缀

// 正确
get_node({nodeType: "nodes-base.slack"})

错误2：默认使用detail="full"

问题：巨大的负载，更慢的响应，token浪费

// 错误 - 返回3-8K tokens，谨慎使用
get_node({nodeType: "nodes-base.slack", detail: "full"})

// 正确 - 返回1-2K tokens，覆盖95%的用例
get_node({nodeType: "nodes-base.slack"})  // detail="standard"是默认值
get_node({nodeType: "nodes-base.slack", detail: "standard"})

何时使用detail="full"：

• 调试复杂配置问题
• 需要包含所有嵌套选项的完整属性模式
• 探索高级功能

更好的替代方案：

1. get_node({detail: "standard"}) - 用于操作列表（默认）
2. get_node({mode: "docs"}) - 用于可读文档
3. get_node({mode: "search_properties", propertyQuery: "auth"}) - 用于特定属性