Amazon Ads MCP mit Microsoft Copilot verbinden

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

Amazon Ads + Microsoft Copilot

Lies Amazon Ads (Sponsored Products) aus: Werbeprofile, Kampagnen, Anzeigengruppen, Produktanzeigen, Keywords, auszuschließende Keywords und Targets, und fordere Performance-Berichte über Reporting v3 für Sponsored Products, Brands und Display an. Für Seller, Vendoren und Agenturen in den Regionen NA, EU und FE.

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:

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

Schritt 1 — Zugangsdaten holen

1. Stelle sicher, dass du Zugang zur Amazon Ads API hast: eine freigegebene API-Anwendung und ein damit verknüpftes Login with Amazon (LWA) Security Profile. Den API-Zugang beantragst du bei Amazon Ads (Partner Network oder https://advertising.amazon.com/API). Ohne API-Freigabe klappt zwar die Anmeldung, aber Amazon lehnt jeden Aufruf ab.

2. Öffne in der LWA-Konsole (https://developer.amazon.com, Login with Amazon) das Security Profile, dann Web Settings, und füge unter Allowed Return URLs https://cloud.anythingmcp.com/api/mcp-oauth/callback hinzu (wenn du AnythingMCP selbst hostest: <your AnythingMCP URL>/api/mcp-oauth/callback).

3. Kopiere Client ID und Client Secret (Show Secret) von derselben Seite in AMAZON_ADS_CLIENT_ID und AMAZON_ADS_CLIENT_SECRET. Die Client ID beginnt mit amzn1.application-oa2-client..

4. Setze AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL und AMAZON_ADS_TOKEN_URL für deine Region, in dieser Reihenfolge:

   • Nordamerika (US, CA, MX, BR): https://advertising-api.amazon.com, https://www.amazon.com/ap/oa, https://api.amazon.com/auth/o2/token
   • Europa (UK, DE, FR, IT, ES, NL, SE, PL, TR, AE, SA, EG, IN): https://advertising-api-eu.amazon.com, https://eu.account.amazon.com/ap/oa, https://api.amazon.co.uk/auth/o2/token
   • Fernost (JP, AU, SG): https://advertising-api-fe.amazon.com, https://apac.account.amazon.com/ap/oa, https://api.amazon.co.jp/auth/o2/token

   Ein Connector sieht nur die Profile seiner Region. Wenn du in mehreren Regionen wirbst, installiere ihn also einmal pro Region.

5. Lass AMAZON_ADS_REFRESH_TOKEN leer, außer du hast dieses Security Profile schon anderswo für die Amazon Ads API autorisiert (dieses Token beginnt mit Atzr|). Installiere den Connector, klicke auf Authorize with Provider und melde dich mit dem Amazon-Konto an, das Zugriff auf die Werbekonten hat. Der Scope ist advertising::campaign_management.

6. Führe amazon_ads_list_profiles aus. Ein Profil ist ein Werbetreibender in einem Marketplace, und seine ID geht in jedes andere Tool. Eine leere Liste heißt, dass das Konto in dieser Region kein Werbekonto hat oder nie eine Kampagne angelegt hat.

Nur lesend: Die KI listet Sponsored-Products-Kampagnen, Anzeigengruppen, Produktanzeigen (die beworbenen ASINs oder SKUs), Keywords mit Geboten und Match Types, auszuschließende Keywords sowie Produkt-, Kategorie- und Auto-Targets.

Performance kommt aus Berichten: Impressionen, Klicks, Kosten, Umsatz, ACOS und ROAS gibt es nur als Bericht. amazon_ads_create_report startet bei Amazon einen Berichtsauftrag (er ändert keine Kampagne), amazon_ads_get_report prüft dessen Status. Berichte sind meist in wenigen Minuten fertig, können zu Spitzenzeiten aber bis zu einer Stunde dauern. Die meisten Berichtstypen reichen 95 Tage zurück, ein DAILY-Bericht umfasst höchstens 31 Tage. Sponsored-Brands- und Sponsored-Display-Kampagnen werden nicht aufgelistet, ihre Performance gibt es aber über Berichte.

Die Berichtsdatei: Ein fertiger Bericht ist ein Download-Link zu einer gzip-komprimierten JSON-Datei, gültig für etwa eine Stunde. Der Connector kann diese Datei nicht entpacken. Die KI gibt dir deshalb den Link, damit du sie selbst herunterlädst und öffnest oder an ein Tool weitergibst, das sie entpacken kann. Kosten stehen in der Währung des Profils.

Limits und Fehler: Amazon drosselt pro Konto und Endpunkt und antwortet mit 429 und einer Wartezeit bis zum nächsten Versuch. Access-Tokens gelten eine Stunde und werden automatisch erneuert. 401: erneut autorisieren und prüfen, ob Client ID, Anmelde-URL und Token-URL zur selben Region wie der API-Endpunkt gehören. 403: Das Amazon-Konto hat keinen Zugriff auf dieses Profil, oder das Security Profile ist nicht für die Amazon Ads API freigegeben. 425: Derselbe Bericht wurde schon angefordert, und die Antwort enthält seine ID.

Der Connector legt keine Kampagnen, Gebote oder Budgets an und ändert sie nicht, und er listet keine Sponsored-Brands- oder Sponsored-Display-Kampagnen auf.

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 Amazon 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

• „Liste unsere Werbeprofile mit Marketplace und Währung auf.“
• „Fordere einen Sponsored-Products-Bericht nach Kampagne für die letzten 30 Tage an und gib mir den Download-Link, sobald er fertig ist.“
• „Welche Keywords in unseren manuellen Kampagnen nutzen Broad Match, und wie hoch sind ihre Gebote?“
• „Zeig mir die auszuschließenden Keywords unserer größten Kampagne, damit ich Lücken finde, bevor wir neue hinzufügen.“

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