n8n 是什么#

开源的工作流自动化平台，定位类似 Zapier 或 Make，但可以自托管、免费使用，支持超过 400 个服务的集成。它的核心逻辑就是把”触发器 + 一系列操作”串成一条流程，然后自动跑。

MCP 是什么#

Model Context Protocol，Anthropic 推出的一套开放协议。简单说就是给 AI 模型定义了一种标准方式去连接外部工具——工具方实现一个 MCP server，Claude 这边就能发现并调用它，就像给 Claude 装插件一样。

n8n-MCP 是什么#

社区开发者 czlonkowski 做的开源项目，本质上是一个 MCP server，专门面向 n8n。接入之后，Claude 就能理解 n8n 的节点体系、搜索文档、校验配置，最后把生成好的 workflow 直接推进你的 n8n 实例。截至 2026 年 5 月，这个项目在 GitHub 上已经超过 2 万 star。

需要准备什么#

• 一个运行中的 n8n 实例（本地或云端都行）
• n8n 的 API Key：Settings → API → Create API Key
• Claude Desktop 或 Claude Code（二选一）

配置 Claude Desktop#

找到配置文件：

1
Windows：%APPDATA%\Claude\claude_desktop_config.json
2
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

在 mcpServers 字段里加入以下内容：

1
{
2
  "mcpServers": {
3
    "n8n-mcp": {
4
      "command": "npx",
5
      "args": ["n8n-mcp"],
6
      "env": {
7
        "MCP_MODE": "stdio",
8
        "LOG_LEVEL": "error",
9
        "DISABLE_CONSOLE_OUTPUT": "true",
10
        "N8N_API_URL": "http://localhost:5678",
11
        "N8N_API_KEY": "你的 API Key"
12
      }
13
    }
14
  }
15
}

保存后完全退出 Claude Desktop，重新启动。如果配置正确，Claude 的工具列表里会出现 search_nodes、validate_workflow 等 n8n 相关工具。

配置 Claude Code#

用 PowerShell 运行（反引号是换行符）：

1
claude mcp add n8n-mcp `
2
  '-e MCP_MODE=stdio' `
3
  '-e LOG_LEVEL=error' `
4
  '-e DISABLE_CONSOLE_OUTPUT=true' `
5
  '-e N8N_API_URL=http://localhost:5678' `
6
  '-e N8N_API_KEY=你的API Key' `
7
  -- npx n8n-mcp

启动 Claude Code 后运行 /mcp，看到 n8n-MCP 出现在列表里就说明连接成功了。

实际用起来#

连上之后，你可以直接对 Claude 说：

帮我建一个 n8n 流程：每天早上 9 点抓取指定 RSS 源，过滤包含”AI”关键词的条目，发送到我的 Gmail。

Claude 会搜索对应节点、组装 workflow JSON、验证配置，然后通过 API 推送到你的 n8n 实例。你去 n8n 里确认一遍，填上自己的账号凭据，激活就行。

生成的流程通常是草稿状态，凭据部分必须自己填，激活前一定检查一遍——这一步不能跳过。

在 n8n 里操作#

1. 新建或打开一个流程
2. 添加 MCP Server Trigger 节点作为触发器
3. 在它后面挂上你要暴露的工具节点（HTTP Request、Gmail、Slack 等都行）
4. 配置认证方式，建议选 Bearer Token
5. 激活流程，复制生成的 MCP Production URL

URL 格式大概是：

1
http://localhost:5678/mcp/xxxxxxxx

在 Claude Desktop 里引用#

1
{
2
  "mcpServers": {
3
    "n8n": {
4
      "command": "npx",
5
      "args": [
6
        "mcp-remote",
7
        "http://localhost:5678/mcp/xxxxxxxx",
8
        "--header",
9
        "Authorization: Bearer 你的Token"
10
      ]
11
    }
12
  }
13
}

配置好之后，Claude 就能直接调用你在这条流程里挂载的工具，不需要你手动去 n8n 界面触发。