Ozon Performance MCP mit Gemini CLI verbinden

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

Ozon Performance (Ads) + Gemini

Ozon Performance API für das Werbekonto des Verkäufers: Pay-per-Click-, Pay-per-Order- und Bannerkampagnen, ihre Produkte und Gebote, Wettbewerbsgebote und Gebotsgrenzen, Tages- und Ausgabenstatistiken und die detaillierten Kampagnenberichte. Kampagnen stoppen und Gebote ändern. Eine Client ID und ein Client Secret eines Servicekontos.

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:

OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst ein Ozon-Verkäuferkonto mit seinem Werbekonto (Ozon Performance), in dem du ein Servicekonto und einen Key dafür anlegst.

1. Öffne im Ozon-Seller-Portal Settings → API keys → Performance API (seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi).
2. Gibt es noch kein Servicekonto, leg eins mit Create new account an. Klicke auf den Namen des Servicekontos und dann auf Add new key.
3. Kopiere die Client ID in OZON_PERFORMANCE_CLIENT_ID: Sie endet auf @advertising.performance.ozon.ru, füge sie also vollständig ein. Kopiere das Client Secret, das beim Hinzufügen des Keys zusammen mit der Client ID angezeigt wird, in OZON_PERFORMANCE_CLIENT_SECRET. Ist das Secret verloren, füge einen neuen Key hinzu.
4. Installiere den Connector und prüfe die Verbindung mit ozon_performance_list_campaigns (ohne Argumente): Es listet deine Kampagnen mit den IDs, die alle anderen Tools brauchen.

Getrennt vom Ozon-Seller-Connector: Dieser Connector deckt nur das Werbekonto ab und hat eigene Zugangsdaten, der Seller-API-Key wird hier also nicht verwendet. Für Bestellungen, Produkte, Bestand und Preise nutze den Ozon-Seller-Connector.

Cloud und Self-Hosting funktionieren gleich: Du trägst dieselben zwei Werte ein, und es gibt keine Redirect URL einzurichten.

Tokens erneuern sich selbst: Der Connector tauscht Client ID und Secret bei POST /api/client/token (Grant Type client_credentials) gegen ein Bearer-Token, das 30 Minuten gilt, und holt ein neues, bevor es abläuft oder nach einem 401. Ein 401 beim Token-Abruf heißt, dass Client ID oder Secret falsch sind oder der Key gelöscht wurde: Kopiere beide noch einmal oder füge dem Servicekonto einen neuen Key hinzu. Ein 403 heißt, dass das Servicekonto keinen Zugriff auf diese Methode oder Kampagne hat.

Kampagnentypen: SKU ist Pay-per-Click (Оплата за клик), SEARCH_PROMO ist Pay-per-Order (Оплата за заказ), dazu gibt es BANNER und VIDEO_BANNER. Die Produkte einer Klick-Kampagne und ihre Gebote liefert ozon_performance_list_campaign_products, die Produkte in der Pay-per-Order-Werbung ozon_performance_list_cpo_products.

Schnelle Statistiken: ozon_performance_get_daily_statistics, ozon_performance_get_expense_statistics und ozon_performance_get_cpc_campaign_statistics antworten sofort mit JSON-Zeilen. Ohne Datum decken sie die letzten 7 Tage ab. Daten sind Tage (2026-10-01), die Ozon nach Moskauer Zeit gruppiert. ozon_performance_get_cpc_campaign_statistics zählt nicht gegen die Berichtslimits.

Detaillierte Berichte laufen asynchron: ozon_performance_request_campaign_report bestellt einen Bericht pro Produkt für bis zu 10 Kampagnen über höchstens 62 Tage, gruppiert nach Tag, Woche oder Monat, und gibt eine UUID zurück. Die KI fragt ozon_performance_get_report_status alle paar Sekunden ab, bis state auf OK (oder ERROR) steht, und holt den Bericht dann mit ozon_performance_download_report: CSV-Text (mit Semikolon getrennt, russische Spaltennamen) für eine Kampagne, eine ZIP-Datei mit einer CSV pro Kampagne für mehrere. Pro Konto läuft immer nur ein Bericht gleichzeitig, und höchstens 2000 am Tag; ozon_performance_list_api_reports findet früher bestellte Berichte. ozon_performance_request_search_phrases_report funktioniert genauso für die Suchphrasen der Top-Platzierung, eine Methode, die Ozon als Testphase kennzeichnet.

Geld und IDs: Kampagnenbudgets sind in Millionstel Rubel angegeben (1000000 = 1 Rubel); die Gebotsgrenzen aus ozon_performance_get_bid_limits sind in Rubel; Pay-per-Order-Gebote sind ein Prozentsatz des Produktpreises. IDs sind Strings aus Ziffern.

Gebote ändern: ozon_performance_update_campaign_bids ändert die Gebote von Produkten, die schon in einer Klick-Kampagne sind, und Ozon ersetzt die Stoppwörter und Phrasengebote der Kampagne durch das, was gesendet wird. ozon_performance_add_campaign_products fügt höchstens 500 Produkte pro Kampagne hinzu; in einer Kampagne mit automatischer Strategie nur Produkte ihrer Autopilot-Kategorie. Ein Gebot pro Klick gilt nur bei der Strategie mit durchschnittlichen Klickkosten und wird in derselben Einheit angegeben wie die aktuellen Gebote, die der Connector liest; ohne Gebot setzt Ozon das Wettbewerbsgebot.

Ratenlimits: höchstens 100.000 Anfragen am Tag pro Konto, dazu Limits für Kampagnenänderungen (zum Beispiel 500 Budget- oder Strategieänderungen pro Kampagne am Tag) und für Berichte. Bei einem 429 warte und versuch es später erneut.

Was der Connector liest: deine Kampagnen mit Typ, Status, Zahlungsart, Platzierung, Strategie, Laufzeit und Budgets; die SKUs oder Banner, die eine Kampagne bewirbt; die Produkte einer Klick-Kampagne mit Gebot pro Klick, Ziel-Werbekostenanteil oder Positionsbereich in der Suche; die Gebote anderer Verkäufer für dieselben SKUs sowie die Mindest- und Höchstgebote pro Werbeinstrument, Platzierung und Kategorie; die Produkte in der Pay-per-Order-Werbung mit Preis, Gebot, Sichtbarkeitsindex und Aufrufen; Aufrufe, Klicks, Ausgaben, Bestellungen und Bestellwert pro Kampagne und Tag, die Ausgaben aufgeteilt auf Vorauszahlungskonto und Boni, die Summen der Klick-Kampagnen für einen Zeitraum sowie die detaillierten Berichte pro Produkt und zu Suchphrasen.

Bei der Installation deaktiviert: ozon_performance_activate_campaign und ozon_performance_remove_campaign_products. Das erste startet eine Kampagne, die dann Anzeigen ausspielt und ihr Budget ausgibt; das zweite entfernt Produkte aus einer Klick-Kampagne, wobei ihre Gebote verloren gehen. Schalte auf der Connector-Seite nur die ein, die du brauchst; die KI lässt sich jede Änderung vorher von dir bestätigen. ozon_performance_deactivate_campaign, ozon_performance_add_campaign_products und ozon_performance_update_campaign_bids sind eingeschaltet: Sie stoppen eine Kampagne, fügen einer Klick-Kampagne Produkte hinzu und ändern ihre Gebote und damit ihre Ausgaben, immer erst, nachdem die KI dir genau gezeigt hat, was sich ändert.

Nicht enthalten: Kampagnen anlegen und kopieren, Budgets und Strategien, Änderungen an Pay-per-Order-Geboten, Banner- und Videostatistiken, Berichte zur Bestellzuordnung und Analysen von externem Traffic.

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 Ozon Performance (Ads)-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche meiner Ozon-Werbekampagnen laufen gerade, und wie hoch sind ihre Tagesbudgets?“
• „Wie viel hat jede Kampagne letzte Woche pro Tag ausgegeben, und wie viel davon wurde mit Boni bezahlt?“
• „Vergleich die aktuellen Gebote in meiner Pay-per-Click-Kampagne mit den Wettbewerbsgeboten für dieselben SKUs.“
• „Bestell einen detaillierten Bericht pro Produkt für meine Klick-Kampagnen im Oktober, nach Wochen gruppiert, und fass ihn zusammen.“
• „Welche Produkte in der Pay-per-Order-Werbung haben das höchste Gebot in Prozent vom Preis, und wie viele Aufrufe hatten sie diese Woche?“

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