Solucionar problemas de autenticación de complementos de MCP y API

En este artículo se tratan problemas y preguntas comunes al configurar la autenticación para el Protocolo de contexto de modelo (MCP) y complementos de API en agentes que se ejecutan en Microsoft 365 Copilot.

Para ver los errores de autenticación en las respuestas del agente, habilite el modo de desarrollador. Muchos de los errores de este artículo aparecen en la tarjeta de información de depuración.

Los usuarios no pueden iniciar sesión o se produce un error en el intercambio de tokens

Los valores que no coinciden entre el proveedor de OAuth, la configuración de autenticación y el manifiesto del complemento son la causa más común de errores de inicio de sesión. Compruebe los siguientes valores:

  • La URL base en la configuración de autenticación coincide con la url propiedad del objeto de especificación del servidor MCP en el manifiesto de complementos para complementos MCP o con una entrada de la matriz en el servers documento OpenAPI para complementos de API.
  • El URI https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect de redireccionamiento se registra como un URI de redireccionamiento permitido o una URL de devolución de llamada de autorización con el proveedor de OAuth.
  • El reference_id objeto de autenticación en tiempo de ejecución coincide con el id. de configuración de autenticación generado por el portal para desarrolladores de Microsoft Teams.
  • Las opciones de restricción de aplicaciones (restringir el uso por aplicación) y restricción de la organización (restringir el uso por organización) permiten la aplicación y el inquilino de Teams.

307 Temporary Redirect desde el punto de conexión de token

No se admiten los servidores OAuth 2.0 que devuelven 307 Temporary Redirect códigos de estado HTTP desde su punto de conexión de token. Configure el proveedor para usar un punto de conexión de token directo.

Las credenciales almacenadas persisten después de desinstalar el agente

Los usuarios pueden cerrar la sesión de un agente desdeAgentes de configuración> de chat en Microsoft 365 Copilot. Para OAuth 2.0, cerrar sesión borra el token almacenado. Para el SSO de Microsoft Entra, el token no se puede borrar directamente y podría continuar persistiendo después de desinstalar un agente debido al almacenamiento en caché de SSO, la configuración de inquilinos o las diferencias de cliente.

Para forzar la reautenticación para el SSO de Entra, quite el consentimiento del usuario o revoque sus sesiones mediante la API de Microsoft GraphrevokeSignInSessions.

Si el servidor MCP o la API usa el flujo en nombre de para obtener acceso a otra API web que requiere que el usuario otorgue consentimiento, devuelva un 401 Unauthorized error para que el agente solicite al usuario que inicie sesión para otorgar consentimiento.

Confirme también que:

  • El URI de identificador de aplicación generado por el portal para desarrolladores de Teams se agrega al identifierUris del registro de la aplicación Entra.
  • https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirect se agrega a los URI de redireccionamiento en la plataforma web .
  • El idab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b. de cliente () del almacén de tokens de Microsoft Enterprise se agrega como aplicación cliente permitida en Exponer una API y, si valida el id. de la aplicación cliente, como audiencia de token permitida.

El id. de la aplicación no coincide entre la configuración de autenticación y el complemento

Si ve errores en la tarjeta de información de depuración similares a:

OAuth authentication failed: The App ID used in the request does not match the App ID in the authentication configuration. (HTTP 404)

Vaya al portal para desarrolladores de Teams. Busque el registro de su cliente OAuth o cliente de inicio de sesión único (SSO) y verifique que el ID de la aplicación en el complemento coincida con el ID de la aplicación registrada.

La dirección URL base en la configuración de autenticación no coincide con la del complemento

Si ve errores en la tarjeta de información de depuración similares a:

OAuth authentication failed: The base URL in your authentication configuration does not match the server URL. (HTTP 401)

Vaya al portal para desarrolladores de Teams. Busque el registro de su cliente OAuth o cliente SSO y verifique que la URL del servidor MCP en el complemento coincida con la URL base registrada.

El identificador de referencia en el manifiesto del complemento es incorrecto o falta

Si ve errores en la tarjeta de información de depuración similares a:

OAuth authentication failed: No matching configuration found for referenceID in 'runtime.auth' section of the action manifest

Vaya al portal para desarrolladores de Teams. Busque el registro de su cliente OAuth o cliente SSO y verifique que el Id. en el tiempo auth.reference_id de ejecución de su servidor MCP coincida con el Id. de configuración de autenticación en el portal para desarrolladores de Teams.

La directiva de la organización restringe el acceso

Si ve errores en la tarjeta de información de depuración similares a:

OAuth authentication failed: Access is restricted by your organization's policy. (HTTP 404)

Póngase en contacto con los administradores de su organización para revisar y habilitar el acceso para la aplicación.

El botón de inicio de sesión está inactivo o muestra un error general

Si el botón de inicio de sesión está inactivo o deshabilitado, o al seleccionarlo aparece un error general "La solicitud no se puede procesar", esta condición podría indicar problemas temporales de autenticación o sesión. Intente realizar una consulta de nuevo. Si el problema persiste, vuelva a instalar la aplicación o póngase en contacto con los administradores de su organización.

No se abre la ventana emergente de inicio de sesión

Habilite los elementos emergentes para el sitio en la configuración de su navegador y vuelva a intentarlo.

La ventana emergente de inicio de sesión se abre, pero se atasca o nunca se cierra

Si se abre el menú emergente de inicio de sesión y el usuario completa la autenticación, pero el elemento emergente no se cierra nunca y Copilot no recibe el resultado de la autenticación, es probable que la referencia del window.opener elemento emergente se haya destruido durante la cadena de redireccionamiento de OAuth. Sin window.opener, la ventana emergente no puede comunicar el resultado de la autenticación a Copilot. Un síntoma común es que el inicio de sesión falla la primera vez, pero se realiza correctamente al reintentarlo, porque las credenciales almacenadas en caché omiten la página que destruyó window.opener.

Compruebe los siguientes elementos de la cadena de redireccionamiento de OAuth.

  • Anulación de window.openerJavaScript : Algunas páginas de inicio de sesión configuradas window.opener = null como una medida de seguridad general contra la tabulación inversa. Si alguna página de la cadena de redireccionamiento de autenticación ejecuta este código, el elemento emergente pierde su conexión con Copilot. Ámbito de las protecciones de tabulación solo para la navegación iniciada por el usuario y no se desactivan window.opener durante los redireccionamientos en los elementos emergentes.
  • Cross-Origin-Opener-Policy Encabezado establecido en same-origin: Si alguna página de la cadena de redireccionamiento sirve un Cross-Origin-Opener-Policy: same-origin encabezado de respuesta, el navegador corta permanentemente la referencia en la window.opener navegación entre orígenes. Asegúrese de que todas las páginas de la cadena de redireccionamiento de OAuth omitan el Cross-Origin-Opener-Policy encabezado (que por defecto es unsafe-none) o lo establezcan explícitamente en unsafe-none.
  • Vínculos que usan rel="noopener": Etiquetas de anclaje con rel="noopener" franja window.opener de la página de destino. No lo use rel="noopener" para la navegación dentro del elemento emergente de autenticación.

Para depurar este problema, abra las herramientas para desarrolladores de su navegador en la ventana emergente y escriba window.opener la Consola en cada paso de la cadena de redireccionamiento. Si window.opener regresa null antes de la redirección final, identifique qué página la borró. También puede comprobar los encabezados de respuesta de la pestaña Red para Cross-Origin-Opener-Policy ver los valores en cada página de la cadena.

Error de credenciales incorrectas

Si ves un error de "credenciales incorrectas" en la ventana emergente de inicio de sesión o en la respuesta del chat, asegúrate de que estás introduciendo las credenciales correctas. Si el error persiste, asegúrese de que el usuario tiene los permisos necesarios.

URL de inicio de sesión no encontrada

Desinstale y reinstale la aplicación e intente iniciar sesión de nuevo.

Error interno del servidor durante la autenticación

Compruebe los detalles en el cuadro emergente de autenticación y póngase en contacto con los administradores de su organización para ver si hay problemas de permisos.

Si aparece un cuadro de diálogo de consentimiento solicitando permisos o justificación comercial, revise los permisos solicitados y proporcione una justificación comercial si es necesario. Si no está seguro o si el cuadro de diálogo de consentimiento solicita permisos que requieren el consentimiento del administrador, póngase en contacto con los administradores de su organización.