Amazon Ads über MCP mit Gemini 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 + Gemini

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 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 Amazon Ads-Tools aufrufen.

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

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