Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Tester, déboguer et évaluer dans le mode développeur des applications Gemini

Utilisez le mode développeur des applications Gemini pour tester de manière interactive votre serveur MCP (Model Context Protocol), diagnostiquer les erreurs de schéma ou d'exécution, et évaluer la qualité des outils avant d'envoyer votre application connectée pour examen dans la Google Connected Console.

Ce guide couvre les tâches suivantes :

Activer le mode développeur des applications Gemini dans Gemini, créer une application MCP personnalisée et vérifier la découverte initiale des outils
Déboguez les appels d'outils ayant échoué, synchronisez les schémas mis à jour et testez l'authentification.
Simuler le contexte de l'environnement utilisateur et configurer l'authentification du client

Pour en savoir plus sur la mise en page de l'espace de travail et les onglets de l'inspecteur, consultez la présentation du mode développeur des applications Gemini.

Activer le mode développeur pour les applications Gemini

Si vous intégrez votre serveur MCP dans la Google Connected Console, votre application enregistrée est déjà disponible lorsque vous activez le mode développeur pour les applications Gemini. Vous pouvez donc ignorer l'étape 2. Si vous souhaitez tester un point de terminaison de serveur MCP HTTPS déployé directement dans Gemini avant de l'enregistrer dans la console, suivez les deux étapes pour activer le mode développeur des applications Gemini et connecter votre serveur en tant qu'application MCP personnalisée.

Étape 1 : Activez le mode développeur des applications Gemini

Ouvrez Gemini dans votre navigateur Web.
Cliquez sur Paramètres > Mode développeur des applications Gemini (ou accédez directement à gemini.google.com/devmode).

(Facultatif) Étape 2 : Créez et testez une application MCP personnalisée

Pour connecter votre serveur MCP en tant qu'application personnalisée dans le mode développeur des applications Gemini, procédez comme suit :

Dans la boîte de dialogue Choisir une application, cliquez sur + Créer.
Dans la boîte de dialogue Se connecter à un serveur MCP, saisissez le point de terminaison HTTPS public de votre serveur dans URL du serveur MCP (assurez-vous que votre URL commence par https://, par exemple https://your-app-link.com/mcp).
Si votre serveur nécessite des identifiants OAuth préenregistrés, cliquez sur Paramètres supplémentaires > Afficher plus pour saisir l'ID client et le code secret du client OAuth, puis cliquez sur Suivant.
Dans la boîte de dialogue de confirmation de sécurité et de confidentialité, examinez comment Gemini interagit avec votre serveur MCP personnalisé :
- Exécution des outils : Gemini exécute les outils de votre serveur MCP pour déclencher et exécuter les fonctions disponibles afin de traiter vos requêtes.
- Récupération et partage de données : Gemini récupère et gère les ressources, les schémas et le contexte exposés par les points de terminaison de votre serveur MCP. Il peut partager les informations auxquelles il a accès en fonction des paramètres de votre compte Google ou lors de l'interaction avec d'autres applications connectées.
- Confiance et déconnexion : assurez-vous que le serveur MCP est digne de confiance et consultez ses règles de confidentialité avant de continuer. Vous pouvez déconnecter le serveur à tout moment depuis la page "Applis connectées" ou supprimer son association depuis les connexions de votre compte Google.
Sélectionnez Je comprends et j'accepte les risques de sécurité et de confidentialité qu'entraîne la connexion de cette appli personnalisée, puis cliquez sur Connecter.
Dans la boîte de dialogue Enregistrer votre application personnalisée, saisissez un nom à afficher pour votre application personnalisée, vérifiez que les outils de votre serveur apparaissent dans la liste Actions disponibles, puis cliquez sur Connecter.
Dans le panneau latéral du mode développeur des applications Gemini, sélectionnez l'onglet Schémas d'outils pour examiner les informations sur chaque outil de votre application connectée, y compris les définitions de paramètres, les badges de sécurité (Lecture seule, Destructif, Authentification requise), le Schéma brut et la Structure de réponse.
Dans le volet de chat de gauche, saisissez des prompts en langage naturel ou @mention (par exemple, @MyApp show my profile), puis surveillez l'onglet Journal des événements pour voir comment votre outil fonctionne.

Déboguer les appels d'outils

Lorsqu'un appel d'outil échoue ou produit des arguments inattendus, vous pouvez inspecter la télémétrie de diagnostic, mettre à jour votre serveur MCP de backend et effectuer un hot reload du schéma sans effacer l'historique de vos conversations.

Pour déboguer un appel d'outil ayant échoué, procédez comme suit :

Dans le volet de droite, sélectionnez l'onglet Journal des événements.
Cliquez sur l'événement ayant échoué dans la liste Télémétrie pour afficher ses détails et inspecter la charge utile de la requête Tool call et la réponse Tool result :
- Erreurs de connexion et erreurs réseau : vérifiez les messages d'erreur et la latence pour vous assurer que votre point de terminaison est accessible.
- Erreurs d'authentification : si l'événement renvoie 401 ou 403, vérifiez l'état de votre jeton OAuth ou vos identifiants client dans l'onglet Authentification.
- Incohérences de validation du schéma : si le serveur renvoie une erreur de paramètres MCP non valides (-32602), comparez les arguments JSON générés par le modèle dans Tool call aux types de paramètres, aux propriétés requises et aux instructions de format de l'onglet Schémas d'outils.
- Exceptions d'exécution du serveur : inspectez le code d'erreur JSON-RPC et le message dans Tool result pour diagnostiquer les exceptions de backend.
Pour résoudre le problème, mettez à jour l'implémentation de votre serveur MCP ou affinez les descriptions de vos outils et paramètres. Pour savoir comment rédiger des schémas d'outils et des réponses d'erreur clairs, consultez Normes d'intégration des applications connectées MCP.
Dans l'onglet Schémas d'outils, cliquez sur Synchroniser le schéma. Gemini récupère à nouveau tools/list à partir de votre serveur MCP et met à jour les définitions d'outils actives tout en conservant le fil de discussion actuel.
Relancez la requête. Dans l'onglet Journal des événements, vérifiez que l'appel d'outil rejoué renvoie 200 OK et affiche la réponse attendue dans l'aperçu du chat.

Simuler le contexte de l'environnement et l'authentification

Vous pouvez tester la réponse de vos outils MCP à différents emplacements, fuseaux horaires, paramètres régionaux et méthodes d'authentification des utilisateurs directement dans le volet de l'inspecteur.

Remplacer le contexte de l'environnement

Pour simuler le contexte utilisateur pour les outils sensibles à la date, à l'heure ou aux paramètres régionaux, procédez comme suit :

Dans le volet de droite, sélectionnez l'onglet Environnement.
Sous Date et heure, sélectionnez une date simulée et une heure simulée pour tester les expressions temporelles relatives (telles que "demain matin" ou "samedi après-midi").
Sous Préférences, sélectionnez une Langue pour simuler les paramètres régionaux de l'utilisateur (par exemple, en-US).
Exécutez un prompt de test dans le volet de chat pour évaluer votre outil avec le contexte simulé.
Pour restaurer les paramètres d'environnement par défaut, cliquez sur Réinitialiser.

Configurer l'authentification client

Pour configurer ou changer la méthode d'authentification utilisée lors de votre session en mode développeur des applications Gemini, procédez comme suit :

Dans le volet de droite, sélectionnez l'onglet Authentification.
Sous Configuration de l'authentification du client, sélectionnez l'un des modes d'authentification suivants :
- Enregistrement dynamique des clients : utilise un flux OAuth pour négocier automatiquement les identifiants avec votre serveur d'autorisation. Pour en savoir plus, consultez le guide d'implémentation d'OAuth 2.1. Le cas échéant, saisissez votre point de terminaison dans Ajouter un lien vers l'application personnalisée.
- Enregistrement manuel du client : vous permet de fournir manuellement un ID client et un code secret du client préenregistrés. Développez Paramètres avancés pour configurer des remplacements de flux supplémentaires.
Cliquez sur Enregistrer, puis attendez que le message Enregistré s'affiche. Ensuite, exécutez une requête de test pour vérifier que les outils authentifiés fonctionnent.