OTTO Sponsored Product Ads über MCP mit Gemini verbinden

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

OTTO Sponsored Product Ads + Gemini

OTTO Market Sponsored Product Ads: Kampagnen, beworbene SKUs (Targets), Keywords und Gebote sowie SPA-Reporting (KPIs je Kampagne und Produkt, CSV-Berichte) für Werbetreibende auf otto.de. OAuth 2.0 Client Credentials mit dem Werbe-Scope.

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:

OTTO_ADS_CLIENT_ID, OTTO_ADS_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein OTTO-Market-Partnerkonto, das Sponsored Product Ads bucht, und eine App in OTTO Partner Connect. Eine Anmeldung als Nutzer gibt es nicht: Der Connector arbeitet mit Client Credentials.

1. Leg in OTTO Partner Connect eine App für dein eigenes Konto an (oder öffne die, die du schon für die Partner-API nutzt) und aktiviere die Schnittstellen für Sponsored Product Ads.
2. Kopiere die client id und das client secret der App. Das Secret wird nur einmal angezeigt, wenn es erstellt wird; hast du es nicht mehr, erneuerst du es in OTTO Partner Connect.
3. Füge die Client ID in OTTO_ADS_CLIENT_ID und das Secret in OTTO_ADS_CLIENT_SECRET ein. AnythingMCP holt damit über den Client-Credentials-Ablauf von OTTO ein Token mit dem Scope advertising-services; es gilt 30 Minuten und wird danach selbst neu geholt.
4. Installiere den Connector und führe otto_ads_list_campaigns aus: Du siehst deine Kampagnen mit Status, Typ und Budget.

Getrennt vom OTTO-Market-Connector: Sponsored Product Ads hat einen eigenen OAuth-Scope. Bestellungen, Produkte, Bestand und Retouren bleiben im Connector OTTO Market, und weil die Werbung getrennt ist, funktioniert eine App ohne Werbe-Schnittstelle dort weiter.

Was er liest: Kampagnen mit Status, Typ (AUTOMATIC oder MANUAL), Budget, Budgettyp, Pacing und Laufzeit; die beworbenen SKUs (Targets) mit ihren Geboten; die Keywords jedes Targets mit Match-Typ, positiv oder negativ, und Gebot; KPIs je Kampagne und je SKU (Views, Klicks, Kosten, zugeordnete Umsätze, bestellte SKUs, Klickrate, Kosten pro Klick und ROAS); und CSV-Berichte je Kampagne, je Keyword (mit dem Suchbegriff, den die Kundschaft wirklich eingegeben hat) und je Produkt.

Beträge in Euro-Cent: Budgets, Gebote und Kosten kommen als {"amount": 160, "currency": "EUR"}, das sind 1,60 Euro. Gebot und Budget betragen mindestens 20 (0,20 Euro). Auch die Berichtsspalten TOTAL_COSTS und TOTAL_SALES sind Cent.

Gebote an zwei Stellen: AUTOMATIC-Kampagnen bieten pro Target (SKU), MANUAL-Kampagnen pro positivem Keyword. Negative Keywords (ohne Gebot) gibt es in beiden, und sie gehören zu einem Target: Soll ein Suchbegriff für die ganze Kampagne ausgeschlossen werden, setzt die KI ihn an jedes Target.

Reporting: KPIs decken höchstens die letzten 90 Tage ab und nie den heutigen Tag; ohne Zeitraum nimmt OTTO die letzten 7 Tage. OTTO ordnet Umsätze bis zu 14 Tage nach dem Klick zu, auch für andere Artikel derselben Marke, deshalb ändern sich die letzten Tage noch. Für einen CSV-Bericht fordert die KI ihn an, prüft mit otto_ads_get_report_status, bis er READY ist, und lädt ihn mit otto_ads_download_report. Eine Datei bleibt 24 Stunden liegen. Einen Bericht anzufordern ändert keine Kampagne.

Fragt vor jeder Änderung: otto_ads_create_campaign, otto_ads_update_campaign, otto_ads_add_targets, otto_ads_update_target_bids, otto_ads_add_keywords und otto_ads_update_keywords ändern deine laufende Werbung und geben Geld aus. Die KI zeigt dir Kampagne, Target oder Keyword und den Betrag in Euro, bestätigt ihn mit dir und wartet auf dein Ja. Schreibzugriffe laufen asynchron: OTTO antwortet mit einer Änderungsanfrage, und die KI verfolgt sie mit otto_ads_get_change_request, bis sie ACCEPTED oder REJECTED ist (mit Grund).

Bei der Installation deaktiviert: otto_ads_delete_keywords. Es löscht 1 bis 50 Keywords eines Targets und lässt sich nicht rückgängig machen; ein niedrigeres Gebot ist oft die bessere Wahl. Ein Administrator kann es bewusst einschalten.

Limits: OTTO erlaubt höchstens 200 Berichte in 24 Stunden über alle Berichtsarten, auch wenn ein Bericht nichts ändert. Pro Kampagne darf immer nur eine Änderungsanfrage offen sein. Listen kommen seitenweise mit bis zu 1000 Einträgen, die KI blättert mit nextCursor. Beim Prüfen einer Änderungsanfrage wartet sie jedes Mal etwas länger (1, 2, 4 Sekunden), um 429 zu vermeiden.

Häufige Fehler: Wird das Token verweigert, sind Client ID oder Secret falsch oder der App fehlt die Schnittstelle für Sponsored Product Ads: Prüf die App in OTTO Partner Connect. 409 heißt, dass für dieselbe Kampagne noch eine Änderung offen ist. Eine Ablehnung wie „Invalid status transition PAUSED to PAUSED“ heißt, dass die Kampagne diesen Status schon hat. 404 „Data not found“ bei KPIs heißt, dass die Kampagne im Zeitraum keine Impressionen hatte; beim Download heißt 404, dass der Bericht noch nicht fertig ist, und 410, dass er abgelaufen ist.

Der Connector liest keine Bestellungen, Produkte, Bestände oder Retouren (dafür gibt es den Connector OTTO Market), zeigt keine Zahlen von heute oder älter als 90 Tage und löscht keine Kampagnen oder Targets.

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 OTTO Sponsored Product Ads-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche meiner OTTO-Kampagnen hatte in den letzten 30 Tagen den besten ROAS, und was hat jede davon in Euro gekostet?“
• „Pausier die Kampagne Gartenmöbel Sommer. Prüf vorher den aktuellen Status und sag mir, wenn OTTO die Änderung angenommen hat.“
• „Erhöh das Gebot für SKU BW-4711 in meiner automatischen Kampagne Bettwäsche auf 0,80 Euro. Zeig mir altes und neues Gebot, bevor du es änderst.“
• „Fordere einen Keyword-Bericht für die letzten 30 Tage an und liste die Suchbegriffe, die Geld gekostet, aber nichts verkauft haben, als Kandidaten für negative Keywords.“
• „Leg eine automatische Kampagne Winterjacken mit 25 Euro Tagesbudget an, gleichmäßig verteilt, Start nächsten Montag, und füg die SKUs JK-100 und JK-200 mit je 0,50 Euro Gebot hinzu.“

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