Configurar la autenticación para complementos MCP y API en agentes

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.

Los agentes declarativos en Microsoft 365 Copilot se conectan a servicios back-end a través de complementos de API o MCP. Estas integraciones de acciones conectan el agente a un servidor de Protocolo de contexto de modelo (MCP) o una API descrita por un documento OpenAPI. Configure la autenticación para que Microsoft 365 Copilot pueda obtener y enviar las credenciales correctas en nombre del usuario que ha iniciado sesión.

Nota

En este artículo se configura la autenticación en un manifiesto de complemento de API o MCP para un agente declarativo. No configura el paquete externo instalable. Consulte Complementos y acciones de agente declarativas para la relación de manifiesto.

Los tutoriales de autenticación utilizan un complemento MCP como ejemplo predeterminado. El complemento MCP es la integración del agente con el servidor remoto, no el servidor en sí. Los mismos pasos de configuración se aplican a los complementos de API creados a partir de un documento OpenAPI, excepto donde se indique en cada artículo.

Esquemas de autenticación compatibles

Elija el esquema de autenticación que coincida con la forma en que el servidor MCP o la API protegen sus puntos finales:

Esquema de autenticación Complementos de MCP Complementos de API Artículo
Inicio de sesión único (SSO) de Microsoft Entra Compatible Compatible Configuración de la autenticación SSO de Microsoft Entra
Registro dinámico de cliente (DCR) Compatible Incompatible Configurar el registro de cliente dinámico
Flujo de código de autorización de OAuth 2.0 Compatible Compatible Configurar la autenticación de OAuth 2.0
Clave de API No se admite Compatible Configurar la autenticación de claves de API
Sin autenticación (anónimo) Compatible Compatible No configurar autenticación (anónimo)

Nota

Esta tabla cubre los complementos MCP y API utilizados como acciones de agente declarativo. Un complemento que hace referencia a un servidor MCP remoto a través agentConnectors del manifiesto de la aplicación Microsoft 365 usa una configuración de autorización diferente. Ese esquema incluye ApiKeyPluginVault, mientras que los complementos de MCP utilizados como acciones de agente declarativo no admiten claves API. Para conocer los requisitos de configuración y host, consulte Configuración de servidores MCP remotos para complementos de Microsoft 365 Copilot.

Cómo funciona la autenticación del complemento

Para los esquemas que requieren credenciales, una configuración de autenticación (configuración de autenticación) es un registro almacenado en el almacén de tokens de Microsoft Enterprise que contiene las credenciales o los detalles de cliente necesarios para autenticarse en el servidor MCP o la API. El acceso anónimo no requiere una configuración de autenticación. Elija la ruta de configuración compatible para el proyecto:

  • Las herramientas de desarrollo de Work IQ (recomendado) Configura la autenticación cuando agrega una acción OpenAPI o MCP remota con wiqd agent add action. Para configurar un tipo de autenticación admitido en un manifiesto de complemento existente, use wiqd agent add auth. Siga la guía de WIQD específica del esquema a continuación para obtener las opciones correctas y, a continuación, complete el flujo de trabajo de aprovisionamiento del agente para su entorno.
  • El Kit de herramientas de agentes de Microsoft 365 crea la configuración de autenticación y actualiza el manifiesto del complemento automáticamente a medida que crea el agente.
  • La aptitud de desarrollador de agente declarativo (solo complementos MCP) crea la configuración de autenticación y actualiza el manifiesto a partir de instrucciones en lenguaje natural.
  • El portal para desarrolladores de Microsoft Teams le permite crear la configuración de autenticación manualmente o administrar una creada por Agents Toolkit o la habilidad.

En el caso de los esquemas autenticados, el manifiesto del complemento hace referencia a la configuración de autenticación por su identificador en el objeto de autenticación en tiempo de ejecución. En tiempo de ejecución, Microsoft 365 Copilot usa la configuración de autenticación para obtener un token o una clave de API del almacén de tokens y la incluye cuando el complemento llama al servidor MCP o a la API.

Comience con la sección WIQD para el esquema de autenticación elegido. Los mismos artículos conservan el kit de herramientas, las aptitudes para desarrolladores, el portal y las alternativas manuales cuando se admiten.

Nota

Para un paquete de complementos que conecta Cowork a un servidor MCP remoto, siga la autenticación en el manifiesto de la aplicación. Los pasos de registro de credenciales compartidas no hacen que esa configuración sea intercambiable con la configuración del manifiesto del complemento MCP de un agente. Si su proveedor de OAuth usa la Plataforma de identidad de Microsoft y la conexión necesita una actualización automática del token, incluya offline_access en el campo Ámbito de la configuración de OAuth cualquier ámbito delegado específico de la API.