Soluciona problemas con tu registro

Si tienes problemas para registrar o configurar tu app conectada, consulta la siguiente tabla de mensajes de error, causas y pasos para solucionar problemas comunes.

Problema	Mensaje de error	Causa	Pasos para solucionar problemas
Falla no especificada de "Herramientas de recuperación"	"No se pudieron recuperar los detalles del servidor de MCP. Vuelve a intentarlo". (o el botón Recuperar herramientas falla sin un mensaje de error específico).	Connected Console no pudo completar la solicitud a tu extremo de MCP debido a una URL no válida, un servidor sin conexión o un error de red.	Verifica lo siguiente: Verifica que la URL de tu extremo de MCP sea correcta y use https://. Asegúrate de que tu servidor de MCP esté en ejecución. Confirma que se pueda acceder a tu servidor de MCP desde la Internet pública (Google no puede acceder a localhost ni a direcciones de intranet privadas).
No se puede acceder al servidor de MCP	"No se puede acceder al servidor de MCP"	El backend de Google no pudo establecer una conexión con tu extremo de MCP.	Entre las causas y soluciones comunes, se incluyen las siguientes: Restricciones de firewall: Asegúrate de que tu firewall o WAF no bloqueen los rangos de IP salientes de Google. Reglas de API Gateway: Verifica que tu API Gateway acepte solicitudes POST y no rechace las de Google clientInfo durante el protocolo de enlace de MCP initialize. Discrepancia de subdominio: Si usas un subdominio dedicado (como gemini.mcp.company.com), asegúrate de que sus metadatos de /.well-known/oauth-protected-resource coincidan con ese subdominio en lugar de apuntar a un dominio base diferente (mcp.company.com).
Transporte de MCP no admitido (HTTP 405)	"El servidor de MCP rechazó la solicitud (HTTP 405 Method Not Allowed). Asegúrate de que la URL apunte a un endpoint HTTP de transmisión que acepte solicitudes POST, no a un endpoint SSE heredado".	La URL del extremo apunta a un extremo HTTP+SSE heredado que solo acepta solicitudes GET o rechaza solicitudes JSON-RPC POST.	Actualiza tu servidor de MCP y la URL del endpoint para usar el transporte HTTP de transmisión de MCP que acepta solicitudes POST para initialize y tools/list.
Falta el archivo de recurso protegido de OAuth	"El archivo /.well-known/oauth-protected-resource no existe en el servidor de MCP"	Google intentó realizar el descubrimiento de metadatos de recursos protegidos de OAuth 2.0 (RFC 9728), pero falló.	Si tu servidor de MCP NO requiere autenticación: Este error suele ocurrir cuando la URL del endpoint de MCP tiene un error tipográfico o un segmento de ruta de acceso faltante (por ejemplo, https://mcp.example.com en lugar de https://mcp.example.com/mcp) y devuelve HTTP 404 o 500, lo que hace que el cliente recurra al descubrimiento de OAuth. Verifica que la ruta exacta del extremo de MCP devuelva HTTP 200 OK a las solicitudes initialize y tools/list no autenticadas de POST, y selecciona No en ¿Tu servidor requiere autorización? en Credenciales de acceso. Si tu servidor de MCP requiere autenticación, aloja un archivo JSON /.well-known/oauth-protected-resource válido en tu servidor de MCP que anuncie tus servidores de autorización de confianza en el array authorization_servers.
Faltan metadatos del servidor de autorización de OAuth o no son válidos	"El archivo /.well-known/oauth-authorization-server no existe en el servidor de OAuth" o "contiene un JSON no válido o incompleto"	Tu servidor de OAuth no expone un documento de metadatos RFC 8414 válido en /.well-known/oauth-authorization-server.	Aloja un documento de descubrimiento RFC 8414 válido en /.well-known/oauth-authorization-server (o /.well-known/openid-configuration) que contenga authorization_endpoint y token_endpoint. Como alternativa, en la sección Credenciales, ingresa manualmente las URLs de tu Extremo de autorización personalizado y tu Extremo de token personalizado.
Falla la verificación del dominio	El certificado de dominio muestra "No se pudo verificar" o "No se pudo realizar la verificación" con un mensaje de información sobre la herramienta (como HTTP 404, redireccionamiento no permitido o discrepancia de token).	Google no pudo verificar tu token de desafío en https://<domain>/.well-known/google-connected-apps.	No se encontró el archivo (HTTP 404): Asegúrate de que el contenido de google-connected-apps.json descargado esté publicado en https://<domain>/.well-known/google-connected-apps (sin una extensión .json en la ruta de URL). No se permiten redireccionamientos: Publica la carga útil de verificación directamente con HTTP 200 OK; no redirecciones /.well-known/google-connected-apps a otra URL. No coinciden los tokens: Confirma que la respuesta JSON contenga "verification_tokens": ["<YOUR_TOKEN>"] con el token exacto generado para tu cuenta de desarrollador.
Falla en el registro dinámico de clientes (DCR) o CIMD	"No se pudo completar el registro dinámico de clientes (RFC 7591)", "El servidor de OAuth no admite el registro dinámico de clientes (RFC 7591)" o "No se pudo completar el registro del documento de metadatos de ID de cliente (CIMD)"	Se produjo un error en el registro automático del cliente de OAuth o tu proveedor de OAuth no lo admite, o bien se rechazaron los URIs de redireccionamiento de Google.	Asegúrate de que tu servidor de OAuth incluya en la lista de entidades permitidas los seis URIs de redireccionamiento de Google específicos de la app que se muestran en Credenciales de autenticación del servidor (https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain>, etc.). Ten en cuenta que muchos servidores de OAuth 2.1 rechazan los URIs de redireccionamiento con comodines (*). Si tu proveedor de OAuth no admite CIMD ni RFC 7591 DCR, selecciona Registrado previamente (para OAuth delegado por el usuario) o De máquina a máquina (credenciales de cliente de OAuth) en Credenciales de acceso y proporciona un ID de cliente y un Secreto de cliente estáticos.
La ventana emergente de acceso de OAuth está bloqueada o en blanco	"El navegador bloqueó la ventana emergente de autenticación" o la ventana de acceso de OAuth no se muestra correctamente durante la sincronización o la prueba de la herramienta.	Los bloqueadores de ventanas emergentes del navegador o los encabezados estrictos de X-Frame-Options o Content-Security-Policy en tu página de acceso impidieron el flujo de ventanas emergentes.	Permite las ventanas emergentes para la consola en tu navegador y vuelve a intentarlo. En Access credentials, en Authenticate with your developer credentials, cambia de Authenticate via Pop up a Authenticate via Redirect (fallback) para que el flujo de autenticación se abra en pantalla completa en la misma pestaña.
Faltan las instrucciones del servidor de MCP	Mensaje de advertencia: "Tu servidor de MCP no tiene instrucciones. Te recomendamos que agregues instrucciones al esquema del servidor".	Tu servidor de MCP no devolvió un campo instructions en su respuesta initialize.	Define de forma explícita las instrucciones del sistema cuando inicialices tu servidor de MCP (parámetro instructions en la definición del servidor). En el caso de las implementaciones de HTTP sin estado o personalizadas, asegúrate de que el campo instructions se incluya en la carga útil de la respuesta de JSON-RPC para el método initialize y, luego, selecciona Volver a sincronizar las herramientas.
Límite de tamaño de los recursos de la IU o tipo de MIME no admitido	Tarjeta de error Problemas con la recuperación: "El tamaño acumulativo de los recursos no puede superar los 100 MB" o "Tipo de MIME '<type>' no admitido para el recurso '<uri>'"	Tu servidor de MCP devolvió recursos de IU cuyo tamaño total supera el límite o que usan un tipo de MIME no admitido.	Reduce el tamaño acumulativo de todos los recursos de la IU del manifiesto que devuelve tu servidor para que no supere el límite. Asegúrate de que todos los recursos de la IU usen uno de los tipos de MIME admitidos: text/html, text/html;profile=mcp-app, text/javascript o text/css.
La carga del ícono se detiene o aparece el mensaje "Error inesperado"	Cuando subes un ícono de la app en Detalles de la app, la carga se congela en un ícono giratorio de carga o muestra el mensaje "Se produjo un error inesperado. Vuelve a intentarlo" (a menudo con el código 4E696748).	Por lo general, se debe a una sesión del navegador inactiva, extensiones del navegador en conflicto o un estado de autenticación almacenado en caché.	Prueba los siguientes pasos en orden: Usa un perfil de navegador nuevo: Abre una ventana nueva con un perfil de navegador limpio. Usa el modo privado o de incógnito: Accede a Google Connected Console en una ventana de navegación privada y sube el ícono. Borra la caché: Borra la caché y las cookies del navegador antes de volver a intentarlo y verifica que el ícono sea un archivo PNG o JPEG válido de 512 px × 512 px de menos de 1 MB.