n8n-mcp MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

全文搜尋 500+ 個 n8n 節點及其結構定義
工作流程 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 通知」），但不想在 n8n UI 上點選 20 分鐘。

前置條件

n8n 實例（雲端或自架） — 任何可正常運作的 n8n；僅部署步驟需要，設計階段不需要
N8N_API_URL + N8N_API_KEY — n8n 設定 → n8n API → 建立 API 金鑰

步驟

搜尋每個步驟所需的節點

我想要：Typeform webhook → 解析 → 建立 Notion 頁面 → 發送至 Slack。搜尋我所需的確切節點類型。✓ 已複製

→ 識別出節點名稱與所需憑證
產生工作流程 JSON

用這 4 個節點按順序連接，產生完整的工作流程 JSON。如果有符合的範本，以範本為基礎。✓ 已複製

→ 有效的 n8n 工作流程 JSON
驗證並部署

用 validate_workflow 驗證 JSON，修正所有錯誤，然後以草稿狀態（非啟用）部署至我的 n8n。✓ 已複製

→ 工作流程以草稿狀態出現在 n8n UI 中

結果： 快手動點選 10 倍建立一個可運作的 n8n 工作流程，且驗證器會在執行前攔截錯誤設定。

注意事項

憑證必須先在 n8n 中設定好——JSON 透過 ID 參照憑證 — 部署前先在 n8n UI 建立憑證項目；再將憑證 ID 提供給 agent
agent 將工作流程部署為啟用狀態，立即對歷史資料觸發執行 — 一律部署為未啟用；在 n8n UI 測試後再手動啟用

稽核 n8n 實例，找出有問題或有風險的工作流程

👤 接手 n8n 實例的維運負責人 ⏱ ~30 min intermediate

何時使用： 你接手了一個有 50 個工作流程、沒有任何文件的 n8n 實例，需要了解現況與潛在風險。

步驟

列出所有工作流程

列出每個工作流程的名稱、啟用狀態、最後執行時間與節點數量。✓ 已複製

→ 完整的工作流程清單
標記高風險模式

找出以下工作流程：沒有錯誤處理、webhook 觸發但無驗證、HTTP Request 節點連到不明 URL、或包含 shell 指令節點。✓ 已複製

→ 附有說明的風險清單
檢查失敗率

對每個啟用中的工作流程，取得最近 20 次執行記錄，計算失敗率，標記失敗率超過 20% 的工作流程。✓ 已複製

→ 有問題的工作流程清單

結果： 取得風險與健康狀態清單——清楚知道哪些需要修復、凍結或刪除。

注意事項

停用了其他工作流程所依賴的工作流程（透過 Execute Workflow 節點） — 停用前，先在其他工作流程中搜尋是否有參照該目標 ID 的節點

從範本開始並加以客製化

👤 n8n 新手使用者 ⏱ ~15 min beginner

何時使用： 很可能已有人建立了與你需求相近的工作流程——以此為起點會更有效率。

步驟

搜尋範本

找出能做到「將 CSV 同步至資料庫並去除重複資料」的範本。✓ 已複製

→ 3-5 個依相關性排序的候選範本
擷取並調整

取得最符合的範本 JSON，將節點調整為使用我的實際資料庫（Postgres，主機為 X）及我的 CSV 來源（S3 儲存桶 Y）。✓ 已複製

→ 客製化後的工作流程 JSON
驗證並部署

驗證後，以草稿狀態部署至我的 n8n。✓ 已複製

→ n8n 中出現草稿工作流程

結果： 站在前人的肩膀上，10 分鐘內完成一個可運作的工作流程。

注意事項

範本使用了已棄用的節點版本 — 檢查 validate_workflow 的輸出是否有版本警告；替換為目前的節點版本

組合

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

n8n-mcp + notion

建立一個將資料寫入特定 Notion 資料庫的 n8n 工作流程——先查詢資料庫的結構定義

查詢我 Notion 的「Leads」資料庫結構。然後建立一個 n8n 工作流程，接收 webhook 輸入並建立對應的資料庫項目。✓ 已複製

n8n-mcp + linear

為 n8n 工作流程失敗事件自動建立 Linear 工單

稽核我的 n8n，找出失敗率超過 20% 的工作流程，針對每個建立一個 Linear 錯誤工單。✓ 已複製

工具

此 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	在真實 n8n 實例上部署或修改工作流程	1 n8n API call
trigger_workflow / get_executions	workflow_id, data?	測試已部署的工作流程	1 n8n API call
audit_instance		定期進行實例健康檢查	multiple API calls

成本與限制

運行它的成本

API 配額: 搜尋／驗證工具：不限次數（本地資料）。管理工具：受限於你的 n8n 實例容量。
每次呼叫 Token 數: 節點結構定義可能很大（2-5k tokens）；只需要型別資訊時，使用 get_node 並設定 mode='minimal'
費用: MCP 本身免費；n8n 有雲端方案（$20+/月）或可免費自架
提示: 先用搜尋／驗證功能完整設計（免費），確認無誤後再呼叫 create/update——每次部署都會消耗 n8n 雲端的配額

安全

權限、密鑰、影響範圍

憑證儲存： N8N_API_KEY 存放於環境變數——視同管理員憑證，因為它可以建立工作流程

資料出站： n8n-mcp MCP 本身在本地端執行。管理工具會呼叫你的 N8N_API_URL。

故障排查

常見錯誤與修復

Management tools not appearing

未設定 N8N_API_URL 或 N8N_API_KEY。管理工具只有在啟動時兩個環境變數都存在才會註冊。

驗證： echo $N8N_API_URL && echo $N8N_API_KEY | cut -c1-6

validate_workflow passes but n8n rejects at deploy

可能是憑證參照問題。憑證會依照 n8n 實例中的名稱進行驗證——請確認憑證名稱完全相符。

Workflow deploys but fails on first run with 'Node type not found'

你使用了 n8n 實例上未安裝的社群套件節點。請先在 n8n 中安裝該套件，或改用核心節點替代。

Template JSON uses deprecated node versions

擷取範本後，透過 validate_workflow 檢查——它會標記已棄用的版本。部署前請先升級相關節點。

替代方案

n8n-mcp 對比其他方案

替代方案	何時用它替代	權衡
Zapier MCP	你的團隊使用 Zapier 而非 n8n	僅提供雲端託管；控制彈性較少，但整合項目更完善
Make (Integromat) MCP	你的團隊使用 Make	僅提供雲端託管；情境（scenario）模型與 n8n 的圖形模型不同
Raw n8n REST API	你想從自訂腳本進行程式碼層級的控制	沒有節點目錄或驗證功能——正確性須完全自行負責

n8n-mcp

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： n8n-mcp

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

前置條件

步驟

注意事項

稽核 n8n 實例，找出有問題或有風險的工作流程

步驟

注意事項

從範本開始並加以客製化

步驟

注意事項

組合

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

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

n8n-mcp 對比其他方案

更多

資源