n8n MCP サーバー

モデルコンテキストプロトコル（MCP）を介してn8nのワークフロー、実行、資格情報などへのアクセスを提供するMCPサーバー。これにより、大規模言語モデル（LLM）はn8nインスタンスと安全かつ標準化された方法でやり取りできるようになります。

インストール

n8n APIキーを取得する

1. n8nインスタンスにログインする

2. 左下のユーザーアイコンをクリックします

3. 設定に移動

4. APIを選択

5. 「APIキーを作成」をクリックします

6. APIキーをコピーします（再度表示することはできません）

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

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

オプション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として利用できるようになります。

構成

クロードデスクトップ

1. Claude デスクトップ構成を開きます。

   ~/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" } } } }

クライン（VSコード）

1. サーバーをインストールします（上記のインストール手順に従ってください）

2. VSコードを開く

3. 左サイドバーからCline拡張機能を開きます

4. ペインの上部にある「MCPサーバー」アイコンをクリックします

5. 一番下までスクロールして「MCPサーバーの構成」をクリックします。

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コマンドの使用を開始する

セージ

近日公開！n8n MCPサーバーは以下の方法でご利用いただけます。

• Smithery.aiマーケットプレイス

• Claude Desktopからのインポート

今のところは、Claude Desktop または Cline を使用してください。

検証

設定後:

1. LLMアプリケーションを再起動します

2. 質問:「n8n ワークフローをリストしてください」

3. ワークフローがリストされているはずです

エラーが発生した場合:

• n8nインスタンスが実行中であることを確認する

• APIキーに正しい権限があることを確認してください

• N8N_HOSTに末尾のスラッシュがないことを確認する

特徴

コア機能

• ワークフローの一覧表示と管理

• ワークフローの詳細を表示

• ワークフローを実行する

• 資格情報の管理

• タグと実行を処理する

• セキュリティ監査を生成する

• ワークフロータグを管理する

エンタープライズ機能

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

• プロジェクト管理

• 変数管理

• 高度なユーザー管理

トラブルシューティング

よくある問題

1. 「クライアントが初期化されていません」

   • N8N_HOSTとN8N_API_KEYが正しく設定されていることを確認してください

   • n8nインスタンスがアクセス可能であることを確認する

   • APIキーの権限を確認する

2. 「ライセンスが必要です」

   • エンタープライズ機能を使用しようとしています

   • n8n Enterpriseにアップグレードするか、コア機能のみを使用するか

3. 接続の問題

   • n8nインスタンスが実行中であることを確認する

   • URLプロトコル（http/https）を確認する

   • N8N_HOSTから末尾のスラッシュを削除します

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

1. APIキー管理

   • 必要最小限の権限を使用する

   • 定期的にキーをローテーションする

   • バージョン管理にキーをコミットしない

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

   • 本番環境ではHTTPSを使用する

   • n8n認証を有効にする

   • n8nを最新の状態に保つ

サポート

• GitHub の問題

• n8n ドキュメント

ライセンス

MITライセンス