MCP 및 API 플러그인 인증 문제 해결

이 문서에서는 Microsoft 365 Copilot에서 실행되는 에이전트에서 MCP(모델 컨텍스트 프로토콜) 및 API 플러그인에 대한 인증을 구성할 때 일반적인 문제와 질문에 대해 설명합니다.

에이전트 응답에서 인증 오류를 보려면 개발자 모드를 사용하도록 설정합니다. 이 문서에 나와 있는 대부분의 오류는 디버그 정보 카드에 나타납니다.

사용자가 로그인할 수 없거나 토큰 교환 실패

OAuth 공급자, 인증 구성 및 플러그인 매니페스트 간의 불일치 값은 로그인 실패의 가장 일반적인 원인입니다. 다음 값을 확인합니다.

  • 인증 구성의 기본 URL은 MCP 플러그인용 플러그인 매니페스트에 있는 MCP 서버 사양 개체의 속성 또는 API 플러그인용 OpenAPI 문서의 배열 항목 servers 과 일치 url 합니다.
  • 리디렉션 URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect 는 OAuth 공급자에 허용된 리디렉션 URI 또는 권한 부여 콜백 URL로 등록됩니다.
  • reference_id 런타임 인증 개체는 Microsoft Teams 개발자 포털에서 생성된 인증 구성 ID와 일치합니다.
  • 앱 제한(앱별 사용 제한) 및 조직 제한(조직별 사용 제한) 설정은 Teams 앱 및 테넌트를 허용합니다.

307 Temporary Redirect 토큰 엔드포인트에서

토큰 끝점에서 HTTP 상태 코드를 반환 307 Temporary Redirect 하는 OAuth 2.0 서버는 지원되지 않습니다. 직접 토큰 엔드포인트를 사용하도록 공급자를 구성합니다.

에이전트를 제거한 후에도 저장된 자격 증명이 유지됨

사용자는 Chat 설정> 에이전트에서 Microsoft 365 Copilot에서 에이전트에서 로그아웃할 수 있습니다. OAuth 2.0의 경우 로그아웃하면 저장된 토큰이 지워집니다. Microsoft Entra SSO의 경우 토큰을 직접 지울 수 없으며 SSO 캐싱, 테넌트 설정 또는 클라이언트 차이로 인해 에이전트가 제거된 후에도 계속 유지될 수 있습니다.

Entra SSO에 대한 재인증을 강제로 적용하려면 Microsoft Graph revokeSignInSessions API를 사용하여 사용자의 동의를 제거하거나 세션을 해지합니다.

MCP 서버 또는 API가 대 리 흐름 을 사용하여 사용자가 동의해야 하는 다른 웹 API에 액세스하는 경우 에이전트가 사용자에게 동의하기 위해 로그인하라는 메시지를 표시하는 오류를 반환 401 Unauthorized 합니다.

또한 다음을 확인합니다.

  • Teams 개발자 포털에서 생성된 애플리케이션 ID URI가 Entra 앱 등록의 identifierUri에 추가됩니다.
  • https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect웹 플랫폼의리디렉션 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(Single Sign-On) 클라이언트 등록을 찾고 플러그인의 앱 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이 인증 결과를 받지 못하는 경우 OAuth 리디렉션 체인 중에 팝업의 window.opener 참조가 제거되었을 수 있습니다. 없으면 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.opener 이 있는 rel="noopener" 앵커 태그. 인증 팝업 내의 탐색에는 사용하지 rel="noopener" 마세요.

이 문제를 해결하려면 팝업 창에서 브라우저의 개발자 도구를 열고 리디렉션 체인의 각 단계에서 콘솔을 입력합니다window.opener. 최종 리디렉션 이전에 반환되는 null 경우 window.opener 이를 지운 페이지를 식별합니다. 체인의 각 페이지에 있는 값에 대한 Cross-Origin-Opener-Policy네트워크 탭 응답 헤더를 검사할 수도 있습니다.

잘못된 자격 증명 오류

로그인 팝업 또는 채팅 응답에 "잘못된 자격 증명" 오류가 표시되는 경우 올바른 자격 증명을 입력했는지 확인합니다. 오류가 지속되면 사용자에게 필요한 권한이 있는지 확인합니다.

로그인 URL을 찾을 수 없음

앱을 제거하고 다시 설치한 다음 다시 로그인해 보세요.

인증 중 내부 서버 오류

인증 팝업에서 세부 정보를 확인하고 권한 문제에 대해 organization의 관리자에게 문의하세요.

권한 또는 비즈니스 타당성을 요청하는 동의 대화 상자가 나타나면 요청된 권한을 검토하고 필요한 경우 비즈니스 타당성을 제공합니다. 확실하지 않거나 동의 대화 상자에서 관리자 동의가 필요한 권한을 요청하는 경우 organization의 관리자에게 문의하세요.