ヒント
推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。
Microsoft 365 Copilot の宣言型エージェントは、API または MCP プラグインを介してバックエンド サービスに接続します。 これらのアクション統合により、エージェントは Model Context Protocol (MCP) サーバーまたは OpenAPI ドキュメントによって記述された API に接続されます。 Microsoft 365 Copilot がサインイン ユーザーに代わって適切な資格情報を取得して送信できるように、認証を構成します。
注
この記事では、API または MCP プラグイン マニフェストにおける宣言型エージェントの認証を構成します。 外部のインストール可能パッケージは構成されません。 マニフェスト関係については、 プラグインと宣言型エージェント アクション を参照してください。
認証のチュートリアルでは、既定の例として MCP プラグインを使用します。 MCP プラグインは、サーバー自体ではなく、エージェントとリモート サーバーの統合です。 各記事に記載されている場合を除き、OpenAPI ドキュメントからビルドされた API プラグインにも同じ構成手順が適用されます。
サポートされている認証スキーム
MCP サーバーまたは API がエンドポイントを保護する方法に一致する認証スキームを選択します。
| 認証スキーム | MCP プラグイン | API プラグイン | 記事 |
|---|---|---|---|
| Microsoft Entra シングル サインオン (SSO) | サポートされます | サポートされます | Microsoft Entra SSO 認証を構成する |
| 動的クライアント登録 (DCR) | サポートされている | サポート対象外 | 動的クライアント登録の構成 |
| OAuth 2.0 認証コード フロー | サポートされます | サポートされます | OAuth 2.0 認証を構成する |
| API キー | サポートされていません | サポートされます | API キー認証を構成する |
| 認証なし (匿名) | サポートされます | サポートされます | 認証なしの構成 (匿名) |
注
この表では、宣言型エージェントのアクションとして使用される MCP プラグインと API プラグインについて説明します。 Microsoft 365 アプリ マニフェストの agentConnectors を介してリモート MCP サーバーを参照するプラグインは、別の承認構成を使用します。 そのスキーマには ApiKeyPluginVault が含まれていますが、宣言型エージェント アクションとして使用される MCP プラグインは API キーをサポートしていません。 構成とホストの要件については、「Microsoft 365 Copilot プラグイン用にリモート MCP サーバーを構成する」を参照してください。
プラグイン認証のしくみ
資格情報を必要とするスキームの場合、 認証構成 (auth config) は、MCP サーバーまたは API に対する認証に必要な資格情報またはクライアントの詳細を保持する、Microsoft Enterprise トークン ストアに格納されるレコードです。 匿名アクセスには認証構成は必要ありません。プロジェクトでサポートされている構成パスを選択します。
-
Work IQ Dev Tools (推奨) は、
wiqd agent add actionで OpenAPI またはリモート MCP アクションを追加するときに認証を構成します。 サポートされている認証の種類を既存のプラグイン マニフェストで構成するには、wiqd agent add authを使用します。 以下のスキーム固有の WIQD ガイダンスで正しいオプションを確認してから、環境のためのエージェントのプロビジョニング ワークフローを完了します。 - Microsoft 365 Agents Toolkit では、認証構成が作成され、エージェントのビルド時にプラグイン マニフェストが自動的に更新されます。
- 宣言型エージェントの開発者スキル (MCP プラグインのみ) は、認証構成を作成し、自然言語の命令からマニフェストを更新します。
- Microsoft Teams 開発者ポータルを使用すると 、手動で認証構成を作成したり、エージェント ツールキットまたはスキルで作成した認証構成を管理したりできます。
認証されたスキームの場合、プラグイン マニフェストは ランタイム認証オブジェクトの ID によって認証構成を参照します。 実行時に、Microsoft 365 Copilot は認証構成を使用してトークン ストアからトークンまたは API キーを取得し、プラグインが MCP サーバーまたは API を呼び出すときにそれを含めます。
最初に、選択した認証スキームの WIQD セクションから始めます。 同じ記事でも、ツールキット、開発者スキル、ポータル、および手動の代替手段 (サポートされている場合) が保持されています。
- WIQD を使用して Microsoft Entra SSO 認証を構成する
- WIQD を使用して動的クライアント登録を構成する
- WIQD で OAuth 2.0 認証を構成する
- WIQD を使用した API キー認証の構成
- WIQD を使用して匿名認証を構成する
注
Cowork をリモート MCP サーバーに接続するプラグイン パッケージの場合は、アプリ マニフェストの認証に従います。 共有資格情報の登録手順では、その構成をエージェントの MCP プラグイン マニフェスト構成と交換可能にすることはできません。 OAuth プロバイダが Microsoft ID プラットフォーム を使用し、接続でトークンの自動更新が必要な場合は、API 固有の委任スコープを使用して OAuth 設定の [Scope] フィールドにoffline_accessを含めます。