# Product Overview
## Product Purpose
**n8n MCP Server**は、AI モデルが n8n ワークフロー自動化プラットフォームにアクセスできるようにする Model Context Protocol (MCP) サーバーです。標準化された MCP インターフェースを通じて、AI モデルに包括的な n8n ワークフロー管理機能を提供します。
**Vision (North Star)**:
AI アシスタントが自然言語でワークフロー自動化を実現できる未来を作る。開発者やビジネスユーザーが、コードを書くことなく AI と対話するだけで複雑な自動化ワークフローを構築・管理できるようにする。
**解決する問題**:
- **ワークフロー管理の複雑性**: n8n の UI や API を直接操作する必要があり、学習コストが高い
- **AI との統合不足**: AI モデルがワークフロー自動化システムに直接アクセスできない
- **コンテキストの非効率性**: n8n API のレスポンスは冗長で、AI モデルのトークン制限に適していない
- **開発者の生産性**: ワークフロー作成・管理を自然言語で行えず、手作業が多い
## Target Users
**Primary Archetype**: AI 駆動開発を行う開発者・エンジニア
- Claude Desktop などの AI アシスタントツールを日常的に使用
- ワークフロー自動化（n8n）の知識を持つが、より効率的な管理方法を求めている
- ノーコード/ローコードツールと AI を組み合わせた生産性向上に関心がある
**Secondary Archetype**: ビジネス自動化を推進するノンプログラマー
- n8n を使った業務自動化を実施しているが、複雑な操作に課題を感じている
- AI アシスタントに自然言語で指示を出してワークフローを管理したい
**ニーズと課題**:
- **ニーズ**: AI アシスタント経由でワークフローを簡単に作成・管理したい
- **課題**: n8n API の複雑さ、レスポンスデータの冗長性、AI モデルとの統合不足
## Key Features
このプロジェクトが提供する主要機能：
1. **完全なワークフロー管理 (CRUD)**:
- ワークフロー作成、読み取り、更新、削除
- ノード接続の可視化 (`get_workflow_connections`)
- ファイルからのワークフローインポート (`create_workflow_from_file`, `replace_workflow_from_file`)
2. **実行監視とデバッグ (Progressive Execution Loading)**:
- 実行履歴の取得 (`list_executions`)
- 実行サマリーの取得 (`get_execution`)
- ノード別の詳細実行データ取得 (`get_execution_by_node`)
- エラー特定と段階的データロード
3. **AI 最適化レスポンス**:
- コンテキスト削減（60-90%の削減率）
- `raw` オプションによる柔軟なレスポンスモード
- 必須情報のみを含むミニマルレスポンス
4. **柔軟な認証・トランスポート**:
- API キー認証
- stdio トランスポート（MCP クライアント用）
- HTTP トランスポート（開発・テスト用）
5. **包括的なエラーハンドリング**:
- 構造化されたエラーレスポンス
- 意味のあるエラーメッセージ
- n8n API 制約に対応した適切なエラー処理
## Business Objectives
- **開発者生産性の向上**: ワークフロー管理の時間を削減
- **AI エコシステムの拡大**: MCP 標準を通じた n8n と AI ツールの統合
- **ユーザー体験の改善**: 自然言語でのワークフロー管理を実現
## Success Metrics
**Qualitative Metrics**:
- **使いやすさ**: セットアップの容易性、ドキュメントの明確性
- **信頼性**: エラーハンドリングの適切性、エラーメッセージの分かりやすさ
## Product Principles
1. **AI ファースト設計**: AI モデルのトークン制限とコンテキスト効率を最優先
2. **段階的情報開示**: Progressive Execution Loading など、必要な情報を必要な時に提供
3. **開発者体験優先**: セットアップが簡単で、ドキュメントが充実している
4. **標準準拠**: MCP プロトコルに完全準拠し、相互運用性を確保
5. **実用性重視**: 実際に使われる機能を優先し、過度な抽象化を避ける（YAGNI 原則）
## Non-Goals / Guardrails
このプロジェクトは以下の領域には**意図的に関与しない**：
- **n8n 本体の機能拡張**: n8n のコア機能やノード開発は対象外（n8n プロジェクトの管轄）
- **独自の認証システム**: n8n API の認証方式に依存し、独自の認証層は提供しない
- **ワークフロー実行エンジン**: ワークフローの実行は n8n に委譲し、独自の実行エンジンは持たない
- **UI/フロントエンド**: MCP サーバーとしてのみ機能し、独自の UI は提供しない
- **他の自動化プラットフォーム**: n8n 専用であり、Zapier, Make.com などの他プラットフォームはサポート対象外
- **エンタープライズ機能**: SSO, RBAC, 監査ログなどはエンタープライズ版 n8n の管轄
