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 ワークフローを構築する

👤 Ops エンジニア、n8n を使うインディーハッカー ⏱ ~20 min intermediate

使うタイミング： やりたいことは分かっている（「新しい Typeform の回答を Notion + Slack に送る」など）が、n8n の UI を 20 分もクリックしたくないとき。

前提条件

n8n インスタンス（クラウドまたはセルフホスト） — 動作する n8n があれば OK。デプロイ時のみ必要で、設計段階では不要
N8N_API_URL + N8N_API_KEY — n8n Settings → n8n API → API キーを作成

フロー

各ステップに必要なノードを検索

I want: Typeform webhook → parse → create Notion page → post to Slack. Search for the exact node types I need.✓ コピーしました

→ ノード名＋必要なクレデンシャルが特定される
ワークフロー JSON を生成

Generate a complete workflow with those 4 nodes wired in order. Use a template as a base if one matches.✓ コピーしました

→ 有効な n8n ワークフロー JSON
検証してデプロイ

Validate the JSON with validate_workflow. Fix any errors. Then deploy to my n8n as a draft (not active).✓ コピーしました

→ n8n UI にドラフト状態でワークフローが表示される

結果： 手動操作の 10 倍速で動作する n8n ワークフローが完成。バリデーションが設定ミスを実行前にキャッチします。

注意点

クレデンシャルは事前に n8n で設定が必要 — JSON は ID で参照する — デプロイ前に n8n UI でクレデンシャルエントリを作成し、クレデンシャル ID をエージェントに渡す
エージェントがアクティブ状態でデプロイし、過去のデータに対して即座に実行されてしまう — 常に非アクティブでデプロイし、n8n UI でテスト後に手動でアクティブ化する

n8n インスタンスの壊れた・危険なワークフローを監査する

👤 n8n インスタンスを引き継いだ Ops リーダー ⏱ ~30 min intermediate

使うタイミング： 50 個のワークフローがありドキュメントなしの n8n インスタンスを引き継いだ。何があるか、何がリスクかを把握したいとき。

フロー

全ワークフローをリストアップ

List every workflow with name, active status, last execution time, and node count.✓ コピーしました

→ 完全なインベントリ
リスクのあるパターンをフラグ付け

Find workflows with: no error handling, webhook triggers with no auth, HTTP Request nodes to random URLs, or shell command nodes.✓ コピーしました

→ 根拠付きのリスクリスト
失敗率を確認

For each active workflow, get last 20 executions. Compute failure rate. Flag anything >20%.✓ コピーしました

→ 壊れたワークフローのリスト

結果： リスク＋健全性のインベントリ — 何を修正・凍結・削除すべきかが分かります。

注意点

他のワークフローが依存しているワークフローを無効化してしまう（Execute Workflow ノード経由） — 無効化する前に、対象の ID を参照している他のワークフローを検索する

テンプレートから始めてカスタマイズする

👤 n8n 初心者 ⏱ ~15 min beginner

使うタイミング： 誰かが似たものを作っている可能性が高い — それを出発点にしたいとき。

フロー

テンプレートを検索

Find templates that do: 'sync a CSV to a database with deduplication'.✓ コピーしました

→ 関連度順にランク付けされた 3〜5 個の候補テンプレート
取得して適応

Get the JSON for the top match. Adapt nodes to use my actual database (Postgres at host X) and my CSV source (S3 bucket Y).✓ コピーしました

→ カスタマイズ済みのワークフロー JSON
検証してデプロイ

Validate, then deploy as draft to my n8n.✓ コピーしました

→ n8n にドラフトワークフローが作成される

結果： 先人の成果を活用し、10 分で動作するワークフローが完成します。

注意点

テンプレートが非推奨のノードバージョンを使用している — validate_workflow の出力でバージョン警告を確認し、最新のノードに差し替える

組み合わせ

他のMCPと組み合わせて10倍の力を

n8n-mcp + notion

特定の Notion データベースに書き込む n8n ワークフローを構築 — まず DB スキーマを確認する

Look up my Notion 'Leads' database schema. Then build an n8n workflow that takes webhook input and creates matching entries.✓ コピーしました

n8n-mcp + linear

n8n ワークフローの失敗に対して Linear チケットを自動作成

Audit my n8n for workflows failing >20% of runs. For each, create a 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 インスタンスのキャパシティによる制限あり。
呼び出しあたりのトークン: ノードスキーマは大きい場合があります（2〜5k トークン）。型情報だけ必要な場合は 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（`validate_workflow` は通るが n8n がデプロイ時に拒否する）

クレデンシャル参照の問題である可能性が高いです。クレデンシャルは n8n インスタンス内の名前と照合されます — クレデンシャル名が完全に一致しているか確認してください。

Workflow deploys but fails on first run with 'Node type not found'（デプロイは成功するが初回実行時に 'Node type not found' で失敗する）

n8n インスタンスにインストールされていないコミュニティパッケージのノードを使用しています。先に n8n にインストールするか、コアノードに差し替えてください。

Template JSON uses deprecated node versions（テンプレート JSON が非推奨のノードバージョンを使用している）

取得後に validate_workflow を通してください — 非推奨バージョンがフラグ付けされます。デプロイ前にノードをアップグレードしてください。

代替案

n8n-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
Zapier MCP	チームが n8n ではなく Zapier を使用している場合	ホスト型のみ。制御性は低いが、インテグレーションはより洗練されている
Make (Integromat) MCP	チームが Make を使用している場合	ホスト型。シナリオモデルが n8n のグラフモデルとは異なる
Raw n8n REST API	カスタムスクリプトからコードレベルで制御したい場合	ノードカタログやバリデーションなし — 正しさの担保は自己責任

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る