秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
動態用戶端註冊 (DCR) 可讓外掛程式自動向身分識別提供者註冊 OAuth 用戶端,而無需您事先手動建立用戶端識別碼和密碼。 授權伺服器不會靜態註冊 OAuth 應用程式,並將認證複製到驗證組態中,而是依照 RFC 7591 根據需求發出用戶端認證。
DCR 建置在 OAuth 2.0 授權碼流程上。 與靜態 OAuth 不同,您不需要自行設定重新導向 URI 或用戶端認證 - 企業權杖存放區會註冊用戶端並在幕後處理這些詳細資料。 如需一般 OAuth 概念,請參閱 設定 OAuth 2.0 驗證。
注意
- DCR 支援模型內容通訊協定 (MCP) 外掛程式。
- 尚不支援沒有用戶端密碼的 DCR。 授權伺服器必須在註冊期間發出用戶端密碼。
- 預設情況下,DCR 啟用 PKCE。
警告
DCR 不適用於受 Microsoft Entra ID 保護的 MCP 伺服器。 Microsoft Entra ID 不會發佈 RFC 7591 註冊端點,因此企業權杖存放區沒有任何項目可註冊用戶端。 對於受 Microsoft Entra ID 保護的伺服器,請改為靜態註冊 OAuth 用戶端。 如需詳細資訊,請參閱 設定 OAuth 2.0 驗證。
以兩個步驟設定 DCR:確認先決條件並建立 DCR 驗證設定。
步驟 1:確認必要條件
- 您的 MCP 伺服器會在其
.well-known/oauth-protected-resource端點 (RFC 9728) 公開受 OAuth 2.0 保護的資源中繼資料,並識別保護它的授權伺服器。 - 授權伺服器會在端點 (
.well-known/oauth-authorization-serverRFC 8414) 發佈其中繼資料,包括registration_endpoint,並支援動態用戶端登錄 (RFC 7591) ,以發行用戶端密碼。 Microsoft Entra ID 不會發佈此端點,因此受 Microsoft Entra ID 保護的 MCP 伺服器無法使用 DCR。
步驟 2:建立 DCR 驗證設定
DCR 驗證仰賴驗證設定 (驗證設定) - 儲存在 Microsoft Enterprise 權杖存放區中的記錄,Microsoft 365 Copilot 用來取得並重新整理 MCP 外掛程式的權杖。 針對支援的專業程式碼專案,從 WIQD 開始;工具組和開發人員技能程式仍然可用作為替代方案。
注意
Microsoft Teams 開發人員入口網站尚不支援 DCR。 使用 WIQD MCP 動作工作流程或下列其中一個自動化替代方案。
使用 Work IQ 開發工具 (建議)
搭配伺服器的 HTTPS 端點--mcp-server-url使用 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 為 驗證設定識別碼。
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},