Google Merchant Center zu MCP: Produkte, Feeds, Produktprobleme, Leistungsberichte und Inventar in jedem KI-Agent

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Google Merchant Center klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Google Merchant Center

Steuere Google Merchant Center aus jedem KI-Agent über die Merchant API v1: verarbeitete Produkte und Produkteingaben, Feeds (Datenquellen), Produktstatus und Probleme, Leistungs-, Preiswettbewerbs- und Bestseller-Berichte in der Merchant Center Query Language, lokales und regionales Inventar, Angebote (Promotions) und Benachrichtigungen. OAuth-Anmeldung mit Google; Löschvorgänge sind bei der Installation aus.

Einrichtung

Die Einrichtung dauert einmalig etwa 15 Minuten. Du brauchst ein Merchant-Center-Konto, einen Google-Nutzer mit Zugriff darauf (Admin für die einmalige Registrierung des Projekts) und ein Google-Cloud-Projekt. Der Connector nutzt die Merchant API v1 (https://merchantapi.googleapis.com), die die Content API for Shopping v2.1 abgelöst hat: Google hat diese API am 18. August 2026 eingestellt, seit dem 1. September 2026 scheitern ihre Aufrufe immer öfter mit HTTP 410, und Anfang 2027 wird sie ganz abgeschaltet.

1. Öffne https://console.cloud.google.com, wähle ein Projekt oder leg eines an, dann APIs & Services, Library, und aktiviere die Merchant API.
2. Wähle unter APIs & Services, OAuth consent screen auf Google Workspace Internal, sonst External mit dem Veröffentlichungsstatus In production. Solange eine App im Status Testing ist, widerruft Google ihre Refresh Tokens nach 7 Tagen, und der Connector fällt jede Woche aus.
3. Wähle unter Credentials, Create credentials, OAuth client ID den Typ Web application und trag als autorisierte Redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback ein, auf AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
4. Trag die Client ID in GOOGLE_CLIENT_ID und das Client Secret in GOOGLE_CLIENT_SECRET ein. In GOOGLE_MERCHANT_ACCOUNT_ID kommt die Merchant-Center-Kontonummer: die Zahl oben in Merchant Center neben dem Shopnamen oder nach a= in der Adresse (merchants.google.com/mc/overview?a=123456789). Bei einem erweiterten Konto (mehrere Kunden) nimmst du die ID des erweiterten Kontos, um dieses selbst zu verwalten, oder die ID eines Unterkontos für diesen Shop.
5. Klick auf der Connector-Seite auf Authorize with Provider und melde dich mit einem Google-Konto an, das Nutzer des Merchant-Center-Kontos ist: Admin für Einrichtung und Schreibzugriffe, Standard für Produkte und Feeds, Read only zum Lesen (Performance reporting deckt nur die Leistungsberichte ab).
6. Registriere das Cloud-Projekt einmalig: Rufe google_merchant_center_register_gcp_project auf, wahlweise mit developer_email. Dieses Google-Konto wird technischer Ansprechpartner und erhält die Rolle API-Entwickler; ist es noch kein Nutzer des Kontos, bekommt es eine Einladung, die innerhalb von 14 Tagen angenommen werden muss. Bis zur Registrierung antwortet jeder andere Aufruf mit 401 GCP project with id ... is not registered with the merchant account. Dafür brauchst du einen Admin, und die Registrierung erfolgt auf dem Hauptkonto (erweitert oder eigenständig), nicht auf jedem Unterkonto. google_merchant_center_get_developer_registration zeigt die registrierten Projektnummern.
7. Rufe google_merchant_center_get_account auf, um die Verbindung zu prüfen.

Dasselbe Cloud-Projekt und derselbe OAuth-Client können alle Google-Connectoren bedienen (Gmail, Google Calendar, Google Drive, Google Sheets, Search Console, Analytics, Ads, Merchant Center): Aktiviere jede API in diesem Projekt, verwende GOOGLE_CLIENT_ID und GOOGLE_CLIENT_SECRET wieder und autorisiere jeden Connector einmal.

Scope und Konto: Der Connector fordert https://www.googleapis.com/auth/content an, den einzigen Scope der Merchant API (Lesen und Schreiben). Was die KI tun kann, begrenzt der Merchant-Center-Zugriff des angemeldeten Nutzers; für einen reinen Lese-Agent meldest du dich mit einem Read only-Nutzer an und schaltest alle Insert-, Update-, Create-, Fetch- und Register-Tools aus. Ein Connector arbeitet mit genau dem Konto in GOOGLE_MERCHANT_ACCOUNT_ID. google_merchant_center_list_accounts listet alle Konten, die der Nutzer öffnen kann, google_merchant_center_list_subaccounts die Unterkonten eines erweiterten Kontos. Für ein anderes Konto installierst du den Connector ein weiteres Mal mit dessen ID.

Was er liest: das Konto mit Zeitzone und Sprache, die Unternehmensdaten (Adresse, Telefon, Kundenservice), die Startseite und ob sie bestätigt und beansprucht ist, Kontoprobleme mit ihrem Schweregrad, Programme (kostenlose Einträge, Shopping-Anzeigen, lokale Einträge, Checkout) mit ihrer Berechtigung, Versandeinstellungen, Regionen, Nutzer mit ihren Zugriffsrechten und die API-Kontingente. Die verarbeiteten Produkte, zusammengeführt aus allen Datenquellen, mit ihren Attributen und productStatus je Ziel und Land samt Problemen auf Artikelebene; Statuszahlen je Berichtskontext und Land mit den häufigsten Problemen. Datenquellen (Feeds) und das Ergebnis des letzten Datei-Uploads. Lokales und regionales Inventar je Produkt, Angebote (Promotions) mit ihrem Freigabestatus und Benachrichtigungsabos. Berichte in der Merchant Center Query Language: Produktleistung (Klicks, Impressionen, CTR, Conversions), Status und Probleme je Produkt, Preiswettbewerbsfähigkeit und Preisempfehlungen (suggested_price), Bestseller und Sichtbarkeit im Wettbewerb.

Was er schreibt: Produkteingaben in einer API-Datenquelle (google_merchant_center_insert_product_input legt eine an oder ersetzt sie komplett, google_merchant_center_update_product_input ändert die in update_mask genannten Felder, zum Beispiel product_attributes.price,product_attributes.availability), Datenquellen (anlegen, ändern, einen Datei-Feed sofort abrufen), lokales und regionales Inventar je Geschäft oder Region (ein Insert ersetzt diesen Eintrag), Angebote in einer Promotion-Datenquelle sowie Benachrichtigungsabos, die bei PRODUCT_STATUS_CHANGE oder ACCOUNT_SERVICE_CHANGE an einen HTTPS-Callback senden. Produkte aus Datei-Feeds oder aus der Merchant-Center-Oberfläche lassen sich hier nicht bearbeiten; überschreibe ihre Attribute stattdessen mit einer ergänzenden API-Datenquelle. Änderungen erscheinen nach einigen Minuten in google_merchant_center_get_product, die Freigabe für Anzeigen und kostenlose Einträge kann einige Tage dauern, und Google prüft jedes Angebot (das Promotions-Programm muss für das Land aktiv sein).

Bei der Installation deaktiviert: google_merchant_center_delete_product_input, google_merchant_center_delete_local_inventory, google_merchant_center_delete_regional_inventory und google_merchant_center_delete_notification_subscription. Sie lassen sich nicht rückgängig machen (ein gelöschtes Produkt verliert seinen Verlauf und Status), deshalb schaltet ein Admin sie ein, wenn das Team sie braucht.

Datenformate: Eine Produkt-ID ist contentLanguage~feedLabel~offerId, zum Beispiel en~US~sku123; Offer-IDs mit /, % oder ~ werden als base64url-Kodierung der ganzen ID ohne Padding übergeben. Ressourcennamen sind Pfade wie accounts/123/dataSources/456, und die Tools nehmen den letzten Teil als ID. Geldbeträge sind in Micros: {"amountMicros": "19990000", "currencyCode": "EUR"} sind 19,99 EUR. Große Zahlen (Micros, Mengen, IDs) kommen als JSON-Strings. Zeiten sind RFC 3339 in UTC; date-Werte in Berichten sind in der Zeitzone des Kontos. Attributnamen sind camelCase (title, link, imageLink, availability, condition, gtins, brand, mpn, googleProductCategory, salePrice, shipping).

Berichte: google_merchant_center_search_reports nimmt SELECT fields FROM table WHERE ... ORDER BY ... LIMIT n mit Feldnamen in snake_case. Bedingungen werden nur mit AND verknüpft (statt OR nimm IN), und ORDER BY geht nur auf ausgewählte Felder. product_performance_view und non_product_performance_view brauchen eine Datumsbedingung wie date DURING LAST_30_DAYS und mindestens eine Kennzahl. Die Bestseller-Tabellen brauchen report_granularity und report_country_code im Filter. Zeilen kommen als results[], jede mit einem Objekt, das nach der Tabelle heißt, etwa productPerformanceView.

Blättern und Limits: Listen-Tools liefern nextPageToken; die KI ruft mit page_token erneut auf, bis es fehlt. google_merchant_center_list_products liefert standardmäßig 25 Produkte pro Seite, höchstens 1000; Berichte bis zu 100000 Zeilen pro Seite (Standard 1000). google_merchant_center_list_quotas zeigt die Tages- und Minutenlimits und die heutige Nutzung je Methodengruppe. Produktschreibvorgänge sind pro Tag im Verhältnis zur Kataloggröße begrenzt: Verteile Massenänderungen und nimm lieber einen ergänzenden Feed als Tausende Einzeländerungen.

Häufige Fehler: 401 GCP project with id ... is not registered heißt, Schritt 6 fehlt; jedes andere 401 heißt, die Autorisierung ist abgelaufen oder wurde widerrufen (immer nach 7 Tagen, solange der Zustimmungsbildschirm auf Testing steht): Klick erneut auf Authorize with Provider. 403 The caller does not have access to the accounts heißt, der angemeldete Nutzer ist kein Nutzer dieses Kontos oder GOOGLE_MERCHANT_ACCOUNT_ID stimmt nicht; 403 Merchant API has not been used in project heißt, die API ist nicht aktiviert (Schritt 1). 400 bei einer Produkteingabe heißt, ein Pflichtattribut fehlt oder ist falsch geschrieben, oder die Datenquelle ist keine API-Quelle. 404 ist eine unbekannte Produkt-, Datenquellen- oder Angebots-ID. 429 RESOURCE_EXHAUSTED heißt, das Kontingent ist aufgebraucht: Prüfe google_merchant_center_list_quotas und versuch es später erneut.

Der Connector bearbeitet keine Bestellungen und Retouren, ändert keine Versand- oder Rückgaberichtlinien, legt keine Konten an, verwaltet keine Nutzer, liest keine Produktbewertungen und verwaltet keine Google-Ads-Kampagnen (dafür gibt es den Google-Ads-Connector).

Voraussetzungen: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_MERCHANT_ACCOUNT_ID

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Google Merchant Center und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Mach einen Gesundheitscheck des Shops: Kontoprobleme und wie viele Produkte je Land abgelehnt sind.“
• „Welche Produkte sind nicht berechtigt oder abgelehnt, und was muss ich bei jedem beheben?“
• „Zeig mir die 20 Produkte mit den meisten Klicks in den letzten 30 Tagen, mit Impressionen und CTR.“
• „Wo liegt mein Preis über dem Benchmark-Preis? Liste die Produkte mit dem größten Abstand.“
• „Setz das Produkt enUSsku123 auf OUT_OF_STOCK. Zeig mir die Änderung, bevor du sie sendest.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden