n8n-mcp MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

500+ 个 n8n 节点的全文搜索，包含 schema
工作流 JSON 验证器——在部署前捕获错误配置
模板库 + 可获取的 JSON 作为起点
可选：在真实 n8n 实例上管理工作流（创建、更新、触发、审计）

实时演示

实际使用效果

n8n-mcp.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "n8n-mcp",
      "command": "npx",
      "args": [
        "-y",
        "n8n-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "n8n-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "n8n-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add n8n-mcp -- npx -y n8n-mcp

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： n8n-mcp

从纯英文描述构建 n8n 工作流

👤 使用 n8n 的运维工程师、独立开发者 ⏱ ~20 min intermediate

何时使用： 你知道自己想要什么（'每个新 Typeform 都发送到 Notion + Slack'），但不想花 20 分钟在 n8n UI 里点来点去。

前置条件

n8n 实例（云端或自托管） — 任何可用的 n8n；仅在部署步骤需要，不需要在设计时使用
N8N_API_URL + N8N_API_KEY — n8n Settings → n8n API → 创建 API key

步骤

搜索每个步骤的节点

我想要：Typeform webhook → 解析 → 创建 Notion 页面 → 发送到 Slack。搜索我需要的确切节点类型。✓ 已复制

→ 识别节点名称 + 所需凭据
生成工作流 JSON

用这 4 个节点生成完整工作流并按顺序连接。如果有匹配的模板可用，以模板为基础。✓ 已复制

→ 有效的 n8n 工作流 JSON
验证和部署

用 validate_workflow 验证 JSON。修复任何错误。然后以草稿形式（未激活）部署到我的 n8n。✓ 已复制

→ 工作流在 n8n UI 中以草稿状态显示

结果： 一个可工作的 n8n 工作流，比手动点击快 10 倍，验证在你点击运行前就能捕获错误配置。

注意事项

凭据必须先在 n8n 中设置——JSON 通过 ID 引用它们 — 在部署前在 n8n UI 中创建凭据条目；将凭据 ID 传给 agent
Agent 以激活状态部署，立即处理历史数据 — 始终以非激活状态部署；在 n8n UI 中测试后手动激活

审计 n8n 实例中损坏或危险的工作流

👤 继承 n8n 实例的运维负责人 ⏱ ~30 min intermediate

何时使用： 你接手了一个有 50 个工作流、没有文档的 n8n 实例。你需要知道里面有什么以及什么是有风险的。

步骤

列出所有工作流

列出每个工作流的名称、激活状态、最后执行时间和节点数。✓ 已复制

→ 完整清单
标记风险模式

查找具有以下特征的工作流：没有错误处理、没有身份验证的 webhook 触发器、指向随机 URL 的 HTTP Request 节点或 shell 命令节点。✓ 已复制

→ 带有理由的风险列表
检查失败率

对于每个激活的工作流，获取最后 20 次执行。计算失败率。标记任何超过 20% 的。✓ 已复制

→ 损坏工作流列表

结果： 风险 + 健康状况清单——知道需要修复、冻结或删除什么。

注意事项

禁用其他工作流依赖的工作流（通过 Execute Workflow 节点） — 禁用前，搜索其他工作流中对目标的 ID 引用

从模板开始并自定义

👤 n8n 新用户 ⏱ ~15 min beginner

何时使用： 可能已经有人构建了接近你需求的东西——以此作为起点。

步骤

搜索模板

查找执行以下操作的模板：'同步 CSV 到数据库并去重'。✓ 已复制

→ 按相关性排序的 3-5 个候选模板
获取和改编

获取最佳匹配的 JSON。调整节点以使用我的实际数据库（host X 上的 Postgres）和 CSV 源（S3 bucket Y）。✓ 已复制

→ 自定义工作流 JSON
验证和部署

验证，然后以草稿形式部署到我的 n8n。✓ 已复制

→ n8n 中的草稿工作流

结果： 10 分钟内通过站在别人的肩膀上获得一个可工作的工作流。

注意事项

模板使用已弃用的节点版本 — 检查 validate_workflow 输出的版本警告；替换为当前节点

组合

与其他 MCP 搭配，撬动十倍杠杆

n8n-mcp + notion

搭建一个向特定 Notion 数据库写入的 n8n 工作流——先查找数据库 schema

查找我 Notion 的 'Leads' 数据库 schema。然后构建一个接收 webhook 输入并创建匹配条目的 n8n 工作流。✓ 已复制

n8n-mcp + linear

为 n8n 工作流失败自动创建 Linear 工单

审计我的 n8n，查找失败超过 20% 次运行的工作流。为每个创建一个 Linear bug。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
tools_documentation	tool_name?	发现可用工具	free
search_nodes	query, limit?	查找哪些 n8n 节点满足需求	free
get_node	node_type, mode?	在连接前深入了解特定节点	free
validate_node	node JSON	检查单个节点配置	free
validate_workflow	workflow JSON	始终——在任何部署前	free
search_templates	query/keywords/nodes	构建前查找现有方案	free
get_template	template_id	获取选定的模板	free
create_workflow / update_workflow / delete_workflow	requires N8N_API_URL/KEY	在真实实例上部署或修改	1 n8n API call
trigger_workflow / get_executions	workflow_id, data?	测试已部署的工作流	1 n8n API call
audit_instance		定期实例审查	multiple API calls

成本与限制

运行它的成本

API 配额: 搜索/验证工具：无限制（本地数据）。管理工具：受 n8n 实例容量限制。
每次调用 Token 数: 节点 schema 可能很大（2-5k 个 token）；当你只需要类型时用 get_node 的 mode='minimal'
费用: 免费 MCP；n8n 有云服务层（$20+/月）或免费自托管
提示: 先用搜索/验证充分设计（免费）。只有确定后才调用创建/更新——n8n 云上的每次部署都会消耗配额

安全

权限、密钥、影响范围

凭据存储： N8N_API_KEY 在环境变量中——将其视为管理员 token，因为它可以创建工作流

数据出站： n8n-mcp MCP 本身在本地运行。管理工具调用你的 N8N_API_URL。

故障排查

常见错误与修复

管理工具没有出现

N8N_API_URL 或 N8N_API_KEY 未设置。管理工具只在启动时两个环境变量都存在时才会注册。

验证： echo $N8N_API_URL && echo $N8N_API_KEY | cut -c1-6

validate_workflow 通过但 n8n 在部署时拒绝

可能是凭据引用问题。凭据根据 n8n 实例中的名称进行验证——验证凭据名称完全匹配。

工作流部署但首次运行时失败，显示 'Node type not found'

你使用的是 n8n 实例上未安装的社区包中的节点。先在 n8n 中安装或换成核心节点。

模板 JSON 使用已弃用的节点版本

获取后通过 validate_workflow 验证——它会标记已弃用的版本。部署前升级节点。

替代方案

n8n-mcp 对比其他方案

替代方案	何时用它替代	权衡
Zapier MCP	你的团队使用 Zapier 而不是 n8n	仅限托管；控制力较低但集成更完善
Make (Integromat) MCP	你的团队使用 Make	托管；场景模型不同于 n8n 的图形模型
Raw n8n REST API	你想从自定义脚本获得代码级控制	没有节点目录或验证——正确性完全由你负责

n8n-mcp

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： n8n-mcp

从纯英文描述构建 n8n 工作流

前置条件

步骤

注意事项

审计 n8n 实例中损坏或危险的工作流

步骤

注意事项

从模板开始并自定义

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

n8n-mcp 对比其他方案

更多

资源