Configurar el registro de cliente dinámico

Recomendación

Recomendado: Comience con las herramientas de desarrollo de Work IQ para escenarios de complemento y agente declarativo de código profesional compatibles. Consulte el inicio rápido de WIQD. Las instrucciones basadas en el kit de herramientas siguen estando disponibles para los proyectos existentes y los flujos de trabajo que las requieren. Compruebe la compatibilidad con la capacidad y la experiencia de destino antes de elegir una herramienta: WIQD no se dirige a agentes de motor personalizados.

El registro dinámico de clientes (DCR) permite que un complemento registre automáticamente un cliente OAuth con su proveedor de identidad, sin necesidad de crear manualmente un identificador de cliente y un secreto con antelación. En lugar de registrar estáticamente una aplicación OAuth y copiar las credenciales en una configuración de autenticación, el servidor de autorización emite credenciales de cliente a petición siguiendo RFC 7591.

DCR se basa en el flujo de código de autorización de OAuth 2.0. A diferencia del OAuth estático, usted mismo no configura un URI de redireccionamiento o credenciales de cliente: el almacén de tokens empresariales registra el cliente y controla esos detalles en segundo plano. Para obtener conceptos generales de OAuth, consulte Configurar la autenticación de OAuth 2.0.

Nota

  • DCR es compatible con complementos de Protocolo de contexto de modelo (MCP).
  • DCR sin un secreto de cliente aún no se admite. El servidor de autorización debe emitir un secreto de cliente durante el registro.
  • PKCE está habilitado de forma predeterminada para DCR.

Advertencia

DCR no está disponible para un servidor MCP protegido por Microsoft Entra ID. Microsoft Entra ID no publica un punto de conexión de registro RFC 7591, por lo que no hay nada para que el almacén de tokens empresariales registre un cliente. Para un servidor que esté protegido por Microsoft Entra ID, registre el cliente OAuth estáticamente en su lugar. Para obtener más información, consulte Configuración de la autenticación de OAuth 2.0.

Configure DCR en dos pasos: confirme los requisitos previos y cree la configuración de autenticación DCR.

Paso 1: Confirmar los requisitos previos

  • El servidor MCP expone los metadatos de recursos protegidos de OAuth 2.0 en su .well-known/oauth-protected-resource punto de conexión (RFC 9728), lo que identifica el servidor de autorización que los protege.
  • El servidor de autorización publica sus metadatos en el punto de conexión (RFC 8414), incluido un registration_endpoint, y admite el .well-known/oauth-authorization-server registro dinámico de clientes (RFC 7591) que emite un secreto de cliente. Microsoft Entra ID no publica este punto de conexión, por lo que un servidor MCP protegido por Microsoft Entra ID no puede usar DCR.

Paso 2: Crear la configuración de autenticación DCR

La autenticación DCR se basa en una configuración de autenticación (configuración de autenticación): un registro almacenado en el almacén de tokens de Microsoft Enterprise que Microsoft 365 Copilot usa para obtener y actualizar tokens para el complemento MCP. Comience con WIQD para un proyecto pro-code compatible; el Kit de herramientas y los procedimientos de habilidades para desarrolladores siguen disponibles como alternativas.

Nota

El portal para desarrolladores de Microsoft Teams aún no admite DCR. Utilice el flujo de trabajo de acción WIQD MCP o una de las alternativas automatizadas a continuación.

Úselo wiqd agent add action con el punto de conexión HTTPS del servidor y --mcp-server-url seleccione --mcp-auth-type oauth-dynamic. El servidor y el proveedor de autorización deben cumplir los requisitos de metadatos y secretos de cliente del paso 1. DCR no está disponible para un servidor protegido por Microsoft Entra ID.

Siga las instrucciones del comando de acción WIQD MCP y complete el flujo de trabajo de aprovisionamiento del proyecto. El comando existing-manifest wiqd agent add auth no ofrece un tipo de autenticación DCR; use la ruta de acción MCP para este esquema.

Usar Microsoft 365 Agents Toolkit

Al crear un agente con un complemento de MCP en Microsoft 365 Agents Toolkit y seleccionar el registro de cliente dinámico como tipo de autenticación, no es necesario realizar ninguna entrada adicional. Agents Toolkit obtiene los detalles de registro del punto final conocido de su servidor MCP, registra automáticamente un nuevo cliente con el servidor de autorización, crea la configuración de autenticación en el almacén de tokens empresariales y actualiza el objeto de autenticación en tiempo de ejecución en el manifiesto del complemento.

Use la aptitud de desarrollador de agente declarativo

La aptitud de desarrollador de agente declarativo (declarative-agent-developer) es una aptitud de agente de Microsoft Work IQ que reúne los conocimientos necesarios para crear agentes declarativos. En lugar de ejecutar comandos o editar manifiestos usted mismo, describa lo que quiere Copilot o la CLI de GitHub en lenguaje natural. La aptitud aplica scaffolding al agente declarativo, agrega el complemento MCP y controla la configuración de autenticación por usted. Para DCR, la aptitud registra el cliente, crea la configuración de autenticación en el almacén de tokens de empresa y actualiza el manifiesto del complemento sin pasos manuales.

Recomendación

Para ver un vídeo tutorial sobre el uso de la aptitud de desarrollador de agente declarativo, consulte Creación de agentes declarativos con la aptitud de desarrollador de agente declarativo.

Manifiesto de complemento

En esta sección se muestra la configuración del manifiesto de complemento resultante como referencia. DCR utiliza el mismo objeto de autenticación en tiempo de ejecución que OAuth 2.0: la type propiedad se establece en OAuthPluginVaulty el reference_id se establece en el identificador de configuración de autenticación.

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