OTTO MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 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 OTTO Sponsored Product 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 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

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
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden