/ 目錄 / 演練場 / mcp-n8n-workflow-builder
● 社群 salacoste ⚡ 即開即用

mcp-n8n-workflow-builder

作者 salacoste · salacoste/mcp-n8n-workflow-builder

用自然語言建立、管理和監控 n8n 工作流程——無需編輯 JSON,支援多實例 prod/staging/dev 環境。

salacoste 開發的 mcp-n8n-workflow-builder 透過 17 個 MCP 工具公開 n8n 的 REST API,涵蓋工作流程、執行記錄、標籤與憑證管理。多實例設定讓單一代理可在 prod/staging/dev 之間切換,非常適合以對話方式迭代自動化流程。

為什麼要用

核心特性

即時演示

實際使用效果

n8n-workflow-builder-2.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "n8n-workflow-builder-2": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "n8n-workflow-builder-2": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "n8n-workflow-builder-2": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "n8n-workflow-builder-2": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "n8n-workflow-builder-2",
      "command": "npx",
      "args": [
        "-y",
        "mcp-n8n-workflow-builder"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "n8n-workflow-builder-2": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-n8n-workflow-builder"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add n8n-workflow-builder-2 -- npx -y mcp-n8n-workflow-builder

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: mcp-n8n-workflow-builder

根據文字描述建立 n8n 工作流程

👤 營運與整合相關人員 ⏱ ~15 min intermediate

何時使用: 你想實現「在 Airtable 新增一列時發送 Slack 訊息」,但不想點選 15 個節點。

前置條件
  • n8n 實例已啟動且已啟用 API — 標準 n8n 安裝方式;從「設定 > API」取得 API 金鑰
  • 設定環境變數 N8N_HOST + N8N_API_KEY(不含 /api/v1 後綴) — 在 MCP 設定中配置
步驟
  1. 描述需求
    建立一個名為 'airtable-to-slack' 的工作流程:在 Airtable 資料庫 X 的資料表 Y 新增一列時觸發,並將該列的 Name 和 Status 欄位發佈到 Slack 頻道 #updates。✓ 已複製
    → 工作流程已建立並回傳 URL
  2. 確認節點
    用 get_workflow 根據 id 查詢,並告訴我節點的執行順序。✓ 已複製
    → 節點鏈與需求一致
  3. 啟用
    啟用此工作流程。✓ 已複製
    → 狀態:active

結果: 幾分鐘內完成可運作的工作流程,不再需要在 n8n UI 中反覆切換分頁。

注意事項
  • 憑證建立在錯誤的實例上 — 使用多實例設定時,在提示詞中加入環境名稱(例如「在 staging 實例上...」)
  • 自動產生的節點參數可能遺漏某些邊界情況欄位 — 建立後做一次手動節點審查;n8n 對操作參數的要求較嚴格
搭配使用: airtable · github

除錯失敗的 n8n 執行記錄

👤 在正式環境執行 n8n 的所有人 ⏱ ~15 min intermediate

何時使用: 工作流程在凌晨三點失敗,你想知道發生了什麼事。

步驟
  1. 找出最近的失敗記錄
    列出 prod 環境過去 24 小時內 status=error 的 list_executions。✓ 已複製
    → 失敗清單
  2. 檢查其中一筆
    對最近一筆執行記錄使用 get_execution——哪個節點失敗了,錯誤訊息是什麼?✓ 已複製
    → 節點名稱 + 錯誤堆疊追蹤
  3. 重試或修復
    若為暫時性錯誤,執行 retry_execution。若為程式碼問題,請提出工作流程 JSON 中的節點修改建議。✓ 已複製
    → 已採取對應行動

結果: 找出根本原因,並提出恢復方案或修補程式建議。

搭配使用: sentry

批次為工作流程加上標籤並稽核憑證

👤 平台管理員 ⏱ ~30 min intermediate

何時使用: 你接手了一個 n8n 實例,需要對它進行整理。

步驟
  1. 列出並分類工作流程
    執行 list_workflows——將每個工作流程分類為 {marketing, internal, ops, dead}。✓ 已複製
    → 分類結果
  2. 套用標籤
    根據分類結果,使用 create_tag 加上標籤並更新工作流程。✓ 已複製
    → 標籤已套用
  3. 稽核憑證
    執行 list_credentials——標記任何跨環境共用或超過 90 天未使用的憑證。✓ 已複製
    → 待清理清單

結果: 讓 n8n 環境更整潔、更易於稽核。

組合

與其他 MCP 搭配,撬動十倍槓桿

n8n-workflow-builder-2 + airtable

設計並部署 Airtable→Slack 自動化流程

設計一個 n8n 工作流程,當 Airtable CRM 中新增 Deal 時發佈 Slack 通知,並包含錯誤處理機制。✓ 已複製
n8n-workflow-builder-2 + sentry

在 Sentry 中追蹤 n8n 錯誤

當工作流程執行失敗時,將工作流程名稱與節點資料發佈到 Sentry。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_workflows filter?: object 取得工作流程總覽 1 API call
get_workflow id: str 檢視節點圖結構 1 API call
create_workflow name, nodes, connections, active? 建立新的工作流程 1 API call (write)
update_workflow id, nodes?, connections?, name? 編輯現有工作流程 1 API call (write)
delete_workflow id 需確認後再執行 1 API call (destructive)
activate_workflow id 正式上線啟用 1 API call
deactivate_workflow id 暫停但不刪除 1 API call
execute_workflow id, data? 手動觸發執行 1 API call
list_executions filter? 監控執行狀況 1 API call
get_execution id 執行後的事後分析 1 API call
retry_execution id 暫時性失敗後的恢復 1 API call
create_credential name, type, data 為節點建立驗證憑證 1 API call (write)

成本與限制

運行它的成本

API 配額
取決於 n8n 實例的限制(自架版本無上限)
每次呼叫 Token 數
複雜的工作流程 JSON 可能達到 5,000 至 20,000 個 token
費用
免費(n8n 社群版)或付費(n8n Cloud)
提示
除非需要編輯,否則請要求摘要(節點 + 觸發器),而非完整 JSON 輸出。

安全

權限、密鑰、影響範圍

憑證儲存: N8N_API_KEY 存放於環境變數;多實例金鑰存放於 .config.json(已加入 gitignore)
資料出站: 所有資料傳輸至你的 n8n 實例
切勿授予: Include N8N_HOST with /api/v1 suffix — cut the suffix or tool calls fail Share API key across dev/prod without tagging

故障排查

常見錯誤與修復

401 from n8n

API 金鑰無效或已過期;請至「設定 > API」重新產生。

驗證: curl -H 'X-N8N-API-KEY: $KEY' $N8N_HOST/api/v1/workflows
404 on create_workflow

N8N_HOST 包含了 /api/v1 後綴;請將其移除。

驗證: Check config
Created workflow fails to activate

節點缺少憑證。請先建立憑證,再於工作流程中以 id 引用。

驗證: get_workflow and look for null credential refs

替代方案

mcp-n8n-workflow-builder 對比其他方案

替代方案何時用它替代權衡
Zapier MCP你使用的是 Zapier 而非 n8n生態系不同;n8n 可自架,Zapier 則無法
Native n8n AI nodes你想在工作流程內部使用 AI,而非從外部控制無法透過外部對話介面操控

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills