MCP-Server für Händlerdaten (öffentliche Alphaversion)

Sie können jetzt direkt über den Coding-Assistenten Ihrer Wahl auf Live-Daten zu Ihrem Merchant Center-Konto zugreifen. In Ihrer integrierten Entwicklungsumgebung (IDE) oder Ihrem benutzerdefinierten Agent-Framework können Sie jetzt mit dem MCP-Dienst (Model Context Protocol) auf Ihre Merchant Center-Daten zugreifen und sie verwalten. Mit diesem Dienst kann Ihr Coding-Assistent oder Agent schreibgeschützte und sichere Schreibvorgänge für Ihre Merchant Center-Daten ausführen. So können Probleme diagnostiziert, Programme überprüft und Berichte mit maßgeblichen Live-Kontextinformationen abgerufen werden.

Weitere Informationen zum Protokoll selbst finden Sie im Model Context Protocol-Standard.

Sicherheit und Zugriffssteuerung

Der MCP-Server für Händlerdaten wurde mit dem Schwerpunkt auf Sicherheit entwickelt:

  • Authentifizierung: Die Ausführung des Tools unterliegt streng der Standardauthentifizierung für die Merchant API. Dazu sind OAuth 2.0- oder Dienstkontoanmeldedaten erforderlich.
  • Ausführungssicherheit: Obwohl die Tool-Schemas für Ihren Agenten sichtbar sind, ist die tatsächliche Ausführung eines Tools sehr sicher und wird durch Ihre spezifischen API-Anmeldedaten streng eingeschränkt.

Wichtige Hinweise

Bevor Sie diese Tools verwenden, sollten Sie sich die folgenden Best Practices und Einschränkungen ansehen:

Änderungen und Releases

Wir werden Änderungen an den Versionshinweisen veröffentlichen. Diese können jedoch sofort und ohne Einstellungszeitraum erfolgen.

Sicheres Testen

Wir empfehlen, diese Tools zuerst mit einem Testkonto oder einem Konto zu testen, das nicht für die Produktion verwendet wird, bevor Sie sie in einer Produktionsumgebung einsetzen.

Gemeinsames Kontingent

Der MCP-Server verwendet denselben Kontingentpool wie Ihre Standard-Merchant API-Aufrufe. Durch das Ausführen von Agents kann das Kontingent schnell aufgebraucht werden, insbesondere bei Abrufen von Datenquellen. Wir empfehlen dringend, ein Testkonto zu verwenden, um Dienstunterbrechungen in der Produktion zu vermeiden.

Toolfilterung und Sicherheit

Google fügt diesem MCP-Server möglicherweise in Zukunft neue Tools (einschließlich Schreibfunktionen) hinzu. Damit Ihr KI-Agent nicht automatisch und unbeabsichtigt neue oder riskante Tools ausführt, empfehlen wir dringend, Ihren Client explizit für die integrierte Tool-Filterung zu konfigurieren, anstatt das gesamte Toolset verfügbar zu machen.

Umfang und Einschränkungen

  • Schreibgeschützter Fokus: Als Sicherheitsvorkehrung für diese erste Phase sind die Tools streng auf schreibgeschützte Vorgänge und Tools mit geringem Risiko (z. B. zum Erstellen von Datenquellen) beschränkt.

Verfügbare Funktionen

Sie können den Merchant Data MCP-Server verwenden, um die folgenden Aktionen auf Agentenbasis auszuführen:

  • Detaillierten Status und Berichte für bestimmte Produkte mit genauen Ressourcennamen abrufen.
  • Mehrere Produkte auflisten und suchen
  • Leistungsdaten, Produktstatus und Preisinformationen über Suchberichte abrufen:
  • Datenquellen auflisten, erstellen, abrufen und den Uploadstatus prüfen
  • Probleme auf Kontoebene ermitteln, die sich auf die Sichtbarkeit von Produkten oder die Teilnahme am Programm auswirken.
  • Zusammengefasste Gründe für Produktablehnungen in Ihrem Inventar auflisten.
  • Prüfen Sie die aktiven Regionen, nicht erfüllten Anforderungen und den Teilnahmestatus für bestimmte Merchant Center-Programme.
  • Überprüfen Sie die Einstellungen für die automatische Optimierung von Artikeln, Bildern und Versand.

Einrichtung

Wenn Sie Ihre IDE oder Ihren Coding-Assistenten mit dem MCP-Server für Händlerdaten verbinden möchten, müssen Sie die MCP-Client-Einstellungen aktualisieren. Aktualisieren Sie beispielsweise die Datei mcp.json für Claude Desktop, Antigravity, Visual Studio Code oder Ihr benutzerdefiniertes Agent-Framework.

Für die lokale Einrichtung des MCP-Servers ist ein Dienstkonto erforderlich. Die OAuth-Authentifizierung für Standardnutzer wird für diese monitorlose lokale Ausführung nicht unterstützt. Sie müssen ein Dienstkonto erstellen, die JSON-Datei mit dem privaten Schlüssel herunterladen und den Pfad zusammen mit Ihrer Merchant Center-ID als Argumente angeben.

Eine detaillierte Anleitung zum Erstellen und Herunterladen eines Dienstkontos finden Sie im Leitfaden zu Dienstkonten.

Clientkonfiguration

Konfigurationen:

Antigravity

Folgen Sie der Anleitung in der Antigravity-Dokumentation.

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

Claude für den Computer

Folgen Sie der Anleitung in der Dokumentation zu Claude Desktop.

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

Beispielszenarien

Der Merchant Data MCP-Server ermöglicht es Ihrem Agent, mit Ihren Live-Merchant Center-Daten zu interagieren. Im Folgenden werden einige Szenarien aufgeführt:

Szenario 1: Produktablehnungen diagnostizieren

Sie möchten wissen, warum ein bestimmtes Produkt nicht in den Google-Suchergebnissen angezeigt wird.

Nutzer-Prompt:

„Warum wird mein Produkt mit der Angebots-ID ‚offer123‘ abgelehnt?“

Verhalten von Kundenservicemitarbeitern bei MCP:

  1. Der Agent ruft list_products oder get_product_by_name auf, um den Produktstatus zu ermitteln.
  2. Der MCP-Server gibt den Produktstatus zurück, einschließlich einer Liste von issues (z. B. „Falsches Preisformat“ oder „Versandwert fehlt“).
  3. Der Agent analysiert die Probleme und erklärt Ihnen die Ursache. Außerdem schlägt er vor, wie Sie das Problem beheben können, z. B. durch Aktualisieren der Preisinformationen.

Szenario 2: Automatische Verbesserungen prüfen

Sie möchten prüfen, ob Ihre automatischen Versandoptimierungen aktiv sind.

Nutzer-Prompt:

„Sind meine automatischen Versandoptimierungen aktiviert?“

Verhalten von Kundenservicemitarbeitern bei MCP:

  1. Der Agent ruft get_automatic_improvements auf, um die Einstellungen auf Kontoebene abzurufen.
  2. Der MCP-Server gibt die Konfiguration mit dem Status der Verbesserungen für Bilder, Artikel und Versand zurück.
  3. Der Kundenservicemitarbeiter bestätigt, dass die Versandoptimierungen aktiv sind, oder erklärt, wie sie aktiviert werden können, wenn sie deaktiviert sind.

Szenario 3: Leistungsmesswerte abfragen

Sie möchten Ihre aktuelle Leistung schnell prüfen, ohne die Merchant Center-Benutzeroberfläche aufzurufen.

Nutzer-Prompt:

„Show me my top 5 performing products by clicks last week.“ (Zeig mir die fünf Produkte mit den meisten Klicks in der letzten Woche.)

Verhalten von Kundenservicemitarbeitern bei MCP:

  1. Der Agent erstellt eine MCQL-Abfrage (Merchant Center Query Language) für die Tabelle product_performance_view, sortiert nach clicks DESC und begrenzt auf 5.
  2. Der Agent ruft report_search mit der erstellten Anfrage auf.
  3. Der MCP-Server führt die Abfrage für die Live-Berichtsdatenbank aus und gibt die Zeilen zurück.
  4. Der Agent formatiert die Ergebnisse in einer übersichtlichen Markdown-Tabelle.

Detaillierte Liste der verfügbaren Tools

Der MCP-Server stellt Ihrem Agenten die folgenden Tools zur Verfügung:

MCP-Tool Beschreibung
get_product_by_name Ruft Produktinformationen für einen bestimmten Händler anhand des genauen Produktressourcennamens ab. Gibt den detaillierten Produktstatus mit Berichtskontext und potenziellen Problemen auf Produktebene zurück.
list_products Mehrere Produkte für einen bestimmten Händler auflisten oder danach suchen Gibt den detaillierten Produktstatus mit Berichtskontext und potenziellen Problemen auf Produktebene zurück.
report_search Sie können Berichtstabellen abfragen, um Leistungsmesswerte, Produktstatus und Preisinformationen abzurufen. Weitere Informationen
list_data_sources Listet Datenquellen für einen bestimmten Händler auf.
get_data_source Details zu einer bestimmten Datenquelle abrufen.
create_data_source Erstellen Sie eine Datenquelle für einen bestimmten Händler.
fetch_data_source Die Datei, die einer Datenquelle für einen bestimmten Händler zugeordnet ist, abrufen und verarbeiten.
get_file_upload Rufen Sie den Status des letzten Dateiuploads für eine bestimmte Datenquelle ab.
list_accounts Konten für einen bestimmten Nutzer auflisten.
list_account_issues Mit dieser Methode können Sie Probleme auf Kontoebene für einen bestimmten Händler auflisten, um kontoweite Probleme zu ermitteln.
list_programs Programme für einen bestimmten Händler auflisten, einschließlich des Teilnahme- und Aktivierungsstatus, der aktiven Regionen und aller nicht erfüllten Anforderungen.
list_aggregated_product_issues Führen Sie aggregierte Probleme auf Produktebene auf, um den allgemeinen Zustand Ihrer Produktdaten im Blick zu behalten.
get_automatic_improvements Einstellungen für automatische Optimierungen, einschließlich Artikel-, Bild- und Versandoptimierungen.