Power Platform MCP Connector Suite

Model Context Protocol 統合を備えた包括的な Power Platform カスタムコネクタ実装を生成し、Microsoft Copilot Studio に対応させます。

Copilot Studio での MCP 機能

現在対応しているもの:

• ✅ Tools: LLM が呼び出せる関数（ユーザー承認が必要）
• ✅ Resources: エージェントが読み取り可能なファイル形式のデータ（ツールの出力である必要があります）

まだ対応していないもの:

• ❌ Prompts: 事前に作成されたテンプレート（将来の対応に向けて準備中）

コネクタの生成

以下を含む完全な Power Platform コネクタを作成します:

コアファイル:

• apiDefinition.swagger.json with x-ms-agentic-protocol: mcp-streamable-1.0
• apiProperties.json with コネクタメタデータと認証
• script.csx MCP JSON-RPC ハンドリング用のカスタム C# 変換
• readme.md コネクタドキュメント

MCP 統合:

• JSON-RPC 2.0 通信用の POST /mcp エンドポイント
• McpResponse および McpErrorResponse スキーマ定義
• Copilot Studio 制約準拠（参照タイプなし、単一型）
• ツール出力としてのリソース統合（Resources と Tools 対応；Prompts はまだ未対応）

スキーマ検証とトラブルシューティング

Copilot Studio 準拠のスキーマを検証:

• ✅ ツール入出力に参照タイプ（$ref）がない
• ✅ 単一型値のみ（["string", "number"] ではない）
• ✅ プリミティブ型: string、number、integer、boolean、array、object
• ✅ ツール出力としてのリソース、独立したエンティティではない
• ✅ すべてのエンドポイントで完全な URI

よくある問題と解決方法:

• Tools がフィルタリングされた → 参照タイプを削除、プリミティブ型を使用
• 型エラー → 検証ロジック付きの単一型
• Resources が利用できない → ツール出力に含める
• 接続失敗 → x-ms-agentic-protocol ヘッダを確認

コンテキスト変数

• Connector Name: [コネクタの表示名]
• Server Purpose: [MCP サーバーの目的]
• Tools Needed: [実装する MCP ツールのリスト]
• Resources: [提供するリソースの種類]
• Authentication: [none、api-key、oauth2、basic]
• Host Environment: [Azure Function、Express.js など]
• Target APIs: [統合する外部 API]

生成モード

モード 1: 完全な新規コネクタ

CLI 検証セットアップを含むまったく新しい Power Platform MCP コネクタのすべてのファイルを生成します。

モード 2: スキーマ検証

paconn および検証ツールを使用して、既存のスキーマを分析し Copilot Studio 準拠にします。

モード 3: 統合トラブルシューティング

CLI デバッグツールを使用して MCP と Copilot Studio の統合問題を診断・解決します。

モード 4: ハイブリッドコネクタ

適切な検証ワークフロー付きで、既存の Power Platform コネクタに MCP 機能を追加します。

モード 5: 認定準備

完全なメタデータと検証準拠で、Microsoft 認定提出用にコネクタを準備します。

モード 6: OAuth セキュリティ強化

MCP セキュリティベストプラクティスと高度なトークン検証が強化された OAuth 2.0 認証を実装します。

想定される出力

1. apiDefinition.swagger.json

• Microsoft 拡張機能付き Swagger 2.0 形式
• MCP エンドポイント: 適切なプロトコルヘッダ付き POST /mcp
• 準拠スキーマ定義（プリミティブ型のみ）
• McpResponse/McpErrorResponse 定義

2. apiProperties.json

• コネクタメタデータとブランディング（iconBrandColor 必須）
• 認証構成
• MCP 変換用のポリシーテンプレート

3. script.csx

• JSON-RPC 2.0 メッセージハンドリング
• リクエスト/レスポンス変換
• MCP プロトコル準拠ロジック
• エラーハンドリングと検証

4. 実装ガイダンス

• ツール登録と実行パターン
• リソース管理戦略
• Copilot Studio 統合ステップ
• テストと検証手順

検証チェックリスト

技術的準拠性

• MCP エンドポイントに x-ms-agentic-protocol: mcp-streamable-1.0 がある
• すべてのスキーマ定義に参照タイプがない
• すべての type フィールドが単一型（配列ではない）
• ツール出力に Resources が含まれている
• script.csx で JSON-RPC 2.0 準拠
• 全体を通じて完全な URI エンドポイント
• Copilot Studio エージェント用に明確な説明
• 認証が適切に設定されている
• MCP 変換用のポリシーテンプレート
• Generative Orchestration 互換性

CLI 検証

• paconn validate: paconn validate --api-def apiDefinition.swagger.json がエラーなしで通過
• pac CLI 準備完了: pac connector create/update でコネクタ作成/更新可能
• スクリプト検証: script.csx が pac CLI アップロード時の自動検証に通過
• パッケージ検証: ConnectorPackageValidator.ps1 が正常に実行

OAuth とセキュリティ要件

• OAuth 2.0 強化版: MCP セキュリティベストプラクティス実装付き標準 OAuth 2.0
• トークン検証: パススルー攻撃を防止するトークンオーディエンス検証の実装
• カスタムセキュリティロジック: MCP 準拠用の script.csx での検証強化
• State パラメータ保護: CSRF 防止用のセキュアな state パラメータ
• HTTPS 強制: すべての本番環境エンドポイントで HTTPS のみ使用
• MCP セキュリティプラクティス: OAuth 2.0 内での confused deputy 攻撃防止実装

認定要件

• 完全なメタデータ: 製品とサービス情報を含む settings.json
• アイコン準拠: PNG 形式、230x230 または 500x500 ピクセル
• ドキュメント: 包括的な例を含む認定対応 readme
• セキュリティ準拠: MCP セキュリティプラクティス強化版 OAuth 2.0、プライバシーポリシー
• 認証フロー: カスタムセキュリティ検証が適切に設定された OAuth 2.0

使用例

Mode: Complete New Connector
Connector Name: Customer Analytics MCP
Server Purpose: Customer data analysis and insights
Tools Needed:
  - searchCustomers: Find customers by criteria
  - getCustomerProfile: Retrieve detailed customer data
  - analyzeCustomerTrends: Generate trend analysis
Resources:
  - Customer profiles (JSON data)
  - Analysis reports (structured data)
Authentication: oauth2
Host Environment: Azure Function
Target APIs: CRM REST API