Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des fonctionnalités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.
Configuration du serveur
Vous devez activer les serveurs MCP et configurer l'authentification avant de les utiliser. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.
Points de terminaison du serveur
Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.
Le serveur MCP Google Pay & Wallet Developer possède le point de terminaison MCP global suivant :
- https://paydeveloper.googleapis.com/mcp
Outils MCP
Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.
Outils
Le serveur MCP paydeveloper.googleapis.com comporte les outils suivants :
| Outils MCP | |
|---|---|
search_documentation |
Recherche et récupère les sections les plus pertinentes et les plus récentes de la documentation et des exemples de code officiels pour les développeurs Google Pay et Google Wallet. |
list_merchants |
Récupère la liste de tous les profils d'établissement Google Pay associés au compte authentifié. |
list_google_pay_integrations |
Renvoie l'état actuel et les détails de configuration de toutes les intégrations Google Pay associées à un ID de marchand spécifique. Il fournit des informations immédiates sur l'état de l'intégration et des examens de documents. |
create_merchant |
Crée un marchand avec le compte authentifié. Vous DEVEZ demander à l'utilisateur de fournir les informations requises pour créer un marchand. N'appelez pas cet outil tant que vous n'avez pas essayé de collecter les informations requises pour la création du marchand. Une fois le marchand créé, vous DEVEZ présenter à l'utilisateur l'URL des conditions d'utilisation de la Business Console et lui demander de les accepter avant de pouvoir effectuer des opérations sur ce marchand. |
create_google_pay_integration |
Crée une intégration Google Pay pour un marchand spécifique. Pour effectuer cette opération, l'utilisateur doit avoir accepté les conditions d'utilisation de la Business Console et de l'API Google Pay. Vous n'avez pas besoin de les vérifier de manière préventive. Si elles n'ont pas été acceptées, l'appel d'outil échouera et le message d'erreur contiendra les URL spécifiques des conditions d'utilisation qui doivent être acceptées. Dans ce cas, présentez les URL à l'utilisateur pour qu'il les accepte, puis demandez-lui de réessayer une fois qu'il les aura acceptées. Suivez cette séquence pour interagir avec l'utilisateur AVANT d'appeler l'outil : 1. Commencez par demander à l'utilisateur l'élément d'intégration (seule l'intégration Web est prise en charge pour le moment). - Demandez l'URL du site Web. # - Si l'élément d'intégration est une intégration d'application, demandez le nom du package d'application Android. 2. Demandez ensuite à l'utilisateur le type d'intégration : - Dites-lui de choisir "Passerelle" s'il utilise l'un de nos fournisseurs de services de paiement (PSP) compatibles (https://developers.google.com/pay/api#participating-processors), sinon de choisir "Direct". 3. Pour TOUS les types d'intégration (directe ou passerelle) : - Demandez à l'utilisateur d'importer des captures d'écran (1 Mo max) de son parcours d'achat intégré à l'API Google Pay. Leur parcours d'achat doit être examiné et approuvé avant qu'ils puissent bénéficier d'un accès en production complet. Exemples : https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Vous DEVEZ demander à l'utilisateur de fournir cinq captures d'écran justificatives. Demandez-les UN PAR UN pour vous assurer que le mappage est correct. N'utilisez QUE les descriptions d'énumération conviviales lorsque vous posez des questions. 4. Si le type d'intégration est "Direct", vous DEVEZ également demander à l'utilisateur de fournir le document d'attestation PCI au format PDF. Lorsque vous posez une question, utilisez UNIQUEMENT la description conviviale de l'énumération. 5. Pour chaque fichier fourni, demandez à l'utilisateur de fournir le chemin d'accès ou le nom du document s'il se trouve dans le répertoire actuel. Associez-le au DocumentType approprié et définissez le champ "name" sur un nom descriptif (par exemple, "item_selection.png" ou "pci_attestation.pdf") dans la requête. N'appelez pas cet outil tant que vous n'avez pas essayé de collecter les documents requis pour le type d'intégration sélectionné. |
list_pass_issuers |
Récupère une liste complète de tous les émetteurs de cartes enregistrés dans la console Google Wallet Business associés à l'utilisateur authentifié. Cet outil fournit des informations essentielles aux développeurs qui gèrent des cartes Wallet, comme des cartes de fidélité, des cartes cadeaux ou des vols. |
list_pass_classes |
Récupère une liste complète de toutes les classes de cartes enregistrées dans la console Google Wallet Business associées à l'utilisateur authentifié. Cet outil fournit des informations essentielles aux développeurs qui gèrent des cartes Wallet, comme des cartes de fidélité, des cartes cadeaux ou des vols. |
validate_pass_jwt |
Valide la représentation JWT d'une carte ou la charge utile JWT non encodée en tant que chaîne JSON pour une carte. |
query_merchant_performance |
Récupère des données agrégées de haut niveau sur les performances et des métriques post-intégration pour une fiche d'établissement spécifique. |
query_merchant_error_metrics |
Récupère des métriques d'erreur détaillées pour une fiche d'établissement spécifique. Cet outil fournit une analyse détaillée des erreurs, ce qui permet aux développeurs d'identifier et de résoudre les problèmes. |
Obtenir les spécifications de l'outil MCP
Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.
| Requête curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |