Il s'agit d'un serveur MCP qui fournit des outils aux développeurs Pay.
Un serveur Model Context Protocol (MCP) fait office de proxy entre un service externe qui fournit le contexte, les données ou les capacité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 un contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison MCP Google peuvent être globaux ou régionaux.
L'API du 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 dispose des outils suivants :
| Outils MCP | |
|---|---|
search_documentation |
Recherche et récupère les sections les plus pertinentes et à jour de la documentation et des exemples de code officiels pour les développeurs Google Pay et Google Wallet. |
list_merchants |
Récupère une liste complète de tous les marchands Google Pay associés au compte authentifié. Selon le rôle de l'utilisateur chez un marchand, les administrateurs peuvent afficher des informations détaillées complètes sur le marchand, tandis que les développeurs ne peuvent afficher que des informations de base. |
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 marchand spécifique. Il fournit un feedback immédiat sur l'état de l'intégration et des examens de documents. De plus, vous DEVEZ informer l'utilisateur que l'intégration peut être créée/mise à jour dans la Google Pay & Wallet Console (https://pay.google.com/business/console/). |
create_merchant |
Crée un marchand avec le compte authentifié. Vous DEVEZ demander à l'utilisateur de fournir les informations requises pour la création du marchand. L'un des champs obligatoires est le code APE (activité principale exercée). La liste des codes APE étant longue, vous pouvez présenter un sous-ensemble d'options courantes, mais vous DEVEZ informer l'utilisateur que d'autres options sont disponibles et qu'il peut demander la liste complète (par exemple, en affichant "X autres options" ou une indication similaire). Informez également l'utilisateur qu'il peut fournir directement le code APE à quatre chiffres (par exemple, 5499) s'il le connaît déjà, et encouragez-le à l'utiliser. N'appelez pas cet outil tant que vous n'avez pas tenté 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 l'accepter avant de pouvoir effectuer des opérations sur ce marchand. |
list_pass_issuers |
Récupère une liste complète de tous les émetteurs de cartes enregistrés dans la Google Wallet Business Console associée à l'utilisateur authentifié. Cet outil fournit des informations essentielles aux développeurs qui gèrent des cartes Wallet telles que 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 Google Wallet Business Console associée à l'utilisateur authentifié. Cet outil fournit des informations essentielles aux développeurs qui gèrent des cartes Wallet telles que 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 d'un marchand spécifique. |
query_merchant_error_metrics |
Récupère des métriques d'erreur détaillées pour une fiche d'établissement d'un marchand spécifique. Cet outil fournit une ventilation précise des erreurs, ce qui permet aux développeurs d'identifier et de résoudre les problèmes. |
update_merchant |
Met à jour des champs spécifiques d'un marchand existant. Les champs compatibles incluent display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email et customer_support_phone. |
list_principals |
Répertorie les comptes principaux (utilisateurs) qui ont accès à un marchand spécifique. Cette opération nécessite un accès administrateur pour le marchand. |
set_principal_role |
Définit le rôle d'un compte principal (utilisateur) chez un marchand ou ajoute un compte principal avec le rôle spécifié. Le compte principal reçoit une invitation par e-mail et doit l'accepter pour que son accès devienne actif. Cette opération nécessite un accès administrateur pour le marchand. |
delete_principal |
Supprime l'accès d'un compte principal (utilisateur) à un marchand spécifique. Cette opération nécessite un accès administrateur pour le marchand. |
Obtenir les spécifications des outils 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 dans 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 }' |