n8n MCP Server

n8n MCP Server とは？

この n8n MCP サーバーは、コミュニティ製の Model Context Protocol サーバー（@leonardsellem/n8n-mcp-server）です。AI アシスタントが n8n REST API を通じて、自然言語で n8n ワークフローの一覧表示、作成、更新、有効化、実行を行い、実行履歴を確認できるようにします。

n8n 公式のものではありません。n8n API キーを使って自分の n8n インスタンス（クラウドまたはセルフホスト）に接続し、npm、ソース、Docker イメージのいずれかからインストールして、stdio でローカル実行します。n8n 自体も現在は組み込みの MCP 機能を提供しており、後述の比較で紹介します。

n8n MCP Server の使い方

前提条件： Node.js 20 以降と、API アクセスを有効にした n8n インスタンス。

1. n8n API キーを作成します。 n8n インスタンスで Settings > API > API Keys を開き、適切な権限のキーを作成してコピーします。

2. サーバーをインストールします。

npm install -g @leonardsellem/n8n-mcp-server

または Docker で実行します。

docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \
  -e N8N_API_KEY=your_n8n_api_key \
  -e N8N_WEBHOOK_USERNAME=username \
  -e N8N_WEBHOOK_PASSWORD=password \
  leonardsellem/n8n-mcp-server

3. 環境変数を設定します。

変数	用途
N8N_API_URL	/api/v1 を含む n8n API の完全な URL（例：http://localhost:5678/api/v1）
N8N_API_KEY	n8n の API キー
N8N_WEBHOOK_USERNAME / N8N_WEBHOOK_PASSWORD	Basic 認証の資格情報。webhook ツールを使う場合のみ
DEBUG	任意のデバッグログ

Claude Desktop と VS Code

README の設定例では、ビルドしたファイルを node で実行します。npm run build の後、build/index.js の絶対パスを指定します。

{
  "mcpServers": {
    "n8n-local": {
      "command": "node",
      "args": ["/path/to/your/cloned/n8n-mcp-server/build/index.js"],
      "env": {
        "N8N_API_URL": "http://your-n8n-instance:5678/api/v1",
        "N8N_API_KEY": "YOUR_N8N_API_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

npm でグローバルインストールした場合は、node のパスの代わりに n8n-mcp-server をコマンドとして使えると README に記載されています。

Claude Code

npm でグローバルインストールした場合：

claude mcp add n8n -e N8N_API_URL=http://localhost:5678/api/v1 -e N8N_API_KEY=YOUR_N8N_API_KEY -- n8n-mcp-server

Cursor

~/.cursor/mcp.json に同じ mcpServers ブロックを記述し、コマンドには n8n-mcp-server または node のパスを指定します。

n8n MCP Server の主な機能

• ワークフローの完全な管理：一覧、取得、作成、更新、削除、有効化、無効化
• n8n API または webhook 経由でのワークフロー実行
• 実行の確認、一覧表示、停止
• n8n://workflows/list などの、ワークフローと実行のための MCP リソース
• 環境変数の Basic 認証情報による webhook 呼び出しの自動認証
• 公開 REST API を通じて n8n クラウドとセルフホストの両方に対応
• npm、ソース、Docker Hub で提供。MIT ライセンス

n8n MCP Server のツール

ツールは 2 つのグループに分かれます。

• ワークフロー管理： workflow_list、workflow_get、workflow_create、workflow_update、workflow_delete、workflow_activate、workflow_deactivate。
• 実行管理： execution_run は API 経由でワークフローを実行し、run_webhook は名前を指定して webhook ワークフローをトリガーします（<n8n-url>/webhook/<workflowName> を呼び出します）。execution_get、execution_list、execution_stop で実行を確認・停止します。

リソースは同じデータを読み取り用に公開します：n8n://workflows/list、n8n://workflow/{id}、n8n://executions/{workflowId}、n8n://execution/{id}。

n8n MCP Server のユースケース

• ワークフローの棚卸し：「List all my n8n workflows and tell me which ones are inactive.」
• チャットから構築：「Create a workflow that posts new form submissions to Slack, but leave it inactive.」
• 自動化のトリガー：「Run the hello-world webhook workflow with the prompt 'Hello from AI assistant!'」
• デバッグ：「Show the last five failed executions of the invoice-sync workflow and what went wrong.」
• 運用：「Stop the execution that has been running for over an hour, then deactivate that workflow.」

n8n MCP Server と代替ツールの比較

n8n は現在、独自の MCP 機能を備えています。MCP Server Trigger ノードは、1 つの n8n ワークフローを MCP サーバーに変え、n8n のツールノードをツールとして SSE または Streamable HTTP で公開します。インスタンスレベルの MCP アクセスでは、オーナーや管理者が n8n の設定から選んだワークフローを MCP クライアントに公開できます。ローカルの stdio サーバーから REST API を通じて、エージェントにワークフローそのもの（作成、編集、有効化、削除）を管理させたい場合は、このコミュニティ版 n8n MCP サーバーを選びます。ツール構成の異なる他のコミュニティ製 n8n MCP プロジェクトもあります。

n8n MCP Server のトラブルシューティング

• 認証エラーや 404： N8N_API_URL に /api/v1 が含まれているか、API キーが有効で必要な権限を持っているかを確認します。
• クライアントがサーバーを起動できない： 先に npm run build を実行し、build/index.js の絶対パスを正しい区切り文字（Windows ではバックスラッシュ 2 つ）で指定します。
• webhook の呼び出しが失敗する： run_webhook は Basic 認証を使います。N8N_WEBHOOK_USERNAME と N8N_WEBHOOK_PASSWORD を設定し、webhook ノードで Basic Authentication を有効にします。
• 古いバージョンが動いている： npm install -g @leonardsellem/n8n-mcp-server@latest または docker pull leonardsellem/n8n-mcp-server:latest で更新し、サーバーを再起動します。
• 詳細を確認したい： DEBUG=true を設定してデバッグログを有効にします。