Résoudre les problèmes d'enregistrement

Si vous rencontrez des problèmes lors de l'enregistrement ou de la configuration de votre application connectée, consultez le tableau suivant qui répertorie les messages d'erreur, les causes et les étapes de dépannage courants.

Problème	Message d'erreur	Cause	Procédure de dépannage
Échec non spécifié de "Récupérer les outils"	"Échec de la récupération des détails du serveur MCP. Veuillez réessayer." (ou si le bouton Récupérer les outils échoue sans message d'erreur spécifique).	Connected Console n'a pas pu traiter la requête envoyée à votre point de terminaison MCP en raison d'une URL non valide, d'un serveur hors connexion ou d'une erreur réseau.	Effectuez les vérifications suivantes : Vérifiez que l'URL de votre point de terminaison MCP est correcte et utilise https://. Assurez-vous que votre serveur MCP est en cours d'exécution. Vérifiez que votre serveur MCP est accessible depuis l'Internet public (Google ne peut pas accéder à localhost ni aux adresses intranet privées).
Impossible d'accéder au serveur MCP	"Impossible d'accéder au serveur MCP"	Le backend de Google n'a pas pu établir de connexion avec votre point de terminaison MCP.	Voici les causes et les solutions les plus courantes : Restrictions de pare-feu : assurez-vous que votre pare-feu ou votre WAF ne bloque pas les plages d'adresses IP sortantes de Google. Règles de la passerelle d'API : vérifiez que votre passerelle d'API accepte les requêtes POST et ne rejette pas les clientInfo de Google lors du handshake initialize du MCP. Incohérence de sous-domaine : si vous utilisez un sous-domaine dédié (tel que gemini.mcp.company.com), assurez-vous que ses métadonnées /.well-known/oauth-protected-resource correspondent à ce sous-domaine plutôt que de pointer vers un autre domaine de base (mcp.company.com).
Transport MCP non compatible (HTTP 405)	"Le serveur MCP a rejeté la requête (HTTP 405 Méthode non autorisée). Assurez-vous que l'URL pointe vers un point de terminaison HTTP prenant en charge le streaming et acceptant les requêtes POST, et non vers un ancien point de terminaison SSE."	L'URL du point de terminaison pointe vers un ancien point de terminaison HTTP+SSE qui n'accepte que les requêtes GET ou rejette les requêtes JSON-RPC POST.	Mettez à jour votre serveur MCP et l'URL du point de terminaison pour utiliser le transport HTTP en flux MCP qui accepte les requêtes POST pour initialize et tools/list.
Fichier de ressources protégées OAuth manquant	"Le fichier /.well-known/oauth-protected-resource n'existe pas sur le serveur MCP"	Google a tenté de découvrir les métadonnées de la ressource protégée par OAuth 2.0 (RFC 9728), mais l'opération a échoué.	Si votre serveur MCP ne nécessite PAS d'authentification : cette erreur se produit généralement lorsque l'URL du point de terminaison MCP comporte une faute de frappe ou un segment de chemin manquant (par exemple, https://mcp.example.com au lieu de https://mcp.example.com/mcp) et renvoie HTTP 404 ou 500, ce qui amène le client à revenir à la découverte OAuth. Vérifiez que le chemin d'accès exact de votre point de terminaison MCP renvoie HTTP 200 OK aux requêtes POST initialize et tools/list non authentifiées, puis sélectionnez Non sous Votre serveur nécessite-t-il une autorisation ? dans Identifiants d'accès. Si votre serveur MCP nécessite une authentification : hébergez un fichier JSON /.well-known/oauth-protected-resource valide sur votre serveur MCP qui annonce vos serveurs d'autorisation de confiance dans le tableau authorization_servers.
Métadonnées du serveur d'autorisation OAuth manquantes ou non valides	"Le fichier /.well-known/oauth-authorization-server n'existe pas sur le serveur OAuth" ou "contient un JSON non valide ou incomplet"	Votre serveur OAuth n'expose pas de document de métadonnées RFC 8414 valide à l'adresse /.well-known/oauth-authorization-server.	Hébergez un document de découverte RFC 8414 valide sur /.well-known/oauth-authorization-server (ou /.well-known/openid-configuration) contenant authorization_endpoint et token_endpoint. Vous pouvez également saisir manuellement les URL de votre point de terminaison d'autorisation personnalisé et de votre point de terminaison de jeton personnalisé dans la section Identifiants.
Échec de la validation du domaine	Certificat de domaine affiche Échec de la validation ou Validation échouée avec un message d'info-bulle (tel que HTTP 404, redirection non autorisée ou non-concordance de jeton).	Google n'a pas pu valider votre jeton de test à l'adresse https://<domain>/.well-known/google-connected-apps.	Fichier introuvable (HTTP 404) : assurez-vous que le contenu google-connected-apps.json téléchargé est publié sur https://<domain>/.well-known/google-connected-apps (sans extension .json dans le chemin d'URL). Redirections non autorisées : diffusez la charge utile de validation directement avec HTTP 200 OK. Ne redirigez pas /.well-known/google-connected-apps vers une autre URL. Incohérence de jeton : vérifiez que la réponse JSON contient "verification_tokens": ["<YOUR_TOKEN>"] avec le jeton exact généré pour votre compte de développeur.
Échec de l'enregistrement dynamique des clients (DCR) ou du CIMD	"Échec de l'enregistrement dynamique du client (RFC 7591)", "Le serveur OAuth ne prend pas en charge l'enregistrement dynamique de clients (RFC 7591)" ou "Échec de l'enregistrement du document de métadonnées d'ID client (CIMD)"	L'enregistrement automatique du client OAuth a échoué ou n'est pas accepté par votre fournisseur OAuth, ou les URI de redirection de Google ont été refusés.	Assurez-vous que votre serveur OAuth autorise les six URI de redirection Google spécifiques à l'application, affichés sous Identifiants d'authentification du serveur (https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain>, etc.). Notez que de nombreux serveurs OAuth 2.1 rejettent les URI de redirection génériques (*). Si votre fournisseur OAuth n'est pas compatible avec CIMD ou RFC 7591 DCR, sélectionnez Pré-enregistré (pour OAuth délégué par l'utilisateur) ou Machine à machine (identifiants client OAuth) dans Identifiants d'accès, puis fournissez un ID client et un code secret du client statiques.
Pop-up de connexion OAuth bloqué ou vide	"Le pop-up d'authentification a été bloqué par votre navigateur" ou la fenêtre de connexion OAuth ne s'affiche pas correctement lors de la synchronisation ou du test de l'outil.	Les bloqueurs de pop-ups du navigateur ou les en-têtes X-Frame-Options/Content-Security-Policy stricts de votre page de connexion ont empêché le flux de pop-ups.	Autorisez les pop-ups pour la console dans votre navigateur, puis réessayez. Dans Identifiants d'accès, sous S'authentifier avec les identifiants de développeur, passez de S'authentifier via une fenêtre pop-up à S'authentifier via une redirection (solution alternative) pour que le flux d'authentification s'ouvre en plein écran dans le même onglet.
Instructions du serveur MCP manquantes	Message d'avertissement : "Votre serveur MCP ne contient pas d'instructions. Nous vous recommandons d'en ajouter au schéma de votre serveur."	Votre serveur MCP n'a pas renvoyé de champ instructions dans sa réponse initialize.	Définissez explicitement les instructions système lors de l'initialisation de votre serveur MCP (paramètre instructions dans la définition de votre serveur). Pour les implémentations HTTP sans état ou personnalisées, assurez-vous que le champ instructions est inclus dans la charge utile de la réponse JSON-RPC pour la méthode initialize, puis sélectionnez Resynchroniser les outils.
Limite de taille de la ressource d'interface utilisateur ou type MIME non compatible	Fiche d'erreur Problèmes de récupération : "La taille cumulée des ressources ne peut pas dépasser 100 Mo" ou "Type MIME non compatible '<type>' pour la ressource '<uri>'"	Votre serveur MCP a renvoyé des ressources d'UI dont la taille totale dépasse la limite ou qui utilisent un type MIME non compatible.	Réduisez la taille cumulée de toutes les ressources d'interface utilisateur du fichier manifeste renvoyées par votre serveur afin qu'elle ne dépasse pas la limite. Assurez-vous que toutes les ressources d'interface utilisateur utilisent l'un des types MIME compatibles : text/html, text/html;profile=mcp-app, text/javascript ou text/css.
L'importation de l'icône est bloquée ou une "erreur inattendue" s'affiche	Lorsque vous importez une icône d'application dans Informations sur l'application, l'importation se fige sur un icône de chargement ou affiche le message "Une erreur inattendue s'est produite. Veuillez réessayer" (souvent avec le code 4E696748).	Généralement causée par une session de navigateur obsolète, des extensions de navigateur en conflit ou un état d'authentification mis en cache.	Essayez les étapes suivantes dans l'ordre : Utilisez un nouveau profil de navigateur : ouvrez une nouvelle fenêtre à l'aide d'un profil de navigateur propre. Utilisez le mode navigation privée : connectez-vous à la Google Connected Console dans une fenêtre de navigation privée et importez l'icône. Videz le cache : videz le cache et supprimez les cookies de votre navigateur avant de réessayer. Vérifiez que votre icône est un fichier PNG ou JPEG valide de 512 px × 512 px et de moins de 1 Mo.