Comprender las conexiones OAuth
Distinga iniciar sesión en una conexión MCP de autorizar sus servicios ascendentes.
Traducido automáticamente del inglés. Leer el original en inglés
Lectura de 2 minutos · Guía del cliente
OAuth es un patrón de autenticación compatible, pero cada flujo de consentimiento debe configurarse y probarse para el destino exacto. Una prueba de clave API exitosa no establece la preparación de OAuth para un cliente de IA en particular.
Identificar las dos relaciones de consentimiento#
Un cliente de IA puede autenticarse en una instalación o su puerta de enlace mediante un flujo de inicio de sesión propio compatible. Por otra parte, un servidor puede necesitar credenciales OAuth para llamar a un servicio ascendente en nombre de una cuenta comercial.
Estos no son intercambiables. Un corredor de OAuth ascendente puede necesitar autorización del proveedor y puntos finales de token, detalles y alcances de registro del cliente. No cambie una conexión de clave API existente a OAuth simplemente porque el cliente ofrece un botón de OAuth.
Siga el flujo de conexión acordado#
Utilice la dirección exacta del servidor o de la puerta de enlace en la transferencia. Cuando se abra una pantalla de consentimiento del navegador, verifique el dominio, la cuenta y el acceso solicitado. Autorice únicamente a la audiencia y el alcance previstos mediante el proceso normal del proveedor.
No envíe una URL de devolución de llamada que contenga un código de autorización para brindar soporte ni la pegue en una conversación de IA. Mantenga los tokens y los secretos del cliente en la ruta de configuración cifrada admitida.
Verificar después del consentimiento#
Confirme que el cliente de IA vuelva a un estado conectado, descubra solo las herramientas previstas y complete la acción de solo lectura acordada en la cuenta correcta. Cuando la actualización sea parte del flujo configurado, verifíquelo en lugar de asumir que la conexión inicial durará indefinidamente.
Cuando el consentimiento falla#
Registre la etapa y el error redactado. Una dirección de redireccionamiento no coincidente, un flujo de registro no admitido, una cuenta incorrecta, un alcance faltante o una concesión ascendente vencida pueden requerir soluciones diferentes. No desactive la autenticación, no acepte una advertencia de certificado ni reutilice el token de otra persona como solución alternativa.