동적 클라이언트 등록 구성

팁

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

DCR(동적 클라이언트 등록)을 사용하면 플러그인에서 클라이언트 ID 및 암호를 미리 수동으로 만들 필요 없이 ID 공급자에 OAuth 클라이언트를 자동으로 등록할 수 있습니다. OAuth 앱을 정적으로 등록하고 자격 증명을 인증 구성에 복사하는 대신, 권한 부여 서버는 RFC 7591에 따라 요청 시 클라이언트 자격 증명을 발급합니다.

DCR은 OAuth 2.0 인증 코드 흐름을 기반으로 합니다. 정적 OAuth와 달리 리디렉션 URI 또는 클라이언트 자격 증명을 직접 구성하지 않습니다. 엔터프라이즈 토큰 저장소에서 클라이언트를 등록하고 이러한 세부 정보를 백그라운드에서 처리합니다. 일반적인 OAuth 개념은 OAuth 2.0 인증 구성을 참조하십시오.

참고

  • DCR은 MCP(Model Context Protocol) 플러그인에서 지원됩니다.
  • 클라이언트 암호가 없는 DCR은 아직 지원되지 않습니다. 권한 부여 서버는 등록하는 동안 클라이언트 암호를 발급해야 합니다.
  • PKCE는 DCR에 대해 기본적으로 사용하도록 설정됩니다.

경고

DCR은 Microsoft Entra ID로 보호되는 MCP 서버에는 사용할 수 없습니다. Microsoft Entra ID는 RFC 7591 등록 엔드포인트를 게시하지 않으므로 엔터프라이즈 토큰 저장소에서 클라이언트를 등록할 항목이 없습니다. Microsoft Entra ID로 보호되는 서버의 경우 대신 OAuth 클라이언트를 정적으로 등록합니다. 자세한 내용은 OAuth 2.0 인증 구성을 참조하세요.

필수 구성 요소를 확인하고 DCR 인증 구성을 만드는 두 단계로 DCR을 구성합니다.

1단계: 필수 조건 확인

  • MCP 서버는 엔드포인트(RFC 9728)에서 .well-known/oauth-protected-resource OAuth 2.0으로 보호된 리소스 메타데이터를 노출하여 이를 보호하는 인증 서버를 식별합니다.
  • 권한 부여 서버는 다음을 포함하여 registration_endpoint엔드포인트(RFC 8414)에서 .well-known/oauth-authorization-server 메타데이터를 게시하고 클라이언트 암호를 발급하는 동적 클라이언트 등록(RFC 7591)을 지원합니다. Microsoft Entra ID는 이 엔드포인트를 게시하지 않으므로 Microsoft Entra ID로 보호되는 MCP 서버는 DCR을 사용할 수 없습니다.

2단계: DCR 인증 구성 만들기

DCR 인증은 Microsoft 365 Copilot이 MCP 플러그 인에 대한 토큰을 가져오고 새로 고치는 데 사용하는 Microsoft Enterprise 토큰 저장소에 저장된 레코드인 인증 구성(인증 구성)에 의존합니다. 지원되는 프로 코드 프로젝트에 대해 WIQD로 시작합니다. 도구 키트 및 개발자 기술 절차는 대안으로 계속 사용할 수 있습니다.

참고

Microsoft Teams 개발자 포털은 아직 DCR을 지원하지 않습니다. WIQD MCP 작업 워크플로 또는 아래의 자동화된 대안 중 하나를 사용하세요.

에서 --mcp-server-url 서버의 HTTPS 엔드포인트와 함께 사용하고 wiqd agent add action 를 선택합니다--mcp-auth-type oauth-dynamic. 서버 및 권한 부여 공급자는 1단계의 메타데이터 및 클라이언트 암호 요구 사항을 충족해야 합니다. DCR은 Microsoft Entra ID로 보호되는 서버에 사용할 수 없습니다.

WIQD MCP 작업 명령 지침을 따라 프로젝트의 프로비저닝 워크플로를 완료합니다. existing-manifest wiqd agent add auth 명령은 DCR 인증 유형을 제공하지 않습니다. 이 체계에는 MCP 작업 경로를 사용합니다.

Microsoft 365 에이전트 도구 키트 사용

Microsoft 365 에이전트 도구 키트에서 MCP 플러그 인을 사용하여 에이전트를 빌드하고 인증 유형으로 동적 클라이언트 등록을 선택하면 추가 입력이 필요하지 않습니다. Agents Toolkit은 MCP 서버의 잘 알려진 엔드포인트에서 등록 세부 정보를 가져오고, 인증 서버에 새 클라이언트를 자동으로 등록하고, 엔터프라이즈 토큰 저장소에 인증 구성을 만들고, 플러그 인 매니페스트에서 런타임 인증 개체 를 업데이트합니다.

선언적 에이전트 개발자 기술 사용

선언적 에이전트 개발자 기술(declarative-agent-developer)은 선언적 에이전트를 빌드하는 데 필요한 지식을 패키지화한 Microsoft Work IQ 의 에이전트 기술입니다. 명령을 실행하거나 매니페스트를 직접 편집하는 대신 Copilot 또는 GitHub CLI에 원하는 내용을 자연어로 설명합니다. 이 기술은 선언적 에이전트를 스캐폴딩하고, MCP 플러그인을 추가하고, 인증 구성을 처리합니다. DCR의 경우 기술은 클라이언트를 등록하고, 엔터프라이즈 토큰 저장소에서 인증 구성을 만들고, 수동 단계 없이 플러그인 매니페스트를 업데이트합니다.

팁

선언적 에이전트 개발자 기술 사용에 대한 비디오 안내는 선언적 에이전트 개발자 기술로 선언적 에이전트 빌드를 참조하세요.

플러그인 매니페스트

이 섹션에서는 참조를 위한 결과 플러그인 매니페스트 구성을 보여줍니다. DCR은 OAuth 2.0 type 과 동일한 런타임 인증 개체를 사용합니다. 속성은 로 설정OAuthPluginVault되고 인증 reference_id구성 ID로 설정됩니다.

"auth": {
  "type": "OAuthPluginVault",
  "reference_id": "auth config ID"
},