Power Platform MCP コネクタジェネレータ

Model Context Protocol (MCP) 統合を備えた完全な Power Platform カスタムコネクタを生成します。このプロンプトは、MCP ストリーミング対応 HTTP をサポートする Power Platform コネクタ標準に従うすべての必要なファイルを作成します。

手順

以下を実装する完全な MCP サーバーを作成します:

1. Copilot Studio MCP パターンを使用:

   • x-ms-agentic-protocol: mcp-streamable-1.0 を実装
   • JSON-RPC 2.0 通信プロトコルをサポート
   • /mcp でストリーミング対応 HTTP エンドポイントを提供
   • Power Platform コネクタ構造に従う

2. スキーマコンプライアンス要件:

   • 参照型を使用しない ツール入出力内 (Copilot Studio によってフィルタリング)
   • 単一型の値のみ (複数型の配列ではなく)
   • enum 入力を避ける (文字列として解釈され、enum ではない)
   • プリミティブ型を使用: string、number、integer、boolean、array、object
   • すべてのエンドポイントが完全な URI を返すことを確認

3. 含める MCP コンポーネント:

   • Tools: 言語モデルが呼び出せる関数 (✅ Copilot Studio でサポート)
   • Resources: ツールからのファイル的データ出力 (✅ Copilot Studio でサポート - アクセス可能にするにはツール出力である必要あり)
   • Prompts: 特定のタスク用の事前定義テンプレート (❌ Copilot Studio でまだサポートされていません)

4. 実装構造:

   /apiDefinition.swagger.json  (Power Platform コネクタスキーマ)
   /apiProperties.json         (コネクタメタデータと設定)
   /script.csx                 (カスタムコード変換とロジック)
   /server/                    (MCP サーバー実装)
   /tools/                     (個別 MCP ツール)
   /resources/                 (MCP リソースハンドラー)
   

コンテキスト変数

• Server Purpose: [MCP サーバーが達成すべき内容を説明]
• Tools Needed: [実装する特定のツールのリスト]
• Resources: [提供するリソースのタイプ]
• Authentication: [認証方法: none、api-key、oauth2]
• Host Environment: [Azure Function、Express.js、FastAPI など]
• Target APIs: [統合する外部 API]

期待される出力

生成:

1. apiDefinition.swagger.json (以下を含む):

   • 適切な x-ms-agentic-protocol: mcp-streamable-1.0
   • POST /mcp での MCP エンドポイント
   • コンプライアント スキーマ定義 (参照型なし)
   • McpResponse と McpErrorResponse 定義

2. apiProperties.json (以下を含む):

   • コネクタメタデータとブランディング
   • 認証設定
   • 必要に応じてポリシーテンプレート

3. script.csx (以下を含む):

   • リクエスト/レスポンス変換用のカスタム C# コード
   • MCP JSON-RPC メッセージ処理ロジック
   • データ検証と処理関数
   • エラーハンドリングとログ機能

4. MCP サーバーコード (以下を含む):

   • JSON-RPC 2.0 リクエストハンドラー
   • ツール登録と実行
   • リソース管理 (ツール出力として)
   • 適切なエラーハンドリング
   • Copilot Studio 互換性チェック

5. 個別ツール (以下の条件を満たす):

   • プリミティブ型入力のみを受け付ける
   • 構造化出力を返す
   • 必要に応じて出力にリソースを含める
   • Copilot Studio 用に明確な説明を提供

6. デプロイメント設定 (以下を含む):

   • Power Platform 環境
   • Copilot Studio エージェント統合
   • テストと検証

検証チェックリスト

生成されたコードが以下を確認:

• スキーマに参照型がない
• すべての型フィールドが単一型
• enum の処理を検証付き文字列で行う
• リソースがツール出力経由でアクセス可能
• 完全な URI エンドポイント
• JSON-RPC 2.0 準拠
• 適切な x-ms-agentic-protocol ヘッダー
• McpResponse/McpErrorResponse スキーマ
• Copilot Studio 用のクリアなツール説明
• 生成型オーケストレーション互換

使用例

Server Purpose: 顧客データ管理と分析
Tools Needed: 
  - searchCustomers
  - getCustomerDetails
  - analyzeCustomerTrends
Resources:
  - Customer profiles
  - Analysis reports
Authentication: oauth2
Host Environment: Azure Function
Target APIs: CRM System REST API