Come collegare Amazon Ads a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Amazon Ads, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Amazon Ads + Cursor

Leggi gli account Amazon Ads (Sponsored Products): profili pubblicitari, campagne, gruppi di annunci, annunci prodotto, parole chiave, parole chiave negative e target, e richiedi report di performance Reporting v3 per Sponsored Products, Brands e Display. Per venditori, vendor e agenzie, nelle regioni NA, EU e FE.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

AMAZON_ADS_CLIENT_ID, AMAZON_ADS_CLIENT_SECRET, AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL, AMAZON_ADS_TOKEN_URL

Step 1 — Ottieni le credenziali

1. Verifica di avere accesso all'Amazon Ads API: un'applicazione API approvata e un security profile Login with Amazon (LWA) collegato. L'accesso all'API si richiede ad Amazon Ads (Partner Network, oppure https://advertising.amazon.com/API). Senza approvazione dell'API l'accesso funziona, ma Amazon rifiuta ogni chiamata.

2. Nella console LWA (https://developer.amazon.com, Login with Amazon) apri il security profile, poi Web Settings, e aggiungi https://cloud.anythingmcp.com/api/mcp-oauth/callback (se ospiti AnythingMCP in proprio: <your AnythingMCP URL>/api/mcp-oauth/callback) in Allowed Return URLs.

3. Copia Client ID e Client Secret (Show Secret) dalla stessa pagina in AMAZON_ADS_CLIENT_ID e AMAZON_ADS_CLIENT_SECRET. Il client ID inizia con amzn1.application-oa2-client..

4. Imposta AMAZON_ADS_API_URL, AMAZON_ADS_AUTHORIZATION_URL e AMAZON_ADS_TOKEN_URL per la tua regione, in quest'ordine:

   • Nord America (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
   • Estremo Oriente (JP, AU, SG): https://advertising-api-fe.amazon.com, https://apac.account.amazon.com/ap/oa, https://api.amazon.co.jp/auth/o2/token

   Un connettore vede solo i profili della sua regione, quindi se fai pubblicità in più regioni installalo una volta per regione.

5. Lascia vuoto AMAZON_ADS_REFRESH_TOKEN, a meno che tu non abbia già autorizzato altrove questo security profile per l'Amazon Ads API (quel token inizia con Atzr|). Installa il connettore, fai clic su Authorize with Provider e accedi con l'account Amazon che ha accesso agli account pubblicitari. Lo scope è advertising::campaign_management.

6. Esegui amazon_ads_list_profiles. Un profilo è un inserzionista in un marketplace, e il suo ID va passato a ogni altro tool. Una lista vuota vuol dire che l'account non ha un account pubblicitario in questa regione o non ha mai creato una campagna.

Sola lettura: l'AI elenca campagne Sponsored Products, gruppi di annunci, annunci prodotto (gli ASIN o SKU pubblicizzati), parole chiave con offerte e tipi di corrispondenza, parole chiave negative e target per prodotto, categoria e automatici.

Le performance arrivano dai report: impressioni, clic, costo, vendite, ACOS e ROAS sono disponibili solo come report. amazon_ads_create_report avvia un job di report lato Amazon (non modifica nessuna campagna) e amazon_ads_get_report ne controlla lo stato. Di solito i report sono pronti in pochi minuti, ma nei momenti di punta possono richiedere fino a un'ora. La maggior parte dei tipi di report guarda indietro 95 giorni, e un report DAILY copre al massimo 31 giorni. Le campagne Sponsored Brands e Sponsored Display non vengono elencate, ma le loro performance sono disponibili tramite i report.

Il file del report: un report pronto è un link di download a un file JSON compresso con gzip, valido per circa un'ora. Il connettore non può decomprimere quel file, quindi l'AI ti passa il link per scaricarlo e aprirlo tu, o per darlo a uno strumento che sappia decomprimerlo. I costi sono nella valuta del profilo.

Limiti ed errori: Amazon limita le richieste per account e per endpoint e risponde 429 con il tempo da attendere prima di riprovare. I token di accesso durano un'ora e si rinnovano in automatico. 401: autorizza di nuovo e controlla che client ID, URL di accesso e URL del token appartengano alla stessa regione dell'endpoint API. 403: l'account Amazon non ha accesso a quel profilo, oppure il security profile non è approvato per l'Amazon Ads API. 425: lo stesso report è già stato richiesto, e la risposta riporta il suo ID.

Il connettore non crea né modifica campagne, offerte o budget, e non elenca le campagne Sponsored Brands o Sponsored Display.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Amazon Ads.

Tool disponibili

Esempi di prompt

• "Elenca i nostri profili pubblicitari con marketplace e valuta."
• "Richiedi un report Sponsored Products per campagna sugli ultimi 30 giorni e dammi il link di download quando è pronto."
• "Quali parole chiave delle nostre campagne manuali usano la corrispondenza generica, e con quali offerte?"
• "Mostrami le parole chiave negative della nostra campagna più grande, così controllo cosa manca prima di aggiungerne di nuove."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT