AIに「ワークフロー作って」と頼むだけ！n8nの自動化をAIが代行する魔法のツール — n8n-mcp

アーキテクチャ・仕組み

n8n-MCPはModel Context Protocol（MCP）サーバーとして動作し、AIアシスタントとn8nプラットフォームの間を橋渡しする。SQLiteデータベースに1,084ノード分のドキュメント・プロパティ・操作情報・テンプレートを事前格納しており、AIからの問い合わせに平均約12msで応答する。

• 通信方式: stdio（ローカル）またはHTTP（リモート）
• データベース: better-sqlite3（デフォルト、ネイティブC++バインディング）またはsql.js（JavaScriptフォールバック）
• データベースサイズ: 約70MB

対応環境・プラットフォーム

• AIクライアント: Claude Desktop、Claude Code、Cursor、VS Code（GitHub Copilot）、Windsurf、Codex、Antigravity
• 実行環境: Node.js（任意のバージョン）、Docker
• デプロイ先: ローカル、Docker、Railway（ワンクリック）、Hetzner、AWS等
• 対応n8nバージョン: v2.12.3（データはv2.2.3基準）

主要ツール一覧

コアツール（7種）

• tools_documentation - ツールのドキュメント参照
• search_nodes - ノード全文検索（コミュニティノード対応）
• get_node - ノード情報取得（詳細レベル・ドキュメント・プロパティ検索・バージョン比較）
• validate_node - ノード設定バリデーション（minimal/fullモード）
• validate_workflow - ワークフロー全体の検証（AI Agentワークフロー対応）
• search_templates - テンプレート検索（キーワード/ノード/タスク/メタデータ）
• get_template - テンプレート取得

n8n管理ツール（13種、API設定が必要）

• ワークフローCRUD（作成・取得・更新・削除・一覧）
• 差分更新（n8n_update_partial_workflowでバッチ操作）
• 自動修正（n8n_autofix_workflow）
• バージョン管理・ロールバック
• テンプレートデプロイ
• 実行管理（テスト・一覧・詳細・削除）
• ヘルスチェック

パフォーマンス・データ規模

テスト

• 総テスト数: 3,336件（全件パス）
• ユニットテスト: 2,766件
• インテグレーションテスト: 570件
• フレームワーク: Vitest
• CI: GitHub Actionsで全PR自動テスト

セキュリティ・プライバシー

• 匿名テレメトリ収集あり（オプトアウト可能: N8N_MCP_TELEMETRY_DISABLED=true）
• Webhookセキュリティモード設定可能（WEBHOOK_SECURITY_MODE=moderateでローカル開発に対応）
• 本番ワークフローの直接編集は非推奨（コピー・テスト環境での検証を推奨）

ライセンス

MITライセンス（商用利用可能）。テンプレート利用時は作成者へのアトリビューション（帰属表示）が必須。

方法1: ホスト型サービス（最も簡単）

dashboard.n8n-mcp.com でサインアップするだけ。無料枠で1日100回まで利用可能。

方法2: npx（ローカル実行）

npx n8n-mcp

Claude Desktopの設定ファイルに以下を追加:

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

方法3: Docker

docker pull ghcr.io/czlonkowski/n8n-mcp:latest

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

設定後、Claude Desktopを再起動すれば利用開始。