에이전트에서 MCP 및 API 플러그인에 대한 인증 구성

팁

권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.

Microsoft 365 Copilot의 선언적 에이전트는 API 또는 MCP 플러그 인을 통해 백 엔드 서비스에 연결합니다. 이러한 작업 통합은 에이전트를 MCP(Model Context Protocol) 서버 또는 OpenAPI 문서에서 설명하는 API에 연결합니다. Microsoft 365 Copilot이 로그인한 사용자를 대신하여 올바른 자격 증명을 가져오고 보낼 수 있도록 인증을 구성합니다.

참고

이 문서에서는 선언적 에이전트에 대한 API 또는 MCP 플러그인 매니페스트에서 인증을 구성합니다. 외부 설치 가능 패키지를 구성하지 않습니다. 매니페스트 관계에 대한 플러그인 및 선언적 에이전트 작업을 참조하세요.

인증 연습에서는 MCP 플러그인을 기본 예제로 사용합니다. MCP 플러그인은 에이전트와 서버 자체가 아닌 원격 서버의 통합입니다. 각 문서에 명시된 부분을 제외하고 OpenAPI 문서에서 빌드된 API 플러그 인에는 동일한 구성 단계가 적용됩니다.

지원되는 인증 방식

MCP 서버 또는 API가 엔드포인트를 보호하는 방법과 일치하는 인증 체계를 선택합니다.

인증 체계 MCP 플러그인 API 플러그인 문서
Microsoft Entra SSO(Single Sign-On) 지원 지원 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 서버 구성을 참조하세요.

플러그인 인증 작동 방식

자격 증명이 필요한 체계의 경우 인증 구성 (인증 구성)은 MCP 서버 또는 API에 인증하는 데 필요한 자격 증명 또는 클라이언트 세부 정보를 보유하는 Microsoft Enterprise 토큰 저장소에 저장되는 레코드입니다. 익명 액세스에는 인증 구성이 필요하지 않습니다. 프로젝트에 대해 지원되는 구성 경로를 선택합니다.

  • Work IQ Dev Tools(권장) 를 사용하여 OpenAPI 또는 원격 MCP 작업을 추가할 때 인증을 구성합니다.wiqd agent add action 기존 플러그 인 매니페스트 wiqd agent add auth에서 지원되는 인증 유형을 구성하려면 . 올바른 옵션은 아래 체계별 WIQD 지침을 따른 다음 환경에 대한 에이전트의 프로비저닝 워크플로를 완료합니다.
  • Microsoft 365 에이전트 도구 키트 인증 구성을 만들고 에이전트를 빌드할 때 플러그인 매니페스트를 자동으로 업데이트합니다.
  • 선언적 에이전트 개발자 기술 (MCP 플러그 인만 해당)은 인증 구성을 만들고 자연어 지침에서 매니페스트를 업데이트합니다.
  • Microsoft Teams 개발자 포털을 사용하면 인증 구성을 수동으로 만들거나 에이전트 도구 키트 또는 기술에서 만든 구성을 관리할 수 있습니다.

인증된 구성표의 경우 플러그인 매니페스트는 런타임 인증 개체의 ID로 인증 구성을 참조합니다. 런타임 시 Microsoft 365 Copilot은 인증 구성을 사용하여 토큰 저장소에서 토큰 또는 API 키를 가져오고 플러그 인이 MCP 서버 또는 API를 호출할 때 이를 포함합니다.

선택한 인증 체계에 대한 WIQD 섹션으로 시작합니다. 동일한 문서에서 지원되는 도구 키트, 개발자 기술, 포털 및 수동 대안을 유지합니다.

참고

Cowork를 원격 MCP 서버에 연결하는 플러그인 패키지의 경우 앱 매니페스트의 인증을 따릅니다. 공유 자격 증명 등록 단계로 인해 해당 구성을 에이전트의 MCP 플러그 인 매니페스트 구성과 교환할 수 없습니다. OAuth 공급자가 Microsoft ID 플랫폼을 사용하고 연결에 자동 토큰 새로 고침이 필요한 경우 API별 위임된 범위와 함께 OAuth 구성의 범위 필드에 포함 offline_access 합니다.