n8n MCP 工具专家指南：节点搜索、工作流管理与2700+模板部署

n8n-mcp-tools-expert by czlonkowski/n8n-skills

2,100 周安装量

3,800 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/czlonkowski/n8n-skills --skill n8n-mcp-tools-expert

AI/机器学习开发生产力

🇨🇳中文介绍

n8n MCP 工具专家

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

工具类别

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

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

快速参考

最常用工具（按成功率排序）

工具	使用场景	速度
`search_nodes`	通过关键词查找节点	<20ms

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

733,500 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

252,100 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

202,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

133,200 周安装

// 步骤 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 文档

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

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

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

minimal - 仅必填字段 (快速，宽松)
runtime - 值 + 类型 (部署前推荐)
ai-friendly - 减少误报 (用于 AI 配置)
strict - 最大程度验证 (用于生产)

// 错误 - 使用默认配置文件 validate_node({nodeType, config})

// 正确 - 明确指定配置文件 validate_node({nodeType, config, profile: "runtime"})

// IF 节点 - 语义分支名称
{
  type: "addConnection",
  source: "IF",
  target: "True Handler",
  branch: "true"  // 清晰易读！
}

{
  type: "addConnection",
  source: "IF",
  target: "False Handler",
  branch: "false"
}

// Switch 节点 - 语义 case 编号
{
  type: "addConnection",
  source: "Switch",
  target: "Handler A",
  case: 0
}

// 错误 - 响应没有上下文
n8n_update_partial_workflow({
  id: "abc",
  operations: [{type: "addNode", node: {...}}]
})

// 正确 - 更好的 AI 响应
n8n_update_partial_workflow({
  id: "abc",
  intent: "为 API 失败添加错误处理",
  operations: [{type: "addNode", node: {...}}]
})

// 步骤 1: 搜索 (快!)
const results = await search_nodes({
  query: "slack",
  mode: "OR",  // 默认: 任何单词匹配
  limit: 20
});
// → 返回: nodes-base.slack, nodes-base.slackTrigger

// 步骤 2: 获取详情 (~18 秒后，用户查看结果)
const details = await get_node({
  nodeType: "nodes-base.slack",
  includeExamples: true  // 获取真实模板配置
});
// → 返回: 操作、属性、元数据

// 步骤 1: 验证
const result = await validate_node({
  nodeType: "nodes-base.slack",
  config: {
    resource: "channel",
    operation: "create"
  },
  profile: "runtime"
});

// 步骤 2: 检查错误 (~23 秒思考)
if (!result.valid) {
  console.log(result.errors);  // "缺少必填字段: name"
}

// 步骤 3: 修复配置 (~58 秒修复)
config.name = "general";

// 步骤 4: 再次验证
await validate_node({...});  // 重复直到干净

// 迭代式工作流构建 (非一次性!)
// 编辑 1
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "添加 webhook 触发器",
  operations: [{type: "addNode", node: {...}}]
});

// ~56 秒后...

// 编辑 2
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "将 webhook 连接到处理器",
  operations: [{type: "addConnection", source: "...", target: "..."}]
});

// ~56 秒后...

// 编辑 3 (验证)
await n8n_validate_workflow({id: "workflow-id"});

// 准备好了？激活！
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "为生产激活工作流",
  operations: [{type: "activateWorkflow"}]
});

// 按关键词搜索 (默认模式)
search_templates({
  query: "webhook slack",
  limit: 20
});

// 按节点类型搜索
search_templates({
  searchMode: "by_nodes",
  nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"]
});

// 按任务类型搜索
search_templates({
  searchMode: "by_task",
  task: "webhook_processing"
});

// 按元数据搜索 (复杂度, 设置时间)
search_templates({
  searchMode: "by_metadata",
  complexity: "simple",
  maxSetupMinutes: 15
});

// 将模板部署到你的 n8n 实例
n8n_deploy_template({
  templateId: 2947,
  name: "My Weather to Slack",  // 自定义名称 (可选)
  autoFix: true,  // 自动修复常见问题 (默认)
  autoUpgradeVersions: true  // 升级节点版本 (默认)
});
// 返回: 工作流 ID, 所需凭据, 应用的修复

// 所有工具概览
tools_documentation()

// 特定工具详情
tools_documentation({
  topic: "search_nodes",
  depth: "full"
})

// 代码节点指南
tools_documentation({topic: "javascript_code_node_guide", depth: "full"})
tools_documentation({topic: "python_code_node_guide", depth: "full"})

info (默认) - 带有详情级别的节点模式
docs - 可读的 markdown 文档
search_properties - 查找特定属性 (与 propertyQuery 一起使用)
versions - 列出所有版本及其破坏性变更
compare - 比较两个版本
breaking - 仅显示破坏性变更
migrations - 显示可自动迁移的变更

// 标准 (推荐) get_node({nodeType: "nodes-base.httpRequest"})

// 获取文档 get_node({nodeType: "nodes-base.webhook", mode: "docs"})

// 搜索属性 get_node({nodeType: "nodes-base.httpRequest", mode: "search_properties", propertyQuery: "auth"})

// 检查版本 get_node({nodeType: "nodes-base.executeWorkflow", mode: "versions"})

minimal - 非常宽松
runtime - 标准 (默认，推荐)
ai-friendly - 为 AI 工作流平衡
strict - 最彻底 (生产环境)

// 使用 runtime 配置文件的完整验证 validate_node({nodeType: "nodes-base.slack", config: {...}, profile: "runtime"})

// 快速必填字段检查 validate_node({nodeType: "nodes-base.webhook", config: {}, mode: "minimal"})

工具	响应时间	负载大小
search_nodes	<20ms	小
get_node (standard)	<10ms	~1-2KB
get_node (full)	<100ms	3-8KB
validate_node (minimal)	<50ms	小
validate_node (full)	<100ms	中
validate_workflow	100-500ms	中
n8n_create_workflow	100-500ms	中
n8n_update_partial_workflow	50-200ms	小
n8n_deploy_template	200-500ms	中

在大多数情况下使用 get_node({detail: "standard"})
明确指定验证配置文件 (profile: "runtime")
使用智能参数 (branch, case) 以提高清晰度
在工作流更新中包含 intent 参数
遵循搜索 → get_node → 验证的工作流程
迭代工作流 (编辑之间平均 56 秒)
每次重大更改后都进行验证
使用 includeExamples: true 获取真实配置
使用 n8n_deploy_template 快速开始

除非必要，否则使用 detail: "full" (浪费 token)
忘记 nodeType 前缀 (nodes-base.*)
跳过验证配置文件
试图一次性构建工作流 (迭代!)
忽略自动清理行为
在搜索/验证工具中使用完整前缀 (n8n-nodes-base.*)
构建后忘记激活工作流

使用 get_node 并设置 detail: "standard" (默认) - 覆盖 95% 的使用场景
nodeType 格式不同: nodes-base.* (搜索/验证) 对比 n8n-nodes-base.* (工作流)
指定验证配置文件 (推荐 runtime)
使用智能参数 (branch="true", case=0)
在工作流更新中包含intent 参数
自动清理在更新期间在所有节点上运行
工作流可以通过 API 激活 (activateWorkflow 操作)
工作流是迭代式构建的 (编辑之间平均 56 秒)

🇺🇸English

n8n MCP Tools Expert

Master guide for using n8n-mcp MCP server tools to build workflows.

Tool Categories

n8n-mcp provides tools organized into categories:

Node Discovery → SEARCH_GUIDE.md
Configuration Validation → VALIDATION_GUIDE.md
Workflow Management → WORKFLOW_GUIDE.md
Template Library - Search and deploy 2,700+ real workflows
Documentation & Guides - Tool docs, AI agent guide, Code node guides

Quick Reference

Most Used Tools (by success rate)

Tool	Use When	Speed
`search_nodes`	Finding nodes by keyword	<20ms
`get_node`	Understanding node operations (detail="standard")	<10ms
`validate_node`	Checking configurations (mode="full")	<100ms
`n8n_create_workflow`	Creating workflows	100-500ms
`n8n_update_partial_workflow`	Editing workflows (MOST USED!)	50-200ms
`validate_workflow`	Checking complete workflow	100-500ms
`n8n_deploy_template`	Deploy template to n8n instance	200-500ms

Tool Selection Guide

Finding the Right Node

Workflow :

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

Example :

// Step 1: Search
search_nodes({query: "slack"})
// Returns: nodes-base.slack

// Step 2: Get details
get_node({nodeType: "nodes-base.slack"})
// Returns: operations, properties, examples (standard detail)

// Step 3: Get readable documentation
get_node({nodeType: "nodes-base.slack", mode: "docs"})
// Returns: markdown documentation

Common pattern : search → get_node (18s average)

Validating Configuration

Workflow :

1. validate_node({nodeType, config: {}, mode: "minimal"}) - Check required fields
2. validate_node({nodeType, config, profile: "runtime"}) - Full validation
3. [Repeat] Fix errors, validate again

Common pattern : validate → fix → validate (23s thinking, 58s fixing per cycle)

Managing Workflows

Workflow :

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

Common pattern : iterative updates (56s average between edits)

Critical: nodeType Formats

Two different formats for different tools!

Format 1: Search/Validate Tools

// Use SHORT prefix
"nodes-base.slack"
"nodes-base.httpRequest"
"nodes-base.webhook"
"nodes-langchain.agent"

Tools that use this :

search_nodes (returns this format)
get_node
validate_node
validate_workflow

Format 2: Workflow Tools

// Use FULL prefix
"n8n-nodes-base.slack"
"n8n-nodes-base.httpRequest"
"n8n-nodes-base.webhook"
"@n8n/n8n-nodes-langchain.agent"

Tools that use this :

n8n_create_workflow
n8n_update_partial_workflow

Conversion

// search_nodes returns BOTH formats
{
  "nodeType": "nodes-base.slack",          // For search/validate tools
  "workflowNodeType": "n8n-nodes-base.slack"  // For workflow tools
}

Common Mistakes

Mistake 1: Wrong nodeType Format

Problem : "Node not found" error

// WRONG
get_node({nodeType: "slack"})  // Missing prefix
get_node({nodeType: "n8n-nodes-base.slack"})  // Wrong prefix

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

Mistake 2: Using detail="full" by Default

Problem : Huge payload, slower response, token waste

// WRONG - Returns 3-8K tokens, use sparingly
get_node({nodeType: "nodes-base.slack", detail: "full"})

// CORRECT - Returns 1-2K tokens, covers 95% of use cases
get_node({nodeType: "nodes-base.slack"})  // detail="standard" is default
get_node({nodeType: "nodes-base.slack", detail: "standard"})

When to use detail="full" :

Debugging complex configuration issues
Need complete property schema with all nested options
Exploring advanced features

Better alternatives :

get_node({detail: "standard"}) - for operations list (default)
get_node({mode: "docs"}) - for readable documentation
get_node({mode: "search_properties", propertyQuery: "auth"}) - for specific property

Mistake 3: Not Using Validation Profiles

Problem : Too many false positives OR missing real errors

Profiles :

minimal - Only required fields (fast, permissive)
runtime - Values + types (recommended for pre-deployment)
ai-friendly - Reduce false positives (for AI configuration)
strict - Maximum validation (for production)

// WRONG - Uses default profile validate_node({nodeType, config})

// CORRECT - Explicit profile validate_node({nodeType, config, profile: "runtime"})

Mistake 4: Ignoring Auto-Sanitization

What happens : ALL nodes sanitized on ANY workflow update

Auto-fixes :

Binary operators (equals, contains) → removes singleValue
Unary operators (isEmpty, isNotEmpty) → adds singleValue: true
IF/Switch nodes → adds missing metadata

Cannot fix :

Broken connections
Branch count mismatches
Paradoxical corrupt states

// After ANY update, auto-sanitization runs on ALL nodes n8n_update_partial_workflow({id, operations: [...]}) // → Automatically fixes operator structures

Mistake 5: Not Using Smart Parameters

Problem : Complex sourceIndex calculations for multi-output nodes

Old way (manual):

// IF node connection
{
  type: "addConnection",
  source: "IF",
  target: "Handler",
  sourceIndex: 0  // Which output? Hard to remember!
}

New way (smart parameters):

// IF node - semantic branch names
{
  type: "addConnection",
  source: "IF",
  target: "True Handler",
  branch: "true"  // Clear and readable!
}

{
  type: "addConnection",
  source: "IF",
  target: "False Handler",
  branch: "false"
}

// Switch node - semantic case numbers
{
  type: "addConnection",
  source: "Switch",
  target: "Handler A",
  case: 0
}

Mistake 6: Not Using intent Parameter

Problem : Less helpful tool responses

// WRONG - No context for response
n8n_update_partial_workflow({
  id: "abc",
  operations: [{type: "addNode", node: {...}}]
})

// CORRECT - Better AI responses
n8n_update_partial_workflow({
  id: "abc",
  intent: "Add error handling for API failures",
  operations: [{type: "addNode", node: {...}}]
})

Tool Usage Patterns

Pattern 1: Node Discovery (Most Common)

Common workflow : 18s average between steps

// Step 1: Search (fast!)
const results = await search_nodes({
  query: "slack",
  mode: "OR",  // Default: any word matches
  limit: 20
});
// → Returns: nodes-base.slack, nodes-base.slackTrigger

// Step 2: Get details (~18s later, user reviewing results)
const details = await get_node({
  nodeType: "nodes-base.slack",
  includeExamples: true  // Get real template configs
});
// → Returns: operations, properties, metadata

Pattern 2: Validation Loop

Typical cycle : 23s thinking, 58s fixing

// Step 1: Validate
const result = await validate_node({
  nodeType: "nodes-base.slack",
  config: {
    resource: "channel",
    operation: "create"
  },
  profile: "runtime"
});

// Step 2: Check errors (~23s thinking)
if (!result.valid) {
  console.log(result.errors);  // "Missing required field: name"
}

// Step 3: Fix config (~58s fixing)
config.name = "general";

// Step 4: Validate again
await validate_node({...});  // Repeat until clean

Pattern 3: Workflow Editing

Most used update tool : 99.0% success rate, 56s average between edits

// Iterative workflow building (NOT one-shot!)
// Edit 1
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Add webhook trigger",
  operations: [{type: "addNode", node: {...}}]
});

// ~56s later...

// Edit 2
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Connect webhook to processor",
  operations: [{type: "addConnection", source: "...", target: "..."}]
});

// ~56s later...

// Edit 3 (validation)
await n8n_validate_workflow({id: "workflow-id"});

// Ready? Activate!
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Activate workflow for production",
  operations: [{type: "activateWorkflow"}]
});

Detailed Guides

Node Discovery Tools

See SEARCH_GUIDE.md for:

search_nodes
get_node with detail levels (minimal, standard, full)
get_node modes (info, docs, search_properties, versions)

Validation Tools

See VALIDATION_GUIDE.md for:

Validation profiles explained
validate_node with modes (minimal, full)
validate_workflow complete structure
Auto-sanitization system
Handling validation errors

Workflow Management

See WORKFLOW_GUIDE.md for:

n8n_create_workflow
n8n_update_partial_workflow (17 operation types!)
Smart parameters (branch, case)
AI connection types (8 types)
Workflow activation (activateWorkflow/deactivateWorkflow)
n8n_deploy_template
n8n_workflow_versions

Template Usage

Search Templates

// Search by keyword (default mode)
search_templates({
  query: "webhook slack",
  limit: 20
});

// Search by node types
search_templates({
  searchMode: "by_nodes",
  nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"]
});

// Search by task type
search_templates({
  searchMode: "by_task",
  task: "webhook_processing"
});

// Search by metadata (complexity, setup time)
search_templates({
  searchMode: "by_metadata",
  complexity: "simple",
  maxSetupMinutes: 15
});

Get Template Details

get_template({
  templateId: 2947,
  mode: "structure"  // nodes+connections only
});

get_template({
  templateId: 2947,
  mode: "full"  // complete workflow JSON
});

Deploy Template Directly

// Deploy template to your n8n instance
n8n_deploy_template({
  templateId: 2947,
  name: "My Weather to Slack",  // Custom name (optional)
  autoFix: true,  // Auto-fix common issues (default)
  autoUpgradeVersions: true  // Upgrade node versions (default)
});
// Returns: workflow ID, required credentials, fixes applied

Self-Help Tools

Get Tool Documentation

// Overview of all tools
tools_documentation()

// Specific tool details
tools_documentation({
  topic: "search_nodes",
  depth: "full"
})

// Code node guides
tools_documentation({topic: "javascript_code_node_guide", depth: "full"})
tools_documentation({topic: "python_code_node_guide", depth: "full"})

AI Agent Guide

// Comprehensive AI workflow guide
ai_agents_guide()
// Returns: Architecture, connections, tools, validation, best practices

Health Check

// Quick health check
n8n_health_check()

// Detailed diagnostics
n8n_health_check({mode: "diagnostic"})
// → Returns: status, env vars, tool status, API connectivity

Tool Availability

Always Available (no n8n API needed):

search_nodes, get_node
validate_node, validate_workflow
search_templates, get_template
tools_documentation, ai_agents_guide

Requires n8n API (N8N_API_URL + N8N_API_KEY):

n8n_create_workflow
n8n_update_partial_workflow
n8n_validate_workflow (by ID)
n8n_list_workflows, n8n_get_workflow
n8n_test_workflow
n8n_executions
n8n_deploy_template
n8n_workflow_versions
n8n_autofix_workflow

If API tools unavailable, use templates and validation-only workflows.

Unified Tool Reference

get_node (Unified Node Information)

Detail Levels (mode="info", default):

minimal (~200 tokens) - Basic metadata only
standard (~1-2K tokens) - Essential properties + operations (RECOMMENDED)
full (~3-8K tokens) - Complete schema (use sparingly)

Operation Modes :

info (default) - Node schema with detail level
docs - Readable markdown documentation
search_properties - Find specific properties (use with propertyQuery)
versions - List all versions with breaking changes
compare - Compare two versions
breaking - Show only breaking changes
migrations - Show auto-migratable changes

// Standard (recommended) get_node({nodeType: "nodes-base.httpRequest"})

// Get documentation get_node({nodeType: "nodes-base.webhook", mode: "docs"})

// Search for properties get_node({nodeType: "nodes-base.httpRequest", mode: "search_properties", propertyQuery: "auth"})

validate_node (Unified Validation)

Modes :

full (default) - Comprehensive validation with errors/warnings/suggestions
minimal - Quick required fields check only

Profiles (for mode="full"):

minimal - Very lenient
runtime - Standard (default, recommended)
ai-friendly - Balanced for AI workflows
strict - Most thorough (production)

// Full validation with runtime profile validate_node({nodeType: "nodes-base.slack", config: {...}, profile: "runtime"})

// Quick required fields check validate_node({nodeType: "nodes-base.webhook", config: {}, mode: "minimal"})

Performance Characteristics

Tool	Response Time	Payload Size
search_nodes	<20ms	Small
get_node (standard)	<10ms	~1-2KB
get_node (full)	<100ms	3-8KB
validate_node (minimal)	<50ms	Small
validate_node (full)	<100ms	Medium
validate_workflow	100-500ms	Medium
n8n_create_workflow	100-500ms	Medium
n8n_update_partial_workflow	50-200ms	Small
n8n_deploy_template	200-500ms	Medium

Best Practices

Do

Use get_node({detail: "standard"}) for most use cases
Specify validation profile explicitly (profile: "runtime")
Use smart parameters (branch, case) for clarity
Include intent parameter in workflow updates
Follow search → get_node → validate workflow
Iterate workflows (avg 56s between edits)
Validate after every significant change
Use includeExamples: true for real configs
Use n8n_deploy_template for quick starts

Don't

Use detail: "full" unless necessary (wastes tokens)
Forget nodeType prefix (nodes-base.*)
Skip validation profiles
Try to build workflows in one shot (iterate!)
Ignore auto-sanitization behavior
Use full prefix (n8n-nodes-base.*) with search/validate tools
Forget to activate workflows after building

Summary

Most Important :

Use get_node with detail: "standard" (default) - covers 95% of use cases
nodeType formats differ: nodes-base.* (search/validate) vs n8n-nodes-base.* (workflows)
Specify validation profiles (runtime recommended)
Use smart parameters (branch="true", case=0)
Include intent parameter in workflow updates
Auto-sanitization runs on ALL nodes during updates
Workflows can be activated via API (activateWorkflow operation)
Workflows are built iteratively (56s avg between edits)

Common Workflow :

search_nodes → find node
get_node → understand config
validate_node → check config
n8n_create_workflow → build
n8n_validate_workflow → verify
n8n_update_partial_workflow → iterate
activateWorkflow → go live!

For details, see:

SEARCH_GUIDE.md - Node discovery
VALIDATION_GUIDE.md - Configuration validation
WORKFLOW_GUIDE.md - Workflow management

Related Skills :

n8n Expression Syntax - Write expressions in workflow fields
n8n Workflow Patterns - Architectural patterns from templates
n8n Validation Expert - Interpret validation errors
n8n Node Configuration - Operation-specific requirements
n8n Code JavaScript - Write JavaScript in Code nodes
n8n Code Python - Write Python in Code nodes

Weekly Installs

1.3K

Repository

czlonkowski/n8n-skills

GitHub Stars

3.3K

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykWarn

Installed on

opencode1.1K

gemini-cli1.1K

codex1.1K

github-copilot972

cursor860

kimi-cli843

n8n MCP 工具专家指南：节点搜索、工作流管理与2700+模板部署

🇨🇳中文介绍

n8n MCP 工具专家

工具类别

快速参考

最常用工具（按成功率排序）

相关 Skills

工具选择指南

找到正确的节点

验证配置

管理工作流

关键：nodeType 格式

格式 1：搜索/验证工具

格式 2：工作流工具

转换

常见错误

错误 1：错误的 nodeType 格式

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

错误 3：不使用验证配置文件

错误 4：忽略自动清理

错误 5：不使用智能参数

错误 6：不使用 intent 参数

工具使用模式

模式 1：节点发现 (最常见)

模式 2：验证循环

模式 3：工作流编辑

详细指南

节点发现工具

验证工具

工作流管理

模板使用

搜索模板

获取模板详情

直接部署模板

自助工具

获取工具文档

AI 代理指南

健康检查

工具可用性

统一工具参考

get_node (统一节点信息)

validate_node (统一验证)

性能特征

最佳实践

应该做

不要做

总结

🇺🇸English

n8n MCP Tools Expert

Tool Categories

Quick Reference

Most Used Tools (by success rate)

Tool Selection Guide

Finding the Right Node

Validating Configuration

Managing Workflows

Critical: nodeType Formats

Format 1: Search/Validate Tools

Format 2: Workflow Tools

Conversion

Common Mistakes

Mistake 1: Wrong nodeType Format

Mistake 2: Using detail="full" by Default

Mistake 3: Not Using Validation Profiles

Mistake 4: Ignoring Auto-Sanitization

Mistake 5: Not Using Smart Parameters

Mistake 6: Not Using intent Parameter

Tool Usage Patterns

Pattern 1: Node Discovery (Most Common)

Pattern 2: Validation Loop

Pattern 3: Workflow Editing

Detailed Guides

Node Discovery Tools

Validation Tools

Workflow Management

Template Usage

Search Templates

Get Template Details

Deploy Template Directly

Self-Help Tools