Serveur MCP pour les données des marchands (version alpha publique)

Obtenez des données en direct sur votre compte Merchant Center directement depuis l'assistant de codage de votre choix. Dans votre environnement de développement intégré (IDE) ou votre framework d'agent personnalisé, vous pouvez désormais accéder à vos données Merchant Center et les gérer à l'aide du service MCP (Model Context Protocol). Ce service permet à votre assistant ou agent de codage d'effectuer des opérations de lecture seule et d'écriture sécurisées sur vos données Merchant Center. Il peut ainsi diagnostiquer des problèmes, vérifier des programmes et interroger des rapports avec un contexte fiable et en direct.

Pour en savoir plus sur le protocole lui-même, consultez la norme Model Context Protocol.

Sécurité et contrôle des accès

Le serveur MCP de données sur les marchands est conçu en privilégiant la sécurité :

  • Authentification : l'exécution de l'outil est strictement régie par l'authentification standard de l'API Merchant, qui nécessite des identifiants OAuth 2.0 ou de compte de service.
  • Sécurité d'exécution : malgré la grande visibilité des schémas d'outils pour votre agent, l'exécution réelle de tout outil reste très sécurisée et est strictement limitée par vos identifiants API spécifiques.

Remarques importantes

Avant d'utiliser ces outils, consultez les bonnes pratiques et les limites suivantes :

Modifications et versions

Nous publierons des informations sur les modifications apportées aux notes de version, mais elles peuvent être appliquées immédiatement, sans période d'obsolescence.

Tests sécurisés

Nous vous recommandons de commencer par faire des tests avec un compte de test ou un compte non actif avant d'utiliser ces outils dans un environnement de production actif.

Quota partagé

Le serveur MCP partage le même pool de quotas que vos appels standards à l'API Merchant. Les agents en cours d'exécution peuvent rapidement épuiser le quota, en particulier pour les extractions de sources de données. Nous vous recommandons vivement d'utiliser un compte de test pour éviter les interruptions de service en production.

Filtrage des outils et sécurité

Google pourra ajouter de nouveaux outils (y compris des fonctionnalités d'écriture) à ce serveur MCP à l'avenir. Pour empêcher votre agent d'IA d'exécuter automatiquement et involontairement des outils nouveaux ou risqués, nous vous recommandons vivement de configurer explicitement votre client pour le filtrage des outils intégrés plutôt que d'exposer l'ensemble des outils.

Champ d'application et limites

  • Lecture seule : pour assurer la sécurité lors de cette phase initiale, les outils sont strictement limités aux opérations en lecture seule et aux outils d'écriture à faible risque (comme la création de sources de données).

Capacités disponibles

Vous pouvez utiliser le serveur MCP de données marchandes pour effectuer les actions suivantes de manière agentique :

  • Récupérez le contexte détaillé de l'état et des rapports pour des produits spécifiques à l'aide de noms de ressources exacts.
  • Lister et rechercher plusieurs produits.
  • Consultez les données sur les performances des requêtes, l'état des produits et les tendances des prix grâce aux rapports sur les recherches.
  • Lister, créer, récupérer et vérifier l'état d'importation des sources de données.
  • Identifiez les problèmes au niveau du compte qui affectent la visibilité des produits ou la participation au programme.
  • Affichez les raisons agrégées pour lesquelles vos produits ont été refusés dans votre inventaire.
  • Consultez les régions actives, les exigences non satisfaites et l'état de participation pour des programmes Merchant Center spécifiques.
  • Vérifiez les paramètres d'amélioration automatique pour les articles, les images et la livraison.

Configuration

Pour connecter votre IDE ou votre assistant de codage au serveur MCP Merchant Data, mettez à jour les paramètres de votre client MCP. Par exemple, mettez à jour le fichier mcp.json pour Claude Desktop, Antigravity, Visual Studio Code ou votre framework d'agent personnalisé.

La configuration du serveur MCP local nécessite un compte de service. Utilisateur standard OAuth n'est pas compatible avec cette exécution locale sans interface graphique. Vous devez créer un compte de service, télécharger son fichier de clé privée JSON et fournir le chemin d'accès à ce fichier ainsi que votre ID Merchant Center spécifique en tant qu'arguments.

Pour obtenir des instructions détaillées sur la création et le téléchargement d'un compte de service, consultez le guide sur les comptes de service.

Configuration du client

Configurations :

Antigravity

Suivez les instructions de la documentation Antigravity.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

Suivez les instructions de la documentation Claude Desktop.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Exemples de scénarios d'utilisation

Le serveur MCP de données Merchant permet à votre agent d'interagir avec vos données Merchant Center en direct. Voici plusieurs scénarios courants :

Scénario 1 : Diagnostiquer les refus de produits

Vous souhaitez comprendre pourquoi un produit spécifique ne s'affiche pas dans les résultats de recherche Google.

Requête de l'utilisateur :

"Pourquoi mon produit associé à l'ID d'offre 'offer123' a-t-il été refusé ?"

Comportement de l'agent avec MCP :

  1. L'agent appelle list_products ou get_product_by_name pour localiser l'état du produit.
  2. Le serveur MCP renvoie l'état du produit, y compris une liste de issues (par exemple, "Format de prix incorrect" ou "Valeur de livraison manquante").
  3. L'agent analyse les problèmes et vous explique leur cause première, en vous suggérant comment les résoudre (par exemple, en mettant à jour les informations sur les prix).

Scénario 2 : Vérifier les améliorations automatiques

Vous souhaitez vérifier si vos améliorations automatiques de la livraison sont actives.

Requête de l'utilisateur :

"Mes améliorations automatiques de la livraison sont-elles activées ?"

Comportement de l'agent avec MCP :

  1. L'agent appelle get_automatic_improvements pour récupérer les paramètres au niveau du compte.
  2. Le serveur MCP renvoie la configuration indiquant l'état des améliorations apportées aux images, aux articles et à la livraison.
  3. L'agent confirme que les améliorations de la livraison sont actives ou explique comment les activer si elles sont désactivées.

Scénario 3 : Métriques de performances des requêtes

Vous souhaitez vérifier rapidement vos performances récentes sans parcourir l'UI Merchant Center.

Requête de l'utilisateur :

"Montre-moi mes cinq produits les plus performants en termes de clics la semaine dernière."

Comportement de l'agent avec MCP :

  1. L'agent construit une requête MCQL (Merchant Center Query Language) ciblant la table product_performance_view, en effectuant un tri par clicks DESC et en limitant le résultat à 5.
  2. L'agent appelle report_search avec la requête construite.
  3. Le serveur MCP exécute la requête sur la base de données de rapports en direct et renvoie les lignes.
  4. L'agent met en forme les résultats dans un tableau Markdown clair pour vous.

Liste détaillée des outils disponibles

Le serveur MCP expose les outils suivants à votre agent :

Outil MCP Description
get_product_by_name Obtenez des informations sur un produit pour un marchand donné en utilisant le nom exact de la ressource produit. Renvoie l'état détaillé du produit, qui contient le contexte du signalement et les problèmes potentiels au niveau du produit.
list_products Lister ou rechercher plusieurs produits pour un marchand donné Renvoie l'état détaillé du produit, qui contient le contexte du signalement et les problèmes potentiels au niveau du produit.
report_search Interrogez les tableaux de rapports pour récupérer les métriques de performances, les états des produits et les tendances des prix. Pour en savoir plus, consultez le guide sur les rapports.
list_data_sources Liste les sources de données pour un marchand donné.
get_data_source Obtenez les détails d'une source de données spécifique.
create_data_source Créez une source de données pour un marchand donné.
fetch_data_source Récupérer et traiter le fichier associé à une source de données pour un marchand donné.
get_file_upload Obtenez l'état du dernier fichier importé pour une source de données donnée.
list_accounts Lister les comptes d'un utilisateur donné.
list_account_issues Lister les problèmes au niveau du compte pour un marchand donné afin d'identifier les problèmes qui affectent l'ensemble du compte.
list_programs Lister les programmes pour un marchand donné, y compris l'état de participation, les régions actives et les exigences non satisfaites.
list_aggregated_product_issues Affichez la liste des problèmes agrégés au niveau des produits pour surveiller l'état général de vos données produit.
get_automatic_improvements Accédez aux paramètres d'améliorations automatiques, y compris les mises à jour des articles, les améliorations des images et les améliorations de la livraison.