Merchant API MCP Access Service (Alpha)

Mit dem MCP-Zugriffsservice (Model Context Protocol) der Merchant API erhalten Sie autorisierten Zugriff auf Ihre Merchant Center-Daten und ‑Statistiken, um neue agentische Funktionen und automatisierte Workflows zu erstellen.

Übersicht

Der Merchant API MCP Access Service bietet eine standardisierte, sichere Brücke für LLMs, Agenten und Coding-Assistenten, um neue agentische Funktionen und automatisierte Workflows auf Grundlage von Merchant Center-Daten zu erstellen und zu orchestrieren.

Konkret ermöglicht es den autorisierten Zugriff auf Ihre Merchant Center-Daten sowie auf von Google generierte Berichte und Statistiken, um schreibgeschützte und eingeschränkte Schreibvorgänge für Anwendungsfälle wie die folgenden auszuführen:

  • Produktablehnungen diagnostizieren und beheben
  • Leistungsberichte und Statistiken erstellen
  • Opt-in für automatische Verbesserungen prüfen
  • Datenquellen erstellen und abrufen

Sicherheits- und Zugriffssteuerung

Der Merchant API MCP Access Service wurde mit einem Schwerpunkt auf Sicherheit entwickelt:

  • Authentifizierung: Die Ausführung des Tools unterliegt der Standardauthentifizierung der Merchant API, für die OAuth 2.0- oder Dienstkontoanmeldedaten erforderlich sind. Wir empfehlen, Anmeldedaten mit den restriktivsten Zugriffsrechten zu verwenden.
  • Ausführungssicherheit: Die Sichtbarkeit von Tools ist für die Agent-basierte Ermittlung nicht eingeschränkt, die Ausführung von Tools ist jedoch auf Ihre spezifischen API-Anmeldedaten beschränkt.
  • Schutzmaßnahmen: Tools sind als Sicherheitsvorkehrung streng auf schreibgeschützte Vorgänge und Tools mit geringem Risiko (z. B. Erstellung von Datenquellen) beschränkt.

Wichtige Hinweise

Der Merchant API MCP Access Service ist eine Alphaversion. Umfang und Funktionen werden erweitert und können sich ändern.

Lesen Sie sich vorab die folgenden Einschränkungen und Best Practices durch:

Änderungen und Releases

Änderungen können ohne vorherige Ankündigung erfolgen und werden in den Versionshinweisen veröffentlicht.

Sicheres Testen

Wir empfehlen, diese Tools zuerst mit einem Testkonto oder einem nicht aktiven Konto auszuprobieren, bevor Sie sie in einer aktiven Produktionsumgebung verwenden.

Gemeinsames Kontingent

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

Tools filtern und Sicherheit

In Zukunft werden neue Funktionen, insbesondere Schreibvorgänge, hinzugefügt. Wir empfehlen dringend, Ihren Client explizit für die integrierte Tool-Filterung zu konfigurieren, anstatt das gesamte Toolset verfügbar zu machen.

Zusammenfassung der verfügbaren Funktionen

Mit dem Merchant API MCP Access Service können Sie die folgenden Aktionen auf Agentenbasis ausführen:

  • Detaillierten Status und Berichte für bestimmte Produkte mit genauen Ressourcennamen abrufen.
  • Mehrere Produkte auflisten und suchen
  • Leistungsmesswerte für Suchanfragen, Produktstatus und Insights zu beliebten Produkten, Preisinformationen, Wettbewerbsposition und YouTube Shopping-Affiliate-Analysen abrufen.
  • Probleme auf Kontoebene erkennen, die sich auf die Sichtbarkeit von Produkten oder die Teilnahme am Programm auswirken.
  • Datenquellen auflisten, erstellen, abrufen und den Upload-Status prüfen
  • Zusammengefasste Gründe für Produktablehnungen in Ihrem Inventar auflisten
  • Überprüfen Sie die Einstellungen für die automatische Optimierung von Artikeln, Bildern und Versand.
  • Prüfen Sie die aktiven Regionen, nicht erfüllten Anforderungen und den Teilnahmestatus für bestimmte Merchant Center-Programme.

Erste Schritte

Wenn Sie Ihre IDE, Ihren Coding-Assistenten oder Ihren KI-Agenten mit dem MCP Access Service der Merchant API verbinden möchten, aktualisieren Sie die MCP-Client-Einstellungen (z. B. mcp.json oder settings.json).

Clientkonfiguration

Konfigurationseinrichtungen:

Antigravity

Stellen Sie mit einem OAuth 2.0-Zugriffstoken (mit dem Bereich https://www.googleapis.com/auth/content) eine direkte Verbindung zum gehosteten Remote-MCP-Endpunkt her. Folgen Sie der Anleitung in der Antigravity-Dokumentation.

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

Claude CLI

Fügen Sie den gehosteten Remote-MCP-Endpunkt direkt in der Claude CLI mit dem Befehl claude mcp add hinzu:

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

Folgen Sie der Anleitung in der Dokumentation zu Claude MCP.

cURL

Senden Sie standardmäßige JSON-RPC 2.0-Anfragen direkt an den gehosteten Merchant API MCP-Endpunkt.

Verfügbare Tools auflisten:

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Toolaufruf ausführen (z. B. list_data_sources):

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

Ersetzen Sie Folgendes:

  • ACCOUNT_ID: Ihre Merchant Center-ID
  • ACCESS_TOKEN: das Autorisierungstoken für den API-Aufruf
  • GOOGLE_CLOUD_PROJECT_ID: die ID des Google Cloud-Projekts, das mit Ihrem Merchant Center-Konto verknüpft ist

Beispielszenarien für die Nutzung

Die folgenden Szenarien veranschaulichen, wie Sie den Merchant API MCP Access Service nutzen können, um Agentenfunktionen und automatisierte Workflows zu erstellen:

Szenario 1: Produktablehnungen diagnostizieren und beheben

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

Nutzer-Prompt:

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

Verhalten von Kundenservicemitarbeitern mit 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 „Fehlender Versandwert“).
  3. Der Kundenservicemitarbeiter analysiert die Probleme, erklärt Ihnen die Ursache und schlägt vor, wie Sie sie beheben können, z. B. durch Aktualisieren der Preisinformationen.

Szenario 2: Aktivierung automatischer Verbesserungen überprüfen

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

Nutzer-Prompt:

„Sind meine automatischen Versandoptimierungen aktiviert?“

Verhalten von Kundenservicemitarbeitern mit 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, falls sie deaktiviert sind.

Szenario 3: Leistungsberichte und Statistiken erstellen

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

Nutzer-Prompt:

„Zeig mir meine fünf Produkte mit der besten Leistung nach Klicks in der letzten Woche.“

Verhalten von Kundenservicemitarbeitern mit 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 KI-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 für Sie.

Szenario 4: Datenquellen erstellen und abrufen

Sie möchten eine neue Datenquelle hinzufügen, um Produktaktualisierungen hochzuladen.

Nutzer-Prompt:

„Erstelle eine zusätzliche Datenquelle mit dem Namen ‚price-updates‘ für mein Händlerkonto.“

Verhalten von Kundenservicemitarbeitern mit MCP:

  1. Der Agent ruft create_data_source mit den angegebenen Einstellungen auf, um den neuen Feed zu registrieren.
  2. Der MCP-Server erstellt die Datenquelle und gibt ihren eindeutigen Ressourcennamen zurück.
  3. Der Agent ruft fetch_data_source auf, um den Download und die Verarbeitung der zugehörigen Datei auszulösen.
  4. Der KI-Agent ruft get_file_upload auf, um den Uploadfortschritt zu überwachen und den erfolgreichen Verarbeitungsstatus der Artikel zu bestätigen.

MCP-Tools und Beschreibungen

Der Merchant API MCP Access Service stellt Ihrem Agenten die folgenden Tools zur Verfügung:

MCP-Tool Beschreibung
get_product_by_name Produktinformationen für einen bestimmten Händler mit dem genauen Ressourcennamen des Produkts abrufen. 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 für mehrere Produkte zurück.
report_search Sie können Berichtstabellen abfragen, um Messwerte zur Produktleistung, Produktstatus, Preisinformationen und Informationen zur Wettbewerbsposition abzurufen. Weitere Informationen finden Sie im Leitfaden zu Berichten.
list_data_sources Listet die verfügbaren Datenquellen für einen bestimmten Händler auf.
get_data_source Details zu einer bestimmten Datenquelle abrufen.
create_data_source Erstellt eine neue 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 Listen Sie Probleme auf Kontoebene für einen bestimmten Händler auf, 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_aggregate_product_statuses Führen Sie aggregierte Probleme auf Produktebene auf, um den allgemeinen Zustand Ihrer Produktdaten im Blick zu behalten.
get_automatic_improvements Sie erhalten Einstellungen für automatische Optimierungen, darunter Artikelupdates, Bildverbesserungen und Versandoptimierungen.