power-platform-mcp-connector-suite

Power Platform MCP コネクタースイート

Microsoft Copilot Studio 向けの Model Context Protocol 統合を備えた、包括的な Power Platform カスタムコネクター実装を生成します。

Copilot Studio における MCP 機能

現在サポートされているもの:

• ✅ ツール: LLM が呼び出せる関数（ユーザーの承認あり）
• ✅ リソース: エージェントが読み取れるファイルのようなデータ（ツールの出力である必要があります）

まだサポートされていないもの:

• ❌ プロンプト: あらかじめ作成されたテンプレート（将来のサポートに備えてください）

コネクターの生成

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

コアファイル:

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

MCP 統合:

• JSON-RPC 2.0 通信のための POST /mcp エンドポイント
• McpResponse および McpErrorResponse スキーマ定義
• Copilot Studio の制約への準拠（参照型なし、単一型）
• ツール出力としてのリソース統合（リソースとツールはサポート済み、プロンプトは未サポート）

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

Copilot Studio の準拠に向けてスキーマを検証します:

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

よくある問題と修正:

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

コンテキスト変数

• コネクター名: [コネクターの表示名]
• サーバーの目的: [MCP サーバーが達成すべきこと]
• 必要なツール: [実装する MCP ツールのリスト]
• リソース: [提供するリソースの種類]
• 認証: [none、api-key、oauth2、basic]
• ホスト環境: [Azure Function、Express.js など]
• 対象 API: [統合する外部 API]

生成モード

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

新しい Power Platform MCP コネクターのすべてのファイルをゼロから生成します。CLI 検証のセットアップも含みます。

モード 2: スキーマ検証

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

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

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

モード 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 を記載
• すべてのスキーマ定義に参照型を使用していない
• すべての型フィールドが単一の型である（配列ではない）
• リソースがツールの出力として含まれている
• script.csx で JSON-RPC 2.0 に準拠している
• 全体を通して完全な URI エンドポイントを使用している
• Copilot Studio エージェント向けの明確な説明がある
• 認証が適切に構成されている
• MCP 変換用のポリシーテンプレートがある
• 生成オーケストレーションとの互換性がある

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