n8n Workflow Builder MCP Server

n8n Workflow Builder MCP サーバー

n8n ワークフロー自動化のための究極の AI アシスタント連携 - Claude Desktop、ChatGPT、その他の AI アシスタントを n8n インスタンスに直接接続し、Model Context Protocol（MCP）を通じて、ワークフローの管理、作成、実行をシームレスに行えます。

AI アシスタントが n8n ワークフローをシームレスに管理できるようにする、強力な Model Context Protocol（MCP）サーバーです。AI ツールを n8n に直接接続し、ワークフローの作成、実行、管理を自動化できます。

📚 目次

• これは何ですか？
• 主な機能
• 必要条件
• インストールと使用方法
• 設定
• MCP クライアントのセットアップ
• 利用可能なツール
• 使用例
• トラブルシューティング
• よくある質問
• 貢献
• ライセンス
• 便利なリンク

📖 関連ドキュメント

• 🚀 はじめに - 5 分以内で簡単にセットアップできます
• 💼 実際の使用例 - E コマース、データ処理、API 統合など
• 🔍 他の選択肢との比較 - Zapier、Make.com、n8n Web UI、CLI との比較
• 🔧 詳細なトラブルシューティング - よくある問題への解決策

🎯 これは何ですか？

n8n Workflow Builder MCP Server は、AI アシスタント（Claude Desktop、Cline、その他の MCP 対応クライアントなど）と、お使いの n8n 自動化プラットフォームをつなぎます。AI アシスタントで以下の操作を行える、包括的なツールセットを提供します。

• 既存の n8n ワークフローの一覧表示と閲覧
• 複雑なノード設定を含む新しいワークフローの作成
• 必要に応じたワークフローの実行
• ワークフローのライフサイクル管理（有効化、無効化、更新、削除）
• ワークフローの状態の監視と詳細情報の取得

ワークフローの自動化と管理に AI アシスタントを活用したい、n8n を使用するチームに最適です。

✨ 主な機能

• 🔧 ワークフロー管理を完全サポート - n8n ワークフローの CRUD 操作に対応
• 🤖 AI ファーストの設計 - AI アシスタントとの統合に特化して構築
• 🚀 設定不要 - NPX ですぐに使用可能
• 🔒 セキュア - 適切な認証を使用する n8n の公式 API を利用
• 📦 モダンなアーキテクチャ - TypeScript と最新の MCP SDK で構築
• ⚡ 高パフォーマンス - 高速な応答時間を実現するよう最適化

📋 必要条件

• Node.js v18.0.0 以降
• n8n インスタンス（セルフホストまたはクラウド）
• 適切な権限を持つ n8n API キー

🚀 インストールと使用方法

方法 1：Smithery.ai（ホスト型 - 推奨）

Smithery.ai のホスト版を使用できます。インストールは不要です。

1. アクセス：smithery.ai
2. 検索：「n8n-workflow-builder」
3. 接続：n8n ホストと API キーを設定
4. 使用：任意の MCP 対応 AI アシスタントからアクセス

メリット：ローカルでのセットアップ不要、自動更新、プロフェッショナルなホスティング、ツールのプレイグラウンド。

方法 2：NPX（ローカル）

NPX を使ってローカルで実行します。

npx @makafeli/n8n-workflow-builder

方法 2：手動インストール

開発またはカスタマイズする場合：

# Clone the repository
git clone https://github.com/makafeli/n8n-workflow-builder.git
cd n8n-workflow-builder

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

⚙️ 設定

環境変数

n8n インスタンスに接続するには、以下の環境変数を設定します。

変数	説明	例
N8N_HOST	n8n インスタンスの URL	http://localhost:5678 または https://your-n8n.com/api/v1
N8N_API_KEY	n8n API キー	n8n_api_1234567890abcdef...

n8n API キーの取得

1. n8n インスタンスを開きます
2. Settings → API Keys に移動します
3. Create API Key をクリックします
4. 生成されたキーをコピーします

環境変数の設定

# For local testing
export N8N_HOST="http://localhost:5678"
export N8N_API_KEY="your-api-key-here"

# Then run the server
npx @makafeli/n8n-workflow-builder

🔧 MCP クライアントのセットアップ

Claude Desktop

この設定を claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@makafeli/n8n-workflow-builder"],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline（VS Code 拡張機能）

これを Cline の MCP 設定に追加します。

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@makafeli/n8n-workflow-builder"],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

その他の MCP クライアント

このサーバーは、あらゆる MCP 対応クライアントで動作します。クライアント固有のセットアップ方法で、同じ設定パターンを使用してください。

🛠️ 利用可能なツール

この MCP サーバーは、n8n のワークフローと実行を完全に管理するための包括的な 15 種類のツールを提供します。

コアワークフロー操作

ツール	説明	パラメーター
list_workflows	n8n インスタンスのすべてのワークフローを一覧表示します	なし
get_workflow	特定のワークフローの詳細情報を取得します	id：ワークフロー ID（文字列）
create_workflow	ノードと接続を含む新しいワークフローを作成します	workflow：ワークフローオブジェクト
execute_workflow	ワークフローを手動で実行します	id：ワークフロー ID（文字列）

ワークフローのライフサイクル管理

ツール	説明	パラメーター
update_workflow	既存のワークフロー設定を更新します	id：ワークフロー ID、workflow：更新後のワークフローオブジェクト
activate_workflow	ワークフローを有効化して、自動実行を可能にします	id：ワークフロー ID（文字列）
deactivate_workflow	ワークフローを無効化して、自動実行を停止します	id：ワークフロー ID（文字列）
delete_workflow	ワークフローを完全に削除します	id：ワークフロー ID（文字列）

高度な操作

ツール	説明	パラメーター
create_workflow_and_activate	新しいワークフローを作成し、すぐに有効化します	workflow：ワークフローオブジェクト

実行管理 ⭐ NEW

ツール	説明	パラメーター
list_executions	フィルタリングとページネーションを使ってワークフローの実行を一覧表示します	includeData、status、workflowId、projectId、limit、cursor
get_execution	特定の実行の詳細情報を取得します	id：実行 ID、includeData：詳細データを含めるかどうか
delete_execution	ワークフローの実行記録を削除します	id：実行 ID

タグ管理 ⭐ NEW

ツール	説明	パラメーター
list_tags	ページネーションを使ってすべてのワークフロータグを一覧表示します	limit、cursor
create_tag	整理用の新しいワークフロータグを作成します	name：タグ名

セキュリティとコンプライアンス ⭐ NEW

ツール	説明	パラメーター
generate_audit	包括的なセキュリティ監査レポートを生成します	additionalOptions：監査設定

💡 使用例

基本操作

// List all workflows
await callTool("list_workflows", {});

// Get detailed information about a workflow
await callTool("get_workflow", { id: "workflow-123" });

// Execute a workflow manually
await callTool("execute_workflow", { id: "workflow-123" });

ワークフローの作成

// Create a simple workflow
await callTool("create_workflow", {
  workflow: {
    name: "My Automation Workflow",
    nodes: [
      {
        id: "trigger",
        name: "Schedule Trigger",
        type: "n8n-nodes-base.scheduleTrigger",
        typeVersion: 1,
        position: [240, 300],
        parameters: {
          interval: [{ field: "unit", value: "hours" }]
        }
      },
      {
        id: "action",
        name: "HTTP Request",
        type: "n8n-nodes-base.httpRequest",
        typeVersion: 4,
        position: [460, 300],
        parameters: {
          url: "https://api.example.com/webhook",
          method: "POST"
        }
      }
    ],
    connections: {
      "Schedule Trigger": {
        "main": [[{ "node": "HTTP Request", "type": "main", "index": 0 }]]
      }
    }
  }
});

ワークフロー管理

// Activate a workflow
await callTool("activate_workflow", { id: "workflow-123" });

// Update a workflow
await callTool("update_workflow", {
  id: "workflow-123",
  workflow: { name: "Updated Workflow Name" }
});

// Deactivate a workflow
await callTool("deactivate_workflow", { id: "workflow-123" });

// Create and immediately activate
await callTool("create_workflow_and_activate", {
  workflow: { /* workflow configuration */ }
});

実行管理 ⭐ NEW

// List recent executions
await callTool("list_executions", {
  limit: 10,
  status: "error"
});

// Get detailed execution information
await callTool("get_execution", {
  id: "execution-123",
  includeData: true
});

// Clean up old execution records
await callTool("delete_execution", { id: "execution-123" });

タグ管理 ⭐ NEW

// List all workflow tags
await callTool("list_tags", { limit: 50 });

// Create a new tag for organization
await callTool("create_tag", { name: "production" });

セキュリティ監査 ⭐ NEW

// Generate comprehensive security audit
await callTool("generate_audit", {
  additionalOptions: {
    daysAbandonedWorkflow: 30,
    categories: ["credentials", "database", "nodes"]
  }
});

🔧 トラブルシューティング

よくある問題

「Connection refused」または「ECONNREFUSED」

• 原因：n8n インスタンスに接続できません
• 解決策：N8N_HOST が正しく設定されており、n8n が実行中であることを確認してください
• 確認方法：まずブラウザーで n8n インスタンスにアクセスしてみてください

「Unauthorized」または「401 Error」

• 原因：API キーが無効か、設定されていません
• 解決策：
  1. N8N_API_KEY が正しく設定されていることを確認してください
  2. API キーに適切な権限があることを確認してください
  3. API キーの有効期限が切れていないか確認してください

「Workflow not found」または「404 Error」

• 原因：ワークフロー ID が存在しません
• 解決策：list_workflows を使って有効なワークフロー ID を取得してください

サーバーが起動しない

• 原因：Node.js または依存関係が不足しています
• 解決策：
  1. Node.js v18+ がインストールされていることを確認してください：node --version
  2. npm キャッシュをクリアしてみてください：npm cache clean --force
  3. 手動でインストールする場合は、次を実行してください：npm install && npm run build

デバッグモード

詳細なログを記録するには、デバッグ環境変数を設定してください：

DEBUG=n8n-workflow-builder npx @makafeli/n8n-workflow-builder

ヘルプの利用

1. GitHub Issuesを確認してください
2. n8n のAPI ドキュメントを参照してください
3. MCP クライアントの設定を確認してください

❓ よくある質問

MCP サーバーとは何ですか？

Model Context Protocol（MCP）サーバーは、AI アシスタントが外部ツールやデータソースにアクセスするための標準化された方法です。この MCP サーバーは、AI アシスタントが n8n ワークフローを操作できるようにし、自然言語コマンドによるワークフロー管理の自動化を実現します。

AI アシスタントを n8n ワークフローに接続するにはどうすればよいですか？

この MCP サーバーは、AI アシスタント（Claude Desktop、Cline、ChatGPT など）とお使いの n8n インスタンスをつなぐブリッジとして機能します。以下の手順を実行するだけです。

1. MCP サーバーをインストールします：npx @makafeli/n8n-workflow-builder
2. AI アシスタントの MCP 設定に n8n の認証情報を設定します
3. 自然言語を使って n8n ワークフローを管理します

この MCP サーバーはどの AI アシスタントで使えますか？

このサーバーは、以下を含むMCP 互換の AI アシスタントであれば、どれでも使用できます。

• Claude Desktop（Anthropic）
• Cline（VS Code 拡張機能）
• Continue（VS Code 拡張機能）
• カスタムの MCP クライアント実装
• 今後登場する MCP 互換の AI アシスタント

n8n Cloud でもセルフホストでも使えますか？

この MCP サーバーは、n8n Cloud とセルフホストの両方のインスタンスで使用できます。必要なのは以下のとおりです。

• n8n インスタンスの URL（クラウドまたはセルフホスト）
• 適切な権限を持つ有効な n8n API キー
• MCP サーバーを実行する環境からのネットワークアクセス

AI アシスタントは n8n ワークフローで何ができますか？

AI アシスタントは、以下を含むワークフロー管理全般を実行できます。

• 既存のワークフローの一覧表示と参照
• 複雑なノード設定を含む新しいワークフローの作成
• ワークフローの手動またはオンデマンドでの実行
• ワークフローの有効化／無効化
• 既存のワークフローの更新と変更
• 実行ステータスの監視と詳細なログの取得
• ワークフロータグと整理の管理
• セキュリティ監査とコンプライアンスレポートの生成

セキュリティは確保されていますか？どのような権限が必要ですか？

この MCP サーバーは、適切な認証を使用してn8n の公式 APIに接続します。

• 有効な n8n API キーが必要です（権限はご自身で管理できます）
• MCP サーバーにデータは保存されません
• すべての通信は、お使いの AI アシスタントと n8n の間で直接行われます
• n8n のセキュリティモデルとアクセス制御に従います
• API キーを無効にすれば、いつでもアクセスを取り消せます

n8n のウェブインターフェースを使う場合と何が違いますか？

この MCP サーバーを使うと、AI を活用したワークフロー管理が可能になります。

• UI をクリックして操作する代わりに、自然言語コマンドを使えます
• 説明に基づいてワークフローを自動作成できます
• 複数のワークフローにわたる一括操作ができます
• AI アシスタントのワークフローや自動化と連携できます
• AI アシスタントを通じて音声コマンドを使えます
• AI から状況に応じたヘルプや提案を受けられます

🔍 詳細な比較：n8n Web UI、CLI、Zapier、Make.com との詳細な比較については、比較ガイドをご覧ください。

AI でワークフローの作成を自動化できますか？

はい！これは主な機能のひとつです。以下のことができます。

• 自然言語でワークフローを説明して、AI に作成させる
• 要件やユースケースからワークフローを生成する
• 会話形式のコマンドで既存のワークフローを変更する
• ワークフローのテンプレートやバリエーションを自動作成する
• パラメーターを変えて、類似のワークフローをまとめて作成する

💼 実例：さまざまな業界の具体的な自動化例については、ユースケースガイドをご覧ください。

問題やエラーが発生した場合はどうすればよいですか？

よくある解決方法：

1. n8n API キーを確認します - 有効で、適切な権限があることを確認してください
2. n8n インスタンスの URL を確認します - 正しく、アクセス可能であることを確認してください
3. 具体的なエラーメッセージについては、上記のトラブルシューティングのセクションを確認してください
4. 既知の問題と解決方法については、GitHub Issues を確認してください
5. 詳細なログを確認するには、DEBUG=n8n-workflow-builder でデバッグモードを有効にしてください

🔧 詳細なサポート：よくある問題の詳しい解決方法については、トラブルシューティングガイドをご覧ください。

すぐに始めるにはどうすればよいですか？

最速のセットアップ：

1. Smithery.ai のホスト版を使用する（インストール不要）：smithery.ai
2. またはローカルで実行する：npx @makafeli/n8n-workflow-builder
3. n8n の認証情報を使って AI アシスタントを設定する
4. 「ワークフローを一覧表示して」や「ワークフローの詳細を表示して」などの簡単なコマンドから始める

📖 詳細ガイド：手順に沿ったセットアップ方法については、Getting Started Guide をご覧ください。

この MCP サーバーに貢献したり、カスタマイズしたりできますか？

もちろんです！これはオープンソースプロジェクトです：

• リポジトリをフォークしてカスタマイズする
• 改善のためのプルリクエストを送信する
• GitHub で問題を報告したり、機能をリクエストしたりする
• 新しい MCP ツールを追加して機能を拡張する
• ユースケースや例をコミュニティと共有する

🤝 貢献

皆さまからの貢献をお待ちしています！

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

🔗 便利なリンク

• n8n Documentation - n8n の公式ドキュメント
• Model Context Protocol - MCP の仕様
• Claude Desktop - MCP に対応した AI アシスタント
• Cline - VS Code 向け AI アシスタント
• GitHub Repository - ソースコードと課題

---

n8n と MCP のコミュニティのために ❤️ を込めて開発しました

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "n8n Workflow Builder MCP Server",
  "description": "AI assistant integration for n8n workflow automation through the Model Context Protocol (MCP). Connect Claude Desktop, ChatGPT, and other AI assistants to n8n for natural language workflow management.",
  "url": "https://github.com/makafeli/n8n-workflow-builder",
  "downloadUrl": "https://www.npmjs.com/package/@makafeli/n8n-workflow-builder",
  "applicationCategory": "DeveloperApplication",
  "operatingSystem": "Cross-platform",
  "programmingLanguage": "TypeScript",
  "author": {
    "@type": "Person",
    "name": "makafeli",
    "url": "https://github.com/makafeli"
  },
  "license": "https://github.com/makafeli/n8n-workflow-builder/blob/main/LICENSE",
  "keywords": [
    "n8n",
    "MCP",
    "AI assistant",
    "workflow automation",
    "Claude Desktop",
    "ChatGPT",
    "Model Context Protocol"
  ],
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD"
  },
  "softwareRequirements": "Node.js 18.0.0 or higher",
  "releaseNotes": "https://github.com/makafeli/n8n-workflow-builder/releases",
  "codeRepository": "https://github.com/makafeli/n8n-workflow-builder"
}