n8n-MCP（czlonkowski/n8n-mcp）：n8nのワークフロー作成・検証をClaude Codeから行えるMCPサーバー

n8n-MCP（czlonkowski/n8n-mcp）は、ワークフロー自動化ツール「n8n」の情報をClaudeなどのAIに渡すMCPサーバーです。n8nのノード（処理部品）の仕様、設定項目、公式ドキュメント、ワークフローのテンプレートを、AIが検索・参照できる形で提供します。READMEによると、対象は2,951ノード（コア838、コミュニティ2,113）、テンプレート2,352件です。GitHubのmcp-serverトピックでは約2.3万スターの位置にあります。

想定する利用者は、n8nで業務の自動化（通知、スプレッドシート連携、Webhook処理など）を組んでいる人、またはこれから組もうとしている人です。ノードの設定をAIに考えさせ、検証までさせる用途を想定した作りになっています。n8n側のAPIキーを設定すると、ワークフローの作成・更新・実行テストまでAIから操作できます。

何ができるか
導入方法
注意点
結び

何ができるか

機能は二段構えです。APIの設定なしで使える基本ツールは7種類で、ノード検索、ノード情報の取得、ノード設定とワークフローの検証、テンプレートの検索と取得を行います。n8nのURLとAPIキーを設定すると、ワークフロー管理系のツールが加わります。READMEは21種類としています。

ワークフローの作成、取得、差分更新、削除、一覧、検証、自動修正
テンプレートのn8n.ioからインスタンスへの直接配置
ワークフローの実行テストと実行履歴の確認
フォルダ、データテーブル、認証情報（credentials）の管理
インスタンスのセキュリティ監査

一部の機能（n8n Agentsの管理、ノードの動的選択肢の取得など）は、別のトークン（N8N_MCP_ACCESS_TOKEN）とn8n 2.34以降などの条件が必要と書かれています。

導入方法

Claude Codeへの追加は、公式のセットアップ手順（docs/CLAUDE_CODE_SETUP.md）に沿って、claude mcp addコマンド1回で済みます。npxで起動するため、Node.jsが入っていることが前提です。まず、n8nのAPIを使わずドキュメント・検証機能だけを使う場合は次のとおりです。

claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e LOG_LEVEL=error \
  -e DISABLE_CONSOLE_OUTPUT=true \
  -- npx n8n-mcp

自分のn8nインスタンスを操作させる場合は、URLとAPIキーを環境変数で追加します。n8nをローカルで動かしているなら、URLはhttp://localhost:5678です。APIキーはn8nの「Settings → API」で発行します。

claude mcp add n8n-mcp \
  -e MCP_MODE=stdio \
  -e LOG_LEVEL=error \
  -e DISABLE_CONSOLE_OUTPUT=true \
  -e N8N_API_URL=https://your-n8n-instance.com \
  -e N8N_API_KEY=your-api-key \
  -- npx n8n-mcp

登録後は次のコマンドで確認できます。設定を共有したい場合は、–scope projectを付けるとプロジェクト直下の.mcp.jsonに保存されます。

claude mcp list
claude mcp get n8n-mcp
claude mcp remove n8n-mcp

このほか、npx・Docker・Railway・ローカルインストールによるセルフホスト（docs/SELF_HOSTING.md）と、サーバー運営元が提供するホスト版（dashboard.n8n-mcp.com、無料枠は1日100回のツール呼び出し）が用意されています。Cursor、VS Code、Windsurf、Codexなど他のクライアント向けの手順も同梱されています。作者は別リポジトリでn8n向けのClaudeスキル（n8n-skills）も公開しており、併用が任意で案内されています。

注意点

最初に確認したいのは、本番ワークフローへの影響です。READMEは冒頭の警告で、本番のワークフローをAIで直接編集しないこと、編集前にコピーを作ること、開発環境で先にテストすること、バックアップをエクスポートしておくことを求めています。AIの結果は予測できない、という記述もあります。

次に、認証情報の扱いです。N8N_API_KEYはclaude mcp addの環境変数としてClaude Codeの設定に保存されます。ドキュメントによると、既定のスコープ（local）ではユーザー設定に保存されてAPIキーは非公開のまま、–scope projectでは.mcp.jsonに保存されてチームと共有される仕組みです。キーを書いた.mcp.jsonをリポジトリに含めない運用が必要です。また、n8n_manage_credentialsツールは認証情報の一覧取得から作成・更新・削除まで行えます。

権限を絞りたい場合、READMEは読み取り専用の構成を示しています。DISABLED_TOOLS環境変数で、作成・更新・削除・実行・認証情報管理などのツールを無効にできます。さらに、n8n側で読み取り専用のAPIキーを発行して組み合わせる方法が書かれています。操作単位で止めるDISABLED_TOOL_OPERATIONSもあります。

外部通信については、PRIVACY.mdにテレメトリの記載があります。テレメトリは既定で有効で、ツールの利用状況（呼び出したツール名、成否、所要時間）、サニタイズ後のワークフロー構造、エラー分類、システム情報などが送信対象です。インストールIDという固定の識別子も含まれます。ポリシーによれば、APIキー、URL・ホスト名、実行データ、ユーザーが書いたプロンプト（更新ツールのintent欄を除く）は収集しないとされています。送信前のサニタイズは手元のマシンで行われる、とも書かれています。停止するには次のコマンドを使います。