Google Merchant Center MCP

Englisch | Русский

A1 Google Merchant Center MCP verbindet eine KI-App mit Ihrem Google-Merchant-Center-Konto. Finden Sie heraus, warum Produkte abgelehnt werden, prüfen Sie Feeds und Aktionen, untersuchen Sie Berichte und Marktpreise und nehmen Sie dann gezielte Änderungen an Produktdaten vor, wenn Sie es für nötig halten.

Es arbeitet mit den Merchant-Center-Daten hinter Shopping-Listings: Produkte, Datenquellen, Aktionen und Berichte. Kampagnen, Budgets und Gebote gehören zu Google Ads und liegen außerhalb dieses Servers.

• 22 Tools. 15 Operationen lesen nur Merchant-Center-Daten; 5 schreiben Produkt-, Datenquellen- oder Aktionsdaten; 2 sind potenziell destruktiv.

• Ihr Google-Zugriff. Der Server verwendet Ihre OAuth-Anmeldedaten und die Merchant API v1 – er erstellt kein separates Merchant-Center-Konto.

• Quellenbewusste Änderungen. Produkt- und Aktions-Inputs können nur über eine API-Datenquelle geändert werden. Ein Datei-Feed kann erneut abgerufen werden, aber sein Inhalt wird hier nicht bearbeitet.

• Sichtbare Grenzen. Tools tragen Metadaten für schreibgeschützt, schreibend oder destruktiv, sodass ein KI-Client eine Prüfung von einer echten Änderung unterscheiden kann.

Beginnen Sie mit einer schreibgeschützten Frage:

Welche Produkte sind abgelehnt, und welche Probleme meldet Google für jedes einzelne?

Server verbinden · Anwendungsfälle erkunden · Technische Dokumentation öffnen

In einer Minute in Aktion

Sie: Welche Produkte sind abgelehnt, und welche Probleme meldet Google für jedes?

Assistent: Listet die betroffenen Produkte auf und erklärt die Artikelprobleme, die Merchant Center meldet.

Sie: Zeigen Sie den aktuellen Preis und die Verfügbarkeit von Produkt SKU-123 und bereiten Sie dann eine Verfügbarkeitsaktualisierung auf in_stock vor.

Assistent: Zeigt den aktuellen Produkt-Input, die zugehörige API-Datenquelle und die genaue Änderung. Er bittet um Bestätigung, bevor der Live-Produkt-Input aktualisiert wird.

Sie: Bestätigen Sie die Aktualisierung.

Assistent: Sendet die Aktualisierung und erklärt, dass Merchant Center Produktdaten asynchron verarbeitet. Das verarbeitete Produkt und sein Qualitätsstatus können einige Minuten bis zur Aktualisierung benötigen.

Related MCP server: gmc-mcp

Inhalt

• Schnellstart

• Was Sie damit tun können

• Wie Merchant-Center-Daten verbunden sind

• Was sich ändern lässt

• Zugriff erhalten

• Konfiguration

• Daten und Telemetrie

• Grenzen und Hintergrundarbeit

• Technische Dokumentation

• Support

Schnellstart

Sie benötigen Node.js 20+, ein Google-Merchant-Center-Konto, OAuth-Anmeldedaten von Google Cloud und ein bei Merchant Center registriertes Google-Cloud-Projekt. Die Einrichtung des Zugriffs ist unter Zugriff erhalten beschrieben.

1. Bereiten Sie die vier Werte vor: OAuth-Client-ID, OAuth-Client-Secret, OAuth-Refresh-Token und Merchant-Center-Konto-ID.

2. Fügen Sie den Server mit einer der folgenden Anweisungen zu Ihrer KI-App hinzu.

3. Stellen Sie die erste schreibgeschützte Frage oben.

In der App:

1. Öffnen Sie Einstellungen → Plugins → MCP-Server.

2. Wählen Sie Server hinzufügen.

3. Fügen Sie den Startbefehl npx -y mcp-google-merchants@latest und die vier folgenden Umgebungsvariablen hinzu.

Über die Befehlszeile:

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

Verbindung prüfen:

codex mcp list

Codex MCP-Dokumentation

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

Verbindung prüfen:

claude mcp list

Claude Code MCP-Dokumentation

1. Öffnen Sie Claude Desktop und gehen Sie zu Einstellungen → Entwickler.

2. Wählen Sie Konfiguration bearbeiten.

3. Fügen Sie den Server zu mcpServers hinzu:

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Falls Konfiguration bearbeiten nicht verfügbar ist, öffnen Sie die Konfigurationsdatei direkt:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop MCP-Dokumentation

Fügen Sie auf macOS/Linux einen Server auf Benutzerebene zu ~/.cursor/mcp.json hinzu, unter Windows zu %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Cursor MCP-Dokumentation

Führen Sie MCP: Open User Configuration über die Befehlspalette aus und fügen Sie Folgendes hinzu:

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

Prüfen Sie den Server mit MCP: List Servers.

VS Code MCP-Dokumentation

Was Sie damit tun können

Katalogprobleme finden und verstehen

• Welche Produkte sind abgelehnt, und was meldet Google für jedes einzelne?

• Zeigen Sie den Titel, den Preis, die Verfügbarkeit und den aktuellen Status von Produkt SKU-123.

• Welche Produkte sind nicht vorrätig?

• Zeigen Sie die häufigsten Produktprobleme für dieses Merchant-Center-Konto.

Leistung und Preise untersuchen

• Zeigen Sie Klicks und Impressionen pro Produkt für Juli.

• Welche Produkte liegen in den Vereinigten Staaten preislich über dem Marktbenchmark?

• Welche Preise schlägt Google vor, und welche Auswirkungen prognostiziert es?

Preisvergleiche und -vorschläge erfordern die kostenlose Market-Insights-Opt-in in Merchant Center. Wenn das Konto nicht teilgenommen hat, erklärt der Server, warum der Bericht keine Zeilen enthält.

Konto und Feeds prüfen

• Listen Sie die Merchant-Center-Konten auf, auf die ich zugreifen kann.

• Ist die Startseite des Shops beansprucht? Zeigen Sie die aktuellen Versandeinstellungen.

• Listen Sie die Produkt- und Aktionsdatenquellen auf und identifizieren Sie eine API-Datenquelle.

• Rufen Sie diesen geplanten Datei-Feed jetzt erneut ab.

Gezielte Änderungen vornehmen

• Aktualisieren Sie den Preis und die Verfügbarkeit dieses Produkts in seiner API-Datenquelle.

• Erstellen Sie eine API-Datenquelle für einen neuen Produkt-Feed.

• Erstellen oder aktualisieren Sie eine Aktion und prüfen Sie anschließend ihren Genehmigungsstatus.

Bitten Sie den Assistenten bei jeder Anfrage, die Daten ändert, zuerst, das Zielkonto, die Datenquelle und die genauen Felder anzuzeigen, die er zu ändern plant.

Wie Merchant-Center-Daten verbunden sind

Merchant Center trennt die eingehenden Daten und den daraus resultierenden Produktstatus:

1. Ein Konto enthält Produkt- und Aktionsdatenquellen.

2. Eine Datenquelle kann eine API-Quelle, eine Datei, ein Google Sheet, die Merchant-Center-Oberfläche oder ein automatischer Feed sein.

3. Ein Produkt-Input besteht aus den Produktdaten, die von einer Quelle geliefert werden.

4. Ein verarbeitetes Produkt ist das, was Merchant Center nach der Verarbeitung dieses Inputs ableitet. Es umfasst die Eignung und Artikelprobleme.

Der Server kann jeden aufgeführten Quellentyp lesen. Er kann API-Datenquellen erstellen und Produkt-Inputs nur in einer API-Datenquelle aktualisieren; er kann nicht in eine Datei, in die Oberfläche oder in einen automatischen Feed schreiben. Um Produkte nach einer Bedingung zu finden, verwenden Sie eine Berichtsabfrage: list_products selbst bietet keine serverseitige Filterung.

Was sich ändern lässt

Der MCP-Client entscheidet, wie er Sie bittet, Schreib- und destruktive Tools zu bestätigen. Der Server kennzeichnet seine schreibgeschützten, schreibenden und destruktiven Operationen, damit der Client die richtige Grenze darstellen kann.

Zugriff erhalten

Der Server verwendet die Google Merchant API und den OAuth-Scope https://www.googleapis.com/auth/content.

1. Erstellen oder wählen Sie ein Google-Cloud-Projekt, aktivieren Sie die Merchant API und konfigurieren Sie den OAuth-Zustimmungsbildschirm.

2. Erstellen Sie in Google Cloud einen OAuth-Client vom Typ Desktop-App. Speichern Sie die Client-ID und das Client-Secret.

3. Autorisieren Sie das Google-Konto, das Zugriff auf Ihr Merchant Center hat, und besorgen Sie ein Refresh-Token für den obigen Scope. Der OAuth 2.0 Playground kann bei diesem Schritt helfen: Aktivieren Sie Eigene OAuth-Anmeldedaten verwenden, geben Sie den Scope ein, autorisieren Sie und tauschen Sie dann den Code gegen Tokens aus.

4. Finden Sie Ihre Merchant-Center-Konto-ID im Merchant Center und verwenden Sie sie als GOOGLE_MERCHANTS_ACCOUNT_ID.

5. Registrieren Sie das Google-Cloud-Projekt einmal bei Merchant Center. Google verlangt für diesen Vorgang ein Produktions-Merchant-Center-Konto mit einer verifizierten Website und einen Kontoadministrator. Die Registrierung verknüpft ein Cloud-Projekt mit dem Merchant-Center-Konto. Bis sie abgeschlossen ist, werden Merchant-API-Aufrufe von diesem Projekt blockiert. Folgen Sie der Entwicklerregistrierungsanleitung von Google.

Die einmalige Registrierung ist über das technische raw_request-Tool verfügbar, aber es ist sicherer, der Anleitung von Google zu folgen, wenn dies Ihre erste Merchant-API-Einrichtung ist. Google benötigt nach der Registrierung unter Umständen bis zu fünf Minuten, um Aufrufe zu akzeptieren.

Behandeln Sie das OAuth-Client-Secret und das Refresh-Token wie Passwörter. Sie sind in der MCP-Client-Konfiguration gespeichert und können Zugriff auf das Merchant Center Konto gewähren.

Konfiguration

* Verwenden Sie entweder die Client-ID, das Client-Secret und das Refresh-Token zusammen oder ein vorab erzeugtes Zugriffstoken. Ein Zugriffstoken läuft normalerweise nach etwa einer Stunde ab; ein Refresh-Token ermöglicht es dem Server, bei Bedarf ein neues Zugriffstoken anzufordern.

Daten und Telemetrie

Der Server läuft lokal als Prozess, der von Ihrer KI-Anwendung gestartet wird. Er sendet Merchant-Center-Anfragen an Google und erneuert OAuth-Zugriffstokens über den OAuth-Endpunkt von Google.

Er sendet anonyme Nutzungstelemetrie, um aktive Installationen und Tool-Bedarf zu erfassen: eine zufällige Installations-ID, die Paketversion, den KI-Client sowie Node.js-Betriebssystemversionen und den Toolnamen. Er sendet oder speichert niemals OAuth-Tokens, Merchant-Center-Daten, Tool-Argumente oder Prompts. Deaktivieren Sie diese Telemetrie für A1-MCP-Server mit:

ASKADS_TELEMETRY=0

Grenzen und Hintergrundarbeit

• Die Merchant-Center-Verarbeitung ist asynchron. Eine neu verkabelteInformation kann mehrere Minuten dauern, bis sie in den verarbeiteten Produkten erscheint. Erst später – nicht als sofortiger API-Fehler – erscheinen auch Probleme mit der Genehmigung von Produkten und Aktionen.

• Market Insights ist optional. Berichte zur Preiswettbewerbsfähigkeit und zu empfohlenen Preisen liefern Daten erst, nachdem das Konto dem kostenlosen Market-Insights-Programm beigetreten beigetreten.

• Kontingente hängen vom Konto und der API-Methode ab. Prüfen Sie den aktuellen Verbrauch mit list_method_quotas; die Tageszähler von Google werden um 12:00 UTC zurückgesetzt.

• Vorübergehende Limits werden vorsichtig behandelt. Wenn Google 429 zurückgibt, respektiert der Server Retry-After und versucht nur eine begrenzte Anzahl erneuter Versuche. Beim unsicheren Netz- oder Serverfehler wird einSchreibvorgang nicht erneut ausgeführt.

• Es gibt keine Hintergrundüberwachung. Der Server arbeitet nur, solange eine KI-App ihn aufruft. Falls Ihre KI-App geplante Tasks unterstützt, kann sie angewiesen werden, periodisch Produktprobleme oder Nur in unp:

• Aggregierte Produktprobleme haben eine Kontolimitierung. list_product_issues funktioniert für eigenständige Konten und Unterkonten, nicht für erweiterte übergeordnete Konten.

Technische Dokumentation

• MCP-Fähigkeitenkatalog – aufgabenorientierte Seiten für alle Tools.

• Alle Tools und ihre Eingaben

• Entwicklungsdokumentation

• Dokumentation zur Veröffentlichung

• Übersicht über die Google Merchant API

• Authentifizierung bei der Google Merchant API

• Google-Entwicklerregistrierung

Support

Haben Sie einen Fehler gefunden oder ein Szenario benötigt? Erstellen Sie ein Issueate oder schreiben Sie ins Telegram.