mcp-n8n-workflow-builder MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

17ツール: ワークフロー8、実行履歴4、タグ5、クレデンシャル管理6
.config.json によるマルチインスタンス対応（本番/ステージング/開発）、デフォルトでgitignore済み
.env で N8N_HOST + N8N_API_KEY を設定するシングルインスタンス構成
ワークフローのCRUD + 有効化/無効化/実行
実行のリトライとログアクセスによるデバッグ

ライブデモ

実際の動作

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個のノードをクリックせずに実現したいとき。

前提条件

APIが有効化されたn8nインスタンスが稼働中であること — 標準的なn8nインストール手順に従い、Settings > API からAPIキーを取得
N8N_HOST + N8N_API_KEY 環境変数（/api/v1 サフィックスは不要） — MCP設定で指定

フロー

意図を説明する

Create a workflow 'airtable-to-slack': trigger on new row in Airtable base X table Y, post message to Slack channel #updates with the row's Name and Status.✓ コピーしました

→ ワークフローが作成され、URLが返される
ノードを確認する

get_workflow by id and tell me the node sequence.✓ コピーしました

→ ノードチェーンが意図と一致
有効化する

Activate the workflow.✓ コピーしました

→ ステータス: active

結果： n8n UIでタブを行き来する代わりに、数分で動作するワークフローが完成します。

注意点

クレデンシャルが誤ったインスタンスに作成される — マルチインスタンス構成では、プロンプトに必ず環境名を含めてください（例: 'ステージング環境で...'）
自動生成されたノードパラメータが一部のエッジケースフィールドを見落とす — 作成後に手動でノードを1回レビューしてください。n8nはオペレーションパラメータに厳密です

組み合わせ： airtable · github

失敗したn8n実行をデバッグする

👤 n8nを本番環境で運用しているすべてのユーザー ⏱ ~15 min intermediate

使うタイミング： 午前3時にワークフローが失敗し、原因を調べたいとき。

フロー

直近の失敗を検索する

list_executions status=error last 24h on prod.✓ コピーしました

→ 失敗リスト
詳細を調査する

get_execution for the most recent — which node failed, with what error?✓ コピーしました

→ ノード + スタックトレース
リトライまたは修正する

If transient, retry_execution. If code, propose a node change in the workflow JSON.✓ コピーしました

→ 対処完了

結果： 根本原因の特定に加え、復旧またはパッチの提案が得られます。

組み合わせ： sentry

ワークフローの一括タグ付けとクレデンシャルの監査

👤 プラットフォーム管理者 ⏱ ~30 min intermediate

使うタイミング： n8nインスタンスを引き継ぎ、整理が必要なとき。

フロー

ワークフローを一覧・分類する

list_workflows — classify each as {marketing, internal, ops, dead}.✓ コピーしました

→ 分類結果
タグを適用する

Tag each per classification using create_tag + workflow update.✓ コピーしました

→ タグ適用完了
クレデンシャルを監査する

list_credentials — flag any shared across environments or unused for >90 days.✓ コピーしました

→ クリーンアップリスト

結果： 整理された、監査可能なn8n環境が得られます。

組み合わせ

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

n8n-workflow-builder-2 + airtable

Airtable→Slackフローを設計・デプロイする

AirtableのCRMに新しいDealが追加されたらSlackに投稿するn8nワークフローを設計してください。エラーハンドリングも含めてください。✓ コピーしました

n8n-workflow-builder-2 + sentry

n8nのエラーをSentryで追跡する

ワークフロー実行エラー発生時に、ワークフロー名とノードデータを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インスタンスの制限に準拠（セルフホストの場合は無制限）
呼び出しあたりのトークン: 複雑なフローではワークフローJSONが5〜20kトークンに達する可能性あり
金額: 無料（n8n Community）または有料（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

n8nのクレデンシャルにはシークレット（DBパスワード、APIキー）が含まれます — APIキーへのアクセス権限を持つユーザーを監査してください。
このMCPはワークフローの有効化・実行が可能です — n8nの管理者レベルのアクセス権限と同等に扱ってください。

トラブルシューティング

よくあるエラーと対処法

401 from n8n

APIキーが無効または期限切れです。Settings > 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はセルフホスト可能だが、Zapierは不可
Native n8n AI nodes	ワークフローの外側ではなく内側でAIを使いたい場合	外部からのチャット制御は不可

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

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