Enregistrer, tester et publier votre application connectée

Une fois que vous avez rempli les conditions préalables, suivez ces étapes pour enregistrer, configurer, tester et publier votre appli connectée.

Étape 1 : Créez une application connectée

Pour créer une application connectée :

  1. Connectez-vous à la Google Connected Console.
  2. Sur la page d'accueil, sélectionnez Créer une application.
  3. Dans la boîte de dialogue Choisir ce que vous souhaitez créer :
    • Si vous êtes invité à accepter les conditions d'utilisation des applications connectées, sélectionnez Afficher les conditions, lisez et acceptez le contrat, puis sélectionnez Créer. Seul un administrateur du compte peut accepter le contrat.
    • Sinon, sélectionnez Créer dans la fiche Application connectée.

  4. Dans la boîte de dialogue Attribuez un nom à votre appli connectée, saisissez un nom pour votre appli connectée. Il s'agit du nom qui sera utilisé pour afficher votre appli connectée dans les produits Google et qui permettra aux utilisateurs de mentionner votre appli connectée à l'aide de @. Sélectionnez Suivant.

  5. Dans la boîte de dialogue Sélectionnez une catégorie d'applications connectées, sélectionnez le domaine, la catégorie ou le secteur de votre application dans le menu Sélectionnez une catégorie.

  6. Dans la boîte de dialogue Choisir un type de connexion, sélectionnez l'une des options suivantes :

    • Serveur MCP : connectez un serveur MCP pour proposer vos services aux utilisateurs de Gemini et de la Recherche sur le Web, Android et iOS.
    • Android MCP : rendez vos fonctionnalités sur l'appareil accessibles à Gemini sur Android pour qu'il puisse déclencher des actions et effectuer des tâches pour les utilisateurs dans votre appli.

    Découvrez comment configurer une application connectée Android MCP. Vous ne pouvez choisir qu'un seul type de connexion par application connectée, et vous ne pourrez pas le modifier ultérieurement.

  7. Sélectionnez Créer une application connectée.

La page de présentation de la gestion de votre appli connectée (Configurer et tester votre appli connectée) s'ouvre. Vous pouvez y configurer les informations de votre appli, la connexion au serveur MCP et les testeurs.

Étape 2 : Saisissez les informations sur votre application connectée

Pour fournir plus de détails sur votre application connectée et configurer son apparence pour les utilisateurs :

  1. Sur la page de présentation de votre application connectée, sur la ligne Informations sur l'application, sélectionnez Commencer (ou Gérer si vous modifiez des informations existantes).
  2. En haut de la page Informations sur l'application, vérifiez le champ Nom de l'application connectée. Vous pouvez modifier le nom si nécessaire. Il est visible par les utilisateurs dans les produits Google et utilisé lorsqu'ils mentionnent votre application avec @.
  3. Dans la section Informations publiques, sous Icône, importez l'icône de votre application (JPG ou PNG, jusqu'à 1 Mo et 512 px × 512 px).

  4. Remplissez les champs suivants :

    • Description : saisissez un résumé concis d'une seule phrase (moins de 30 mots) décrivant les principales fonctionnalités de votre application connectée et ce qu'elle peut faire. Ce texte est présenté aux utilisateurs. Il n'est pas utilisé comme instructions du modèle.
    • Fonctionnalités : saisissez au moins trois tâches à forte valeur ajoutée que votre application connectée peut effectuer. Sélectionnez Ajouter une fonctionnalité pour ajouter d'autres entrées. N'incluez pas de chiffres au début de vos fonctionnalités. N'incluez qu'une seule fonctionnalité par entrée. Si votre catégorie inclut des fonctionnalités prédéfinies, elles apparaissent en haut de la liste et ne peuvent pas être modifiées.
    • Exemples de prompts : saisissez au moins trois exemples de prompts pour aider les utilisateurs à comprendre ce qu'ils peuvent demander. Sélectionnez Ajouter un exemple de requête pour ajouter des entrées.
      • Commencez au moins deux prompts par @<YourAppName> (par exemple, @Order Tracker where is my last order?).
      • Mentionnez <YourAppName> naturellement dans au moins un prompt sans commencer par le nom de votre application (par exemple, Track my recent order on Order Tracker).
      • N'incluez pas de préfixes numérotés (1., 2., 3.) et ne placez pas les requêtes entre guillemets ("...").

    • Localisation multilingue : pour fournir des traductions pour les champs Description, Capacités et Exemples de requêtes, encapsulez le texte de chaque paramètre régional dans des balises de langue dans le champ de saisie. Exemple :

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      La Connected Console valide automatiquement vos balises et affiche les paramètres régionaux détectés sous chaque champ (par exemple, Found translations for 2 languages: en-US, es-ES).

    • URL des conditions d'utilisation : saisissez un lien https:// ou http:// valide vers vos conditions d'utilisation.

    • URL des règles : saisissez un lien https:// ou http:// valide vers vos règles de confidentialité.

    • URL du site Web (facultatif) : saisissez un lien vers votre site Web à des fins d'attribution.

  5. Sélectionnez Enregistrer en bas de la page pour revenir à la page de présentation.

Étape 3 : Saisissez votre point de terminaison MCP et validez la propriété du domaine

Avant que Google puisse se connecter à votre serveur MCP ou synchroniser vos outils, vous devez fournir l'URL du point de terminaison de votre serveur MCP et confirmer que vous êtes propriétaire du domaine sur lequel il est hébergé.

Pour saisir votre point de terminaison MCP et valider la propriété du domaine :

  1. Sur la page de présentation de votre application connectée, dans la fiche Configuration du MCP et des outils, sélectionnez Commencer (ou Gérer si vous modifiez des informations existantes). L'étape 1 (Points de terminaison du serveur MCP) du flux de configuration MCP s'ouvre.
  2. Sous Connectez le point de terminaison de votre serveur MCP, saisissez l'URL HTTPS complète du point de terminaison de votre serveur MCP (par exemple, https://api.yourdomain.com/v1/mcp).

  3. Sous Valider votre domaine, effectuez la validation du jeton de vérification pour votre domaine (si vous avez déjà validé le domaine ou son domaine parent dans votre compte de développeur, il s'affichera automatiquement comme validé) :

    1. Dans la fiche Valider la propriété du domaine, sélectionnez Télécharger le jeton. Votre navigateur télécharge un fichier nommé google-connected-apps.json avec la structure suivante :

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Importez et hébergez ce contenu JSON sur votre serveur à l'adresse https://<your-domain>/.well-known/google-connected-apps.

      • Assurez-vous que le point de terminaison est accessible publiquement via HTTPS, qu'il renvoie directement HTTP 200 OK sans redirection HTTP et qu'il inclut votre jeton dans le tableau verification_tokens.

    3. Revenez à la Google Connected Console, puis sélectionnez Valider le domaine.

    4. Une fois la validation réussie, la ligne Domaine validé avec un jeton de vérification affiche une coche verte et déverrouille la section Identifiants d'accès située en dessous.

Étape 4 : Configurer les identifiants d'accès

Après avoir validé votre domaine, configurez la manière dont Google s'authentifie auprès de votre serveur MCP et récupérez les définitions des outils de votre serveur.

Pour configurer les identifiants d'accès :

  1. Dans la section Fournir des identifiants d'accès (à l'étape 1 de la page Configuration de MCP et des outils), sélectionnez Commencer (ou Mettre à jour les identifiants pour modifier une configuration existante).

  2. Sous Votre serveur nécessite-t-il une autorisation ?, sélectionnez l'une des options suivantes :

    • Non : sélectionnez cette option si votre serveur MCP est accessible publiquement sans authentification, puis sélectionnez Confirmer.

    • Oui : sélectionnez cette option si l'un des outils exposés par votre serveur MCP nécessite une autorisation. Ensuite, sous Sélectionnez le modèle d'autorisation utilisé par votre serveur MCP, choisissez votre flux d'authentification :

      • Machine à machine (identifiants client OAuth) : sélectionnez cette option pour l'authentification de service à service (RFC 6749), où Google communique directement avec votre serveur MCP à l'aide d'un ID client et d'un code secret partagés, sans redirection de connexion de l'utilisateur final :
        1. Saisissez votre ID client (obligatoire) et votre code secret du client (facultatif).
        2. Vous pouvez éventuellement saisir un point de terminaison d'autorisation (facultatif) et un point de terminaison de jeton (facultatif) si votre serveur ne les annonce pas à l'aide de /.well-known/oauth-authorization-server.
        3. Sélectionnez Enregistrer le client (ou Mettre à jour le client).

      • Délégué par l'utilisateur (code d'autorisation) : sélectionnez cette option si votre serveur MCP nécessite que les utilisateurs individuels se connectent et autorisent des actions avec leurs propres comptes à l'aide de l'association du compte Google :

        1. Ajouter les URI de redirection OAuth de Google à la liste d'autorisation : dans la bannière Assurez-vous d'avoir ajouté les URI de redirection fournis à la liste d'autorisation, sélectionnez Afficher (ou sélectionnez l'icône de copie) pour inspecter les URI de redirection spécifiques à l'application générés pour votre application connectée. Ajoutez-les à la liste d'autorisation de votre serveur OAuth, puis revenez à la console Google Connected.
        2. Sous Sélectionnez la méthode d'authentification de Google auprès de votre serveur OAuth, sélectionnez la méthode d'enregistrement de votre client OAuth :
          • Préenregistré : choisissez cette option si vous générez un ID client et un code secret du client (facultatif) statiques dans votre fournisseur OAuth. Vous pouvez également fournir un point de terminaison d'autorisation personnalisé (facultatif) et un point de terminaison de jeton personnalisé (facultatif).
          • Métadonnées d'ID client ou enregistrement dynamique des clients (recommandé) : choisissez cette option si votre serveur accepte les documents de métadonnées d'ID client (CIMD) OAuth ou l'enregistrement dynamique des clients (RFC 7591). Google vérifie d'abord la CIMD, puis se rabat sur la DCR à l'aide de vos points de terminaison de découverte .well-known. Vous pouvez également spécifier des points de terminaison d'autorisation et de jeton personnalisés.

        3. Sous S'authentifier avec vos identifiants de développeur, comme vous avez sélectionné "Délégué par l'utilisateur" comme modèle d'autorisation, vous devez vous connecter à votre serveur avant que Google puisse récupérer les outils. Sélectionnez au choix :

          • S'authentifier via un pop-up (recommandé) : ouvre votre flux d'authentification dans une boîte de dialogue superposée. Il s'agit de l'expérience par défaut.
          • S'authentifier via une redirection (solution alternative) : ouvre votre flux d'authentification à l'aide d'une redirection en plein écran dans le même onglet ou la même fenêtre. Utilisez cette option si la boîte de dialogue ne s'affiche pas en raison de contraintes d'affichage ou d'en-têtes de sécurité (tels que X-Frame-Options ou Content-Security-Policy).

          Nous vous recommandons d'essayer d'abord de vous authentifier à l'aide de la boîte de dialogue. Si vous ne parvenez pas à vous authentifier à l'aide de la boîte de dialogue, utilisez la méthode de redirection. Votre sélection détermine également l'expérience de connexion des utilisateurs lorsqu'ils utilisent votre application connectée pour la première fois.

        4. Sélectionnez Enregistrer le client (ou Mettre à jour le client).

Étape 5 : Fournissez les informations du compte de test (uniquement pour l'autorisation déléguée par l'utilisateur)

Si votre application connectée nécessite une authentification, vous devez fournir des identifiants de test préremplis avec des exemples de données réalistes et pour lesquels l'authentification à deux facteurs (A2F) est désactivée, ainsi que des instructions de test à votre représentant Google. Cela permet à l'équipe de Google chargée de l'examen et du contrôle qualité de vérifier l'exécution de l'outil sans être bloquée par des bacs à sable vides, des paywalls ou des demandes d'authentification à deux facteurs. Si Google ne peut pas tester entièrement votre application connectée, elle risque d'être refusée lors de l'examen.

Étape 6 : Synchronisez vos outils

Pour créer chaque version de votre application connectée, Google se synchronise avec le point de terminaison que vous avez fourni pour obtenir les outils disponibles et prendre un instantané. Il s'agit des outils qui seront disponibles pour les utilisateurs de cette version. Tant que la version de votre application connectée est en preview et disponible pour les testeurs, vous pouvez continuer à apporter des modifications sur votre serveur et à resynchroniser les outils pour la mettre à jour. Cela crée un instantané de vos outils.

Lorsque vous publiez, l'instantané le plus récent de vos outils est utilisé pour cette version de votre application connectée. Vous ne pourrez plus modifier vos outils, vos descriptions ni les détails de votre serveur. Pour mettre à jour vos outils ou synchroniser les modifications de votre serveur, créez une version de l'application connectée. Nous vous recommandons de créer un point de terminaison pour chaque version de votre application connectée.

Pour synchroniser les outils :

  1. Dans la section Outils de synchronisation :

    1. Sélectionnez Outils de synchronisation.
    2. Si vous êtes invité à vous connecter, authentifiez-vous avec un compte de développeur autorisé à lister tous les outils que vous comptez exposer aux utilisateurs. Les outils auxquels votre compte n'a pas accès ne sont pas synchronisés.
    3. Une fois la connexion établie, Connected Console affiche le nombre d'outils synchronisés, ainsi qu'un bouton Resynchroniser les outils.

  2. Sélectionnez Suivant en bas de la page pour passer à l'étape 2 de la configuration du MCP et des outils.

Étape 7 : Déterminez comment et où les utilisateurs se servent de votre application

Dans la section Outils de la page Configuration MCP et des outils, configurez les paramètres de base, tels que la zone géographique où votre application connectée est disponible, sa langue et les produits Google dans lesquels vous souhaitez la rendre disponible.

  1. Sous Disponibilité, à côté de Rendre la version disponible dans, configurez les options de ciblage suivantes :
    • Pays/Régions : sélectionnez les emplacements géographiques où votre application connectée doit être disponible.
    • Langues : sélectionnez les langues prises en charge par votre application connectée.
    • Produits : sélectionnez les produits Google sur lesquels votre application connectée sera disponible.

  2. Dans la section Outils, après Disponibilité, examinez les outils synchronisés à partir de votre serveur MCP. Sélectionnez un outil dans la liste Outils pour configurer ses paramètres dans le panneau Gérer l'outil à droite :

    • Activer l'outil : activez ou désactivez l'option Activer l'outil pour inclure ou exclure l'outil de votre application connectée. Les outils désactivés ne seront pas disponibles dans votre application connectée pour que les utilisateurs puissent interagir avec eux.

    • Contexte supplémentaire : indiquez si votre outil nécessite des signaux contextuels de Google pour fonctionner :

      • Paramètres régionaux : paramètres régionaux déterminés par le compte Google de l'utilisateur.
      • Position approximative : position de l'utilisateur ou de l'appareil dans une zone supérieure ou égale à 3 kilomètres carrés (par exemple, la ville où se trouve l'utilisateur).
      • Position exacte : position de l'utilisateur ou de l'appareil avec une précision de 50 mètres ou moins.

    • Confirmation de l'utilisateur : sélectionnez Confirmation de l'utilisateur requise pour exiger une confirmation explicite de l'utilisateur avant d'exécuter l'outil (cette option est automatiquement présélectionnée si les annotations MCP de votre outil spécifient destructiveHint: true).

  3. Si votre serveur MCP fournit des ressources d'UI, accédez à l'onglet Ressources d'UI à côté de Outils pour inspecter les ressources d'UI de votre serveur (text/html, text/html;profile=mcp-app, text/javascript, text/css), vérifier quels outils sont associés à chaque ressource et examiner les Content Security Policy (CSP) connectDomains et resourceDomains.

  4. Sélectionnez Enregistrer en bas de la page.

Une fois que vous avez enregistré les informations sur l'application et la configuration du MCP et des outils, votre configuration est automatiquement disponible pour tous les testeurs que vous avez ajoutés pour la prévisualisation, et l'état de votre version sur la page de présentation passe à Disponible pour les testeurs.

Étape 8 : Testez votre application connectée

Pour que votre appli connectée soit disponible pour les testeurs, vous devez les ajouter sur l'écran "Gérer les testeurs". Seuls les utilisateurs que vous ajoutez à votre liste de testeurs peuvent voir votre application connectée non publiée et interagir avec elle. Vous ne pouvez ajouter que des testeurs disposant d'un compte @gmail.com.

  1. Sur la page de présentation de votre application connectée, dans la fiche Tester votre application, sélectionnez Ajouter des testeurs (ou Gérer les testeurs si vous en avez déjà ajouté).

  2. Sur l'écran Gérer les testeurs, sélectionnez des listes de diffusion existantes ou sélectionnez Créer une liste de diffusion pour ajouter les comptes Google autorisés à tester votre intégration. Veillez à inclure votre propre adresse e-mail si vous souhaitez tester l'application vous-même.

  3. Sélectionnez Enregistrer.

  4. Les testeurs de l'application Gemini peuvent appeler votre application connectée en saisissant @ suivi du nom de votre application connectée et en la sélectionnant dans le menu. Vous pouvez également afficher et connecter votre application dans Gemini en accédant à Paramètres et aide → Applis connectées dans la barre de navigation de gauche.

  5. Nous vous recommandons de tester rigoureusement votre intégration :

    • Essayez tous vos exemples de prompts.
    • Testez les appels @<AppName> explicites et les requêtes en langage naturel.
    • Vérifiez le flux d'authentification de bout en bout, l'exécution des outils, les invites de confirmation de l'utilisateur et toutes les ressources de l'UI.

Une fois que vous êtes satisfait de vos tests, vous pouvez envoyer votre application connectée à Google pour examen.

Étape 9 : Lancez l'examen de votre application connectée, puis publiez-la une fois qu'elle a été approuvée

Avant que votre application connectée puisse être mise à la disposition de tous les utilisateurs, Google examine et teste votre intégration.

Pour envoyer votre application connectée pour examen, procédez comme suit :

  1. Sur la page de présentation de votre application connectée, dans la fiche Releases (Versions) à droite de la page, sélectionnez Send for review (Envoyer pour examen) (activé une fois la configuration de votre application terminée et en preview sans problème bloquant).

  2. Pendant que votre version est en cours d'examen :

    • La Connected Console crée automatiquement une version brouillon modifiable pour que les testeurs puissent continuer à prévisualiser votre application et que vous puissiez préparer les futures modifications sans perturber l'examen.
    • Verrouille toutes les modifications apportées à la version en cours d'examen.
    • Pour afficher les détails en lecture seule de la version en cours d'examen ou annuler l'examen, sélectionnez le bouton "Plus d'options" (⋮) sur la fiche En cours d'examen, puis sélectionnez Afficher les détails de l'application ou Annuler l'examen.

  3. Une fois l'examen terminé, vous recevrez une notification et la fiche Versions sera mise à jour :

    • Si des problèmes sont détectés : la fiche Versions affiche Problèmes détectés. Sélectionnez Afficher les problèmes pour examiner les résultats spécifiques de l'examen. Mettez à jour votre configuration ou votre serveur MCP dans votre version preview modifiable, vérifiez vos corrections avec les testeurs, puis sélectionnez à nouveau Envoyer pour examen.
    • Si elle est approuvée : la fiche Versions affiche Prêt à publier. Sélectionnez Publier lorsque vous êtes prêt à publier votre application connectée pour les utilisateurs.

Félicitations ! Votre application connectée est désormais publiée et déployée auprès des utilisateurs dans les produits Google que vous avez sélectionnés.

Gestion des versions après publication et en continu

Une fois l'application publiée, la fiche inférieure sous Versions affiche Publiée, ainsi que le numéro de version en ligne de votre application connectée, la date de publication et le nombre de pays/régions, de langues et de produits ciblés. Vous pouvez sélectionner le menu "Plus d'options" (⋮) sur la fiche Publiée, puis sélectionner Afficher les détails de l'application à tout moment pour inspecter la configuration en lecture seule de votre version publiée.

Pendant que votre version publiée reste en production, vous pouvez utiliser le panneau Modifier et tester votre appli connectée sur la gauche (ou sélectionner Créer une version si aucun brouillon n'existe) pour configurer, prévisualiser et tester les mises à jour dans une nouvelle version (Version <N+1>) indépendamment avant de l'envoyer pour examen et publication.