MCP サーバーの構築または再利用

コンポーネント プランからの MCP サーバーの決定を使用して、リモートでホストされるツールまたはリソースを提供します。 実行中の MCP サーバーはプラグイン パッケージから分離されたままであるため、リモート ランタイムとターゲット Microsoft エクスペリエンスへのサポートされている接続の両方を実装または確認する必要があります。

MCP サーバーを再利用する

サーバーを構築する前に:

  1. 必要なツールまたはリソースを公開する承認済みの MCP サーバーを特定します。
  2. ツール定義、入力、出力、エラー、注釈、確認動作を確認します。
  3. そのトランスポート、認証モデル、およびプロトコル機能が対象の Microsoft エクスペリエンスでサポートされていることを確認します。
  4. サーバーの所有者、エンドポイント、バージョン、可用性、データ処理、サポート、および変更プロセスを確認します。
  5. アクセス権を取得し、開発またはテスト接続を構成します。
  6. 代表者の検出、認証、呼び出し、および障害シナリオをテストします。

MCP サーバーを参照しても、そのサーバーの運用責任は転送されません。 再利用する前に、サービス所有者とサポート契約を記録します。

MCP サーバーを構築して運用する

要件を満たす承認済みサーバーがない場合は、新しい MCP サーバーを構築します。

  1. コンポーネント プランで必要なツールとリソースのみを実装します。
  2. 明確な名前、説明、入力、出力、エラー、および安全注釈を定義します。
  3. 認証、承認、データ アクセス、最小特権動作を実装します。
  4. ホスティング、ネットワーク、シークレット、ログ、監視、スケーリング、インシデント対応を構成します。
  5. プロトコルの動作とドキュメントの互換性に関する期待をバージョン管理します。
  6. サーバーを Microsoft エクスペリエンスに接続する前に、サーバーを個別にテストします。

GitHub Copilot は、サーバー コード、スキーマ、テスト、リポジトリの変更を支援できます。 MCP ランタイム、ホスティング、認証、または Microsoft 365 接続は、単独では提供されません。

サーバーに接続する

選択した開発ツールとターゲット エクスペリエンスでサポートされている統合を使用します。

注

WIQD を使用して、リモート MCP サーバーを参照するプラグインを作成します。 Microsoft 365 アプリ マニフェストの agentConnectors 配列を使用した手動構成については、「Microsoft 365 Copilot プラグイン用にリモート MCP サーバーを構成する」を参照してください。 この構成は、宣言型エージェント アクションに使用される MCP プラグイン マニフェストとは異なります。 サポートはターゲット エクスペリエンスによって異なります。

開発アプローチ 次から始める
Work IQ 開発ツール (サポートされているプロコード シナリオにおすすめ) Work IQ Dev Tools を使用してプラグインを構築します。エージェント アクションの場合は、WIQD エージェント アクション ワークフローを使用します
Agents Toolkit を使用した既存の宣言型エージェント プロジェクト Toolkit ベースの MCP 統合の詳細手順
Copilot Studio Microsoft Copilot Studio ドキュメント
対話型 MCP 応答 宣言型エージェントに MCP アプリを追加する
Agent 365 CLI を使用した BYO リモート MCP サーバーの登録 エージェント ツールでリモート MCP サーバーを登録する

重要

Agent 365 CLI BYO MCPルートはプレビュー段階であり、Microsoft 365宣言型エージェント用にパッケージ化されたMCPプラグインとは別の登録および管理モデルを使用します。 文書化されているサポートされているクライアントは、Copilot Studio、Visual Studio Code、Claude Code、GitHub Copilot CLI です。 Microsoft 365 宣言型エージェントは、このルートではサポートされていません。 管理者はエージェント ツールを使用して、登録済みサーバーを確認、承認、同意、ブロック、監視します。

Work IQ 開発ツール

wiqd plugin add connector コマンドは、リモート MCP コネクタを WIQD プラグイン パッケージに追加します。 文書化されたサーバー要件には以下が含まれます。

  • TLS 1.2 以降を使用した HTTPS。
  • JSON-RPC 2.0 を使用したストリーミング可能な HTTP トランスポート。
  • tools/listとtools/callのサポート。
  • 30 秒未満で完了するツール呼び出し。

マニフェスト バージョン 1.29 に対する WIQD スキャフォールド ( mcpToolDescription は省略可能です)。 ツール記述ファイルを含める場合は、必要なコネクタ オプションと共に wiqd plugin add connector --tool-description <relative-file-path> を使用して、appPackageを基準としたそのパスを渡します。 参照先のファイルは ZIP に含める必要があります。 現在の Cowork 検出の動作とパッケージの要件については、「Copilot Cowork プラグインのビルド」を参照してください。

OAuth または API キー認証の場合は、最初に資格情報を登録し、その参照識別子のみをパッケージに追加します。 クライアント シークレット、API キー、またはトークンをマニフェストに入れないでください。 WIQD プラグイン作成リファレンスを参照してください。

WIQD プラグイン パッケージ ルートの場合、 Microsoft 365 アプリ マニフェストで認証とツール検出を構成します。 代わりに、サーバーを MCP アクションとして宣言型エージェントに追加する場合は、 エージェント アクション 認証と 動的検出、またはエージェントに固定されたツールを使用します。 マニフェスト モデル間で構成をコピーするのではなく、選択した統合の要件に従います。

MCP 機能が機能していることを確認する

MCP サーバーとその接続は、次の場合に統合の準備が整います。

  • エンドポイントは、開発環境またはテスト環境から使用できます。
  • 必要なツールまたはリソースは、ターゲット エクスペリエンスによって検出できます。
  • 代表的な操作は、期待される構造化された結果を返します。
  • 認証、承認、同意、およびアクセス許可は、意図したとおりに機能します。
  • 確認、タイムアウト、サービス利用不可、入力が無効、部分的な失敗の動作は理解できます。
  • ログと監視は、障害を診断するのに十分な情報を提供します。
  • サーバーの所有者、バージョン、エンドポイント、ホスティング、依存関係、制限事項、およびテストの証拠が記録されます。

開発中にサーバーに一般にアクセスできない場合は、 ローカル MCP と API デバッグ を使用します。

プラン内の他のコンポーネントを続行します。 完成したら、 コンポーネントを統合してテストします。