Meta Catalog über MCP mit Gemini verbinden

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

Meta Catalog + Gemini

Lass deine KI deine Meta-Produktkataloge (Commerce Manager) prüfen und pflegen: Produkte mit Preisen, Bestand und Prüfstatus, Produktsets, Daten-Feeds und Upload-Fehler sowie die Katalog-Diagnose. Nach deiner Bestätigung kann sie Produkte auch in großen Mengen ändern, hinzufügen oder löschen (bei der Installation deaktiviert).

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

META_CATALOG_ACCESS_TOKEN, META_CATALOG_BUSINESS_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 10 Minuten. Du brauchst ein Meta-Business-Portfolio mit einem Produktkatalog im Commerce Manager und eine Meta-App.

1. Öffne developers.facebook.com/apps/creation und erstelle eine Business-App, die mit deinem Business-Portfolio verbunden ist. Nutzt du schon den Meta-Ads-Connector, kannst du dessen App wiederverwenden.
2. Empfohlen, ein Token, das nicht abläuft: Öffne in den Business Settings den Bereich Users → System users und füge einen Systemnutzer hinzu. Gib ihm unter Assign assets → Catalogs deinen Katalog (Manage catalog, oder View catalog, wenn die KI nur lesen soll). Klicke auf Generate token, wähle die App, setze das Ablaufdatum auf Never und hake catalog_management und business_management an. Meta kann vorher eine Verifizierung des Business-Portfolios verlangen.
3. Füge das Token in META_CATALOG_ACCESS_TOKEN ein. Es beginnt mit EA; füge es ohne das Wort Bearer ein.
4. Trag die ID des Business-Portfolios in META_CATALOG_BUSINESS_ID ein: nur Ziffern, aus Business Settings → Business info oder aus business_id= in der Adresszeile von business.facebook.com. Mit einem Systemnutzer-Token liefert meta_catalog_list_businesses eine leere Liste, nimm die ID also aus den Business Settings.
5. Installiere den Connector und rufe meta_catalog_check_permissions auf: Beide Berechtigungen sollten als granted erscheinen. Danach listet meta_catalog_list_catalogs deine Kataloge mit ihrer Produktanzahl.

Stattdessen mit einem Nutzer-Token: Ein Nutzer-Token aus dem Graph API Explorer (deine App, User Token, dieselben zwei Berechtigungen) gilt nur ein bis zwei Stunden. Trag zusätzlich die optionalen Werte META_APP_ID und META_APP_SECRET ein (in deiner App unter App settings → Basic): Dann tauscht AnythingMCP das Token beim ersten Aufruf gegen ein langlebiges mit etwa 60 Tagen und erneuert es, sobald weniger als 10 Tage übrig sind, wie beim Meta-Ads-Connector. Ohne diese Werte verlängerst du das Token selbst im Access Token Debugger (Extend Access Token) und ersetzt es, bevor die 60 Tage um sind; die Connector-Seite warnt dich rechtzeitig. Mit einem Systemnutzer-Token lässt du beide leer.

Was sie liest: die Kataloge, die deinem Unternehmen gehören, und die, die Kunden mit ihm geteilt haben (so, wie eine Agentur oder ein Partner sie sieht, mit deinen Rollen darauf); Produkte mit SKU (retailer_id), Name, Preis und Angebotspreis, Verfügbarkeit, Bestand, Prüfstatus (approved, pending, rejected, outdated), Sichtbarkeit, Fehlern und Ablehnungsgründen; Produktsets mit ihrer Filterregel und ihren Produkten; Daten-Feeds mit Zeitplan, Upload-Vorgängen (erkannte, gespeicherte, ungültige und gelöschte Artikel) und Upload-Fehlern mit Zeilennummer und SKU; und die Diagnose, die der Commerce Manager anzeigt, markiert als MUST_FIX oder OPPORTUNITY.

Herausfinden, warum Produkte nicht erscheinen: Die KI beginnt mit meta_catalog_get_diagnostics, listet dann die Produkte mit Fehlern oder mit einem bestimmten Prüfstatus und liest mit meta_catalog_get_product die genauen Fehler und Ablehnungsgründe eines Produkts. Bei Feed-Problemen geht sie von meta_catalog_list_feeds über meta_catalog_list_feed_uploads zu meta_catalog_list_upload_errors.

Zwei IDs pro Produkt: Meta gibt jedem Produkt eine eigene ID, deine SKU ist die retailer_id (die id-Spalte eines Feeds). Die KI nutzt die Meta-ID für einzelne Produkte und die SKU für Massenänderungen und Filter. Preise kommen als Text mit Währung zurück, zum Beispiel 19.99 EUR.

Änderungen landen in Anzeigen und Shops: Kataloge speisen Advantage+-Katalog-Anzeigen, Facebook- und Instagram-Shops und Produktmarkierungen, eine Änderung im Katalog ist also dort zu sehen. Ein Produkt, das ein geplanter Feed liefert, wird beim nächsten Feed-Upload wieder überschrieben: Für eine dauerhafte Änderung korrigierst du die Feed-Quelle oder nutzt einen ergänzenden Feed.

Bei der Installation deaktiviert: meta_catalog_batch_update_items, meta_catalog_create_product, meta_catalog_update_product und meta_catalog_delete_product. Sie ändern, was Kunden in Anzeigen und Shops sehen, und ein gelöschtes Produkt lässt sich nicht wiederherstellen, nur neu anlegen. Ein Administrator kann sie einzeln einschalten, wenn die KI den Katalog bearbeiten soll.

Fragt vor jeder Änderung: Sind sie eingeschaltet, nennt die KI den Katalog, die Produkte (Name und SKU) und die alten und neuen Werte und wartet auf dein Ja. Ein Batch nimmt bis zu 5.000 Änderungen auf (empfohlen sind weniger als 3.000) und wird im Hintergrund verarbeitet: Die KI verfolgt ihn mit meta_catalog_check_batch_status, bis er fertig ist, und meldet dir die Fehler.

Limits: Meta begrenzt die API-Aufrufe. Die Fehlercodes 4, 17, 613, 80009 und 80014 (das Batch-Limit) heißen: ein paar Minuten warten und dann erneut versuchen.

Häufige Fehler: Code 190 heißt, dass das Token ungültig oder abgelaufen ist; erstelle ein neues. Mit Subcode 467, 460 oder 458 (abgemeldet, Passwort geändert, App entfernt) ist die Sitzung endgültig vorbei, und der Connector schickt das Token nicht mehr, bis du ein neues speicherst. Die Codes 10 und 200 bis 299 heißen, dass eine Berechtigung fehlt oder der Systemnutzer keinen Zugriff auf diesen Katalog hat: Weise den Katalog zu und erzeuge das Token neu. Code 100 heißt, dass ein Parameter, Feld oder Filter falsch ist.

Der Connector legt keine Kataloge, Feeds oder Produktsets an und löscht keine, ändert keine Feed-Zeitpläne, lädt keine Feed-Dateien hoch, verwaltet keine lokalisierten Kataloge, Pixel oder Event-Quellen, schaltet keine Katalog-Anzeigen (das macht der Meta-Ads-Connector) und markiert keine Produkte in Instagram-Beiträgen.

Schritt 2 — Adapter 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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Meta Catalog-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Warum werden Produkte in unserem Hauptkatalog abgelehnt oder nicht angezeigt? Nenn mir die MUST_FIX-Probleme und wie viele Artikel jeweils betroffen sind.“
• „Hat der letzte Upload unseres Produkt-Feeds geklappt? Zeig mir die Fehler mit Zeilennummer und SKU.“
• „Welche Produkte im Produktset Sommer-Sale sind gerade nicht vorrätig?“
• „Setz die SKU TSHIRT-ROT-M auf 24,90 EUR und auf vorrätig. Zeig mir alte und neue Werte, bevor du etwas änderst.“
• „Liste die Kataloge auf, die unsere Kunden mit uns geteilt haben, und wie viele Produkte jeder hat.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden