この記事では、Microsoft 365 Copilot で実行されているエージェントでモデル コンテキスト プロトコル (MCP) および API プラグインの認証を構成する際の一般的な問題と質問について説明します。
エージェントの応答で認証エラーを確認するには、 開発者モードを有効にします。 この資料に記載されているエラーの多くは、デバッグ情報カードに表示されます。
- ユーザーがサインインできない、またはトークン交換が失敗する
-
307 Temporary Redirectトークン エンドポイントから - エージェントをアンインストールした後も、保存された資格情報が保持される
- Microsoft Entra SSO の同意が求められない
- 認証構成とプラグイン間のアプリ ID の不一致
- 認証構成のベース URL がプラグインと一致しない
- プラグイン マニフェストの参照 ID が正しくないか見つからない
- 組織のポリシーによりアクセスが制限されている
- サインイン ボタンが非アクティブであるか、一般的なエラーが表示される
- サインイン ポップアップが開けない
- サインイン ポップアップは開くが、スタックするか閉じない
- 資格情報が正しくないエラー
- サインイン URL が見つからない
- 認証中の内部サーバー エラー
- サインイン中に同意ダイアログが表示される
ユーザーがサインインできない、またはトークン交換が失敗する
OAuth プロバイダー、認証構成、およびプラグイン マニフェスト間の値の不一致は、サインイン エラーの最も一般的な原因です。 次の値を確認します。
- 認証構成のベース URL が、MCP プラグインのプラグイン マニフェスト内の MCP サーバー仕様オブジェクトの
urlプロパティ、または API プラグインの OpenAPI ドキュメントのservers配列のエントリと一致します。 - リダイレクト URI
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirectは、許可されたリダイレクト URI または承認コールバック URL として OAuth プロバイダーに登録されます。 -
ランタイム認証オブジェクトの
reference_idは、Microsoft Teams 開発者ポータルによって生成された認証構成 ID と一致します。 - アプリの制限 (アプリによる使用を制限する) と組織の制限 (組織による使用を制限する) 設定により、Teams アプリとテナントが許可されます。
307 Temporary Redirect トークン エンドポイントから
トークン エンドポイントから 307 Temporary Redirect HTTP 状態コードを返す OAuth 2.0 サーバーはサポートされていません。 ダイレクト トークン エンドポイントを使用するようにプロバイダーを構成します。
エージェントをアンインストールした後も、保存された資格情報が保持される
ユーザーは、Microsoft 365 Copilot の [Chat settings>Agents] からエージェントからサインアウトできます。 OAuth 2.0 の場合、サインアウトすると、格納されているトークンがクリアされます。 Microsoft Entra SSO の場合、トークンを直接クリアすることはできず、SSO キャッシュ、テナント設定、またはクライアントの違いにより、エージェントがアンインストールされた後も引き続き保持される可能性があります。
Entra SSO を強制的に再認証するには、Microsoft Graph revokeSignInSessions API を使用してユーザーの同意を削除するか、セッションを取り消します。
Microsoft Entra SSO の同意が求められない
MCP サーバーまたは API が代理フローを使用して、ユーザーに同意を与える必要がある別の Web API にアクセスする場合は、401 Unauthorized エラーを返して、エージェントがユーザーに同意を付与するためにサインインするように求めます。
また、次の点も確認します。
- Teams 開発者ポータルによって生成されたアプリケーション ID URI は、Entra アプリ登録の識別子 URI に追加されます。
-
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectは、Web プラットフォームのリダイレクト URI に追加されます。 - Microsoft Enterprise トークン ストア クライアント ID (
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) が、 API の公開 の下に許可されたクライアント アプリケーションとして追加され、クライアント アプリ ID を検証すると、許可されたトークン対象ユーザーとして追加されます。
認証構成とプラグイン間のアプリ ID の不一致
デバッグ情報カードに次のようなエラーが表示された場合:
OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)
Teams 開発者ポータルに移動します。 OAuth クライアントまたはシングル サインオン (SSO) クライアント登録を検索し、プラグインのアプリ ID が登録されているアプリ ID と一致していることを確認します。
認証構成のベース URL がプラグインと一致しない
デバッグ情報カードに次のようなエラーが表示された場合:
OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)
Teams 開発者ポータルに移動します。 OAuth クライアントまたは SSO クライアントの登録を見つけ、プラグインの MCP サーバー URL が登録されているベース URL と一致していることを確認します。
プラグイン マニフェストの参照 ID が正しくないか見つからない
デバッグ情報カードに次のようなエラーが表示された場合:
OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest
Teams 開発者ポータルに移動します。 OAuth クライアントまたは SSO クライアントの登録を見つけ、MCP サーバーのランタイムの auth.reference_id の ID が Teams 開発者ポータルの認証構成 ID と一致していることを確認します。
組織のポリシーによりアクセスが制限されている
デバッグ情報カードに次のようなエラーが表示された場合:
OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)
organization の管理者に連絡して、アプリのアクセスを確認して有効にしてください。
サインイン ボタンが非アクティブであるか、一般的なエラーが表示される
サインイン ボタンが非アクティブまたは無効になっている場合、またはそれを選択すると一般的な "要求を処理できません" というエラーが表示される場合、この状態は一時的な認証またはセッションの問題を示している可能性があります。 クエリを再試行します。 問題が解決しない場合は、アプリを再インストールするか、organizationの管理者に連絡してください。
サインイン ポップアップが開けない
ブラウザーの設定でサイトのポップアップを有効にして、もう一度お試しください。
サインイン ポップアップは開くが、スタックするか閉じない
サインイン ポップアップが開き、ユーザーが認証を完了するにもかかわらず、ポップアップが閉じず、Copilot が認証結果を受け取らない場合、ポップアップの window.opener 参照が OAuth リダイレクト チェーン中に破棄された可能性があります。
window.openerがないと、ポップアップは認証結果を Copilot に伝えることができません。 キャッシュされた資格情報が window.openerを破棄したページをスキップするため、最初にサインインが失敗するが、再試行では成功するという現象が一般的なものです。
OAuth リダイレクト チェーンの次の項目を確認してください。
-
JavaScript 無効化
window.opener: 一部のログイン ページでは、逆方向のタブナビングに対する包括的なセキュリティ対策としてwindow.opener = nullが設定されています。 認証リダイレクト チェーンのいずれかのページでこのコードが実行されると、ポップアップは Copilot への接続を失います。 タブナビング保護をユーザーが開始したナビゲーションのみに限定し、ポップアップ内のリダイレクト中はwindow.openerをクリアしない。 -
Cross-Origin-Opener-Policyヘッダーをsame-originに設定 : リダイレクト チェーンのいずれかのページがCross-Origin-Opener-Policy: same-origin応答ヘッダーを提供する場合、ブラウザーはクロスオリジン ナビゲーションでのwindow.opener参照を完全に切断します。 OAuth リダイレクト チェーンのすべてのページで、Cross-Origin-Opener-Policyヘッダー (既定値はunsafe-none) を省略するか、明示的にunsafe-noneに設定してください。 -
rel="noopener"を使用したリンク: ターゲット ページからwindow.openerrel="noopener"ストリップを持つアンカー タグ。 認証ポップアップ内のナビゲーションにrel="noopener"を使用しないでください。
この問題をデバッグするには、ポップアップ ウィンドウでブラウザーの開発者ツールを開き、リダイレクト チェーンの各ステップでコンソールに「window.opener」と入力します。
window.openerが最後のリダイレクトの前に null を返す場合は、それをクリアしたページを特定します。 チェーン内の各ページでCross-Origin-Opener-Policy値の [ネットワーク] タブの応答ヘッダーチェックすることもできます。
資格情報が正しくないエラー
サインイン ポップアップまたはチャット応答に "資格情報が正しくありません" というエラーが表示された場合は、正しい資格情報を入力していることを確認してください。 エラーが続く場合は、ユーザーに必要なアクセス許可があることを確認してください。
サインイン URL が見つからない
アプリをアンインストールして再インストールし、サインインを再試行します。
認証中の内部サーバー エラー
認証ポップアップで詳細を確認し、権限の問題についてはorganizationの管理者にお問い合わせください。
サインイン中に同意ダイアログが表示される
アクセス許可またはビジネス上の正当な理由を求める同意ダイアログが表示された場合は、要求されたアクセス許可を確認し、必要に応じてビジネス上の正当な理由を指定します。 不明な場合、または同意ダイアログで管理者の同意が必要なアクセス許可が要求された場合は、organizationの管理者にお問い合わせください。