.claude/skills/integration-patterns/SKILL.md

Integration Patterns スキル

概要

MCP サーバーと外部システム間の統合パターンを提供します。同期・非同期通信、イベント駆動アーキテクチャ、データ同期など、様々な統合シナリオに対応した設計パターンを網羅します。

統合アーキテクチャ概要

┌─────────────────────────────────────────────────────────────┐
│                      MCP クライアント                       │
└─────────────────────────────┬───────────────────────────────┘
                              │
                    MCP プロトコル (JSON-RPC)
                              │
┌─────────────────────────────▼───────────────────────────────┐
│                      MCP サーバー                           │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   Tools     │  │  Resources  │  │   Prompts   │         │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
└─────────┼────────────────┼────────────────┼─────────────────┘
          │                │                │
          ▼                ▼                ▼
┌─────────────────────────────────────────────────────────────┐
│                    統合レイヤー                             │
│  ┌────────────┐  ┌────────────┐  ┌────────────┐            │
│  │ 同期通信   │  │ 非同期通信  │  │ イベント   │            │
│  │ (REST等)   │  │ (Queue等)  │  │ (Webhook等)│            │
│  └──────┬─────┘  └──────┬─────┘  └──────┬─────┘            │
└─────────┼────────────────┼────────────────┼─────────────────┘
          │                │                │
          ▼                ▼                ▼
┌─────────────────────────────────────────────────────────────┐
│                    外部システム                             │
│     REST API    |    Message Queue    |    Webhooks         │
│     Database    |    File System      |    Cloud Services   │
└─────────────────────────────────────────────────────────────┘

1. 同期統合パターン

Request-Response

クライアント → MCPサーバー → 外部API → レスポンス → クライアント

特徴:
- シンプルで直感的
- 即座に結果を取得
- 外部APIの遅延が全体に影響

用途:
- 単純なデータ取得
- CRUD操作
- リアルタイム要件が低い操作

Aggregator

                    ┌──► API A ──┐
クライアント → MCP ─┼──► API B ──┼──► 集約 → クライアント
                    └──► API C ──┘

特徴:
- 複数ソースからのデータ統合
- 並列実行で効率化
- 単一レスポンスに集約

用途:
- ダッシュボードデータ
- 複合検索
- レポート生成

Gateway

クライアント → MCP Gateway → ルーティング → 適切なサービス

特徴:
- 単一エントリーポイント
- 認証・認可の一元化
- プロトコル変換

用途:
- マイクロサービス統合
- レガシーシステムラッピング
- APIバージョン管理

2. 非同期統合パターン

Message Queue

プロデューサー → キュー → コンシューマー

┌─────────┐     ┌─────────┐     ┌─────────┐
│ MCP     │ ──► │  Queue  │ ──► │ Worker  │
│ Server  │     │ (Redis/ │     │ Process │
└─────────┘     │ RabbitMQ)     └─────────┘
                └─────────┘

特徴:
- 疎結合
- スケーラビリティ
- 信頼性（再試行可能）

用途:
- 長時間実行タスク
- バッチ処理
- 負荷分散

Pub/Sub

パブリッシャー → トピック → 複数サブスクライバー

┌─────────┐     ┌─────────┐     ┌─────────┐
│ MCP     │ ──► │  Topic  │ ──► │ Service │
│ Server  │     │         │ ──► │ Service │
└─────────┘     └─────────┘ ──► │ Service │
                                └─────────┘

特徴:
- 1対多の通信
- 動的なサブスクリプション
- イベントブロードキャスト

用途:
- リアルタイム通知
- ログ/監査
- システム間同期

Saga Pattern

トランザクション全体を補償可能なステップに分割

Step 1 → Step 2 → Step 3 → 完了
    ↓ 失敗     ↓ 失敗     ↓ 失敗
Compensate ← Compensate ← Compensate

特徴:
- 分散トランザクション
- 各ステップが独立
- 補償アクションで整合性維持

用途:
- オーダー処理
- 予約システム
- 複数サービス連携

3. イベント駆動パターン

Event Sourcing

イベント1 → イベント2 → イベント3 → 現在の状態

すべての状態変更をイベントとして保存

特徴:
- 完全な監査証跡
- 時間旅行（状態復元）
- デバッグ容易性

用途:
- 金融システム
- コンプライアンス要件
- 複雑なビジネスロジック

CQRS (Command Query Responsibility Segregation)

┌─────────────────┐
│    Commands     │ ──► Write Model ──► Event Store
└─────────────────┘
┌─────────────────┐
│     Queries     │ ──► Read Model  ──► 最適化されたビュー
└─────────────────┘

特徴:
- 読み書きの最適化
- スケーラビリティ
- 複雑さの分離

用途:
- 高負荷システム
- 複雑なクエリ要件
- イベントソーシングとの組み合わせ

Webhook

外部イベント → Webhook → MCP サーバー → 処理

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  External   │ ──► │  Webhook    │ ──► │    MCP      │
│  Service    │     │  Endpoint   │     │   Server    │
└─────────────┘     └─────────────┘     └─────────────┘

特徴:
- プッシュ型通知
- リアルタイム
- ポーリング不要

用途:
- GitHub イベント
- 支払い完了通知
- サードパーティ統合

4. データ同期パターン

Change Data Capture (CDC)

データベース変更 → キャプチャ → 伝播

┌─────────┐     ┌─────────┐     ┌─────────┐
│   DB    │ ──► │   CDC   │ ──► │ Target  │
│ Source  │     │ (Debezium)    │ System  │
└─────────┘     └─────────┘     └─────────┘

特徴:
- リアルタイム同期
- 低オーバーヘッド
- 完全性保証

用途:
- データレプリケーション
- キャッシュ無効化
- 検索インデックス更新

Two-Phase Commit

Phase 1: Prepare
  Coordinator → 全参加者に準備要求
  参加者 → 準備完了または拒否

Phase 2: Commit/Rollback
  Coordinator → 全員準備完了なら Commit
            → 1つでも失敗なら Rollback

特徴:
- 強い一貫性
- 分散トランザクション
- ブロッキング

用途:
- 銀行振込
- 在庫管理
- 厳密な整合性要件

Eventual Consistency

更新 → 伝播（非同期）→ 最終的に一貫

特徴:
- 高可用性
- パーティション耐性
- 一時的な不整合を許容

用途:
- SNSフィード
- 分散キャッシュ
- グローバルシステム

5. 統合パターン選択ガイド

要件別推奨パターン

判断フローチャート

同期が必要？
├── Yes → レスポンス時間 < 3秒？
│         ├── Yes → Request-Response
│         └── No  → Polling / Long-polling
└── No  → 順序保証必要？
          ├── Yes → Message Queue (FIFO)
          └── No  → Pub/Sub

6. 実装チェックリスト

同期統合

• タイムアウト設定は適切？
• リトライロジックは実装？
• サーキットブレーカーは導入？
• エラーハンドリングは網羅？

非同期統合

• メッセージの永続化？
• 重複処理対策（冪等性）？
• Dead Letter Queue？
• 監視・アラート設定？

イベント駆動

• イベントスキーマはバージョン管理？
• 順序保証は必要？実装済み？
• イベント再生機能？
• 失敗イベントのリカバリー？

リソース参照

詳細なパターンとガイドについては以下を参照:

• 同期統合パターン詳細: cat .claude/skills/integration-patterns/resources/sync-patterns.md
• 非同期統合パターン詳細: cat .claude/skills/integration-patterns/resources/async-patterns.md
• イベント駆動設計ガイド: cat .claude/skills/integration-patterns/resources/event-driven-guide.md

テンプレート参照

• 統合設計テンプレート: cat .claude/skills/integration-patterns/templates/integration-design-template.md
• メッセージスキーマテンプレート: cat .claude/skills/integration-patterns/templates/message-schema-template.json

スクリプト実行

# 統合設計のレビュー
node .claude/skills/integration-patterns/scripts/review-integration-design.mjs <design.md>

# メッセージスキーマ検証
node .claude/skills/integration-patterns/scripts/validate-message-schema.mjs <schema.json>

関連スキル