Ozon Performance MCP mit Microsoft Copilot 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) + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Ozon Performance (Ads)-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden