n8n MCP Server

n8n MCP サーバー

Model Context Protocol を通じて、n8n のワークフロー、実行、認証情報などにアクセスできる MCP サーバーです。これにより、大規模言語モデル（LLM）は、安全で標準化された方法で n8n インスタンスとやり取りできます。

インストール

n8n API キーを取得する

1. n8n インスタンスにログインします
2. 左下のユーザーアイコンをクリックします
3. 「Settings」に移動します
4. 「API」を選択します
5. 「Create API Key」をクリックします
6. API キーをコピーします（再度表示することはできません）

MCP サーバーをインストールする

オプション 1：npm からインストール（推奨）

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

オプション 2：ソースからインストール

1. リポジトリをクローンします：

   git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
   cd n8n-mcp-server
   

2. 依存関係をインストールしてビルドします：

   npm install
   npm run build
   

3. サーバーをバックグラウンドで起動します：

   nohup npm start > n8n-mcp.log 2>&1 &
   

   サーバーを停止するには：

   pkill -f "node build/index.js"
   

注：npm からインストールすると、サーバーは PATH 上で n8n-mcp-server として利用できます。

設定

Claude Desktop

1. Claude Desktop の設定を開きます：

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

2. n8n の設定を追加します：

   {
     "mcpServers": {
        "n8n": {
         "command": "n8n-mcp-server",
         "env": {
           "N8N_HOST": "https://your-n8n-instance.com",
           "N8N_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

Cline（VS Code）

1. サーバーをインストールします（上記のインストール手順に従ってください）
2. VS Code を開きます
3. 左側のサイドバーから Cline 拡張機能を開きます
4. ペイン上部にある「MCP Servers」アイコンをクリックします
5. 下までスクロールし、「Configure MCP Servers」をクリックします
6. 開いた設定ファイルに追加します：

   {
     "mcpServers": {
       "n8n": {
         "command": "n8n-mcp-server",
         "env": {
           "N8N_HOST": "https://your-n8n-instance.com",
           "N8N_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

7. ファイルを保存します
8. MCP の切り替えが有効（緑色）で、ステータスインジケーターが緑色であることを確認します
9. Cline で MCP コマンドを使用します

Sage

近日公開予定です！n8n MCP サーバーは、以下を通じて利用できるようになります：

• Smithery.ai マーケットプレイス
• Claude Desktop からのインポート

現時点では、Claude Desktop または Cline をご利用ください。

検証

設定後：

1. LLM アプリケーションを再起動します
2. 「n8n のワークフローを一覧表示して」と尋ねます
3. ワークフローの一覧が表示されます

エラーが発生した場合：

• n8n インスタンスが実行中であることを確認します
• API キーに適切な権限があることを確認します
• N8N_HOST の末尾にスラッシュがないことを確認します

機能

コア機能

• ワークフローの一覧表示と管理
• ワークフローの詳細表示
• ワークフローの実行
• 認証情報の管理
• タグと実行の処理
• セキュリティ監査の生成
• ワークフロータグの管理

エンタープライズ機能

これらの機能には n8n Enterprise ライセンスが必要です：

• プロジェクト管理
• 変数管理
• 高度なユーザー管理

トラブルシューティング

よくある問題

1. 「Client not initialized」

   • N8N_HOST と N8N_API_KEY が正しく設定されていることを確認します
   • n8n インスタンスにアクセスできることを確認します
   • API キーの権限を確認します

2. 「License required」

   • エンタープライズ機能を使用しようとしています
   • n8n Enterprise にアップグレードするか、コア機能のみを使用してください

3. 接続の問題

   • n8n インスタンスが実行中であることを確認します
   • URL のプロトコル（http/https）を確認します
   • N8N_HOST の末尾のスラッシュを削除します

セキュリティのベストプラクティス

1. API キーの管理

   • 必要最小限の権限を使用します
   • キーを定期的にローテーションします
   • キーをバージョン管理にコミットしないでください

2. インスタンスへのアクセス

   • 本番環境では HTTPS を使用します
   • n8n の認証を有効にします
   • n8n を最新の状態に保ちます

サポート

• GitHub の問題報告
• n8n のドキュメント

ライセンス

MIT ライセンス