Come collegare Amazon Ads a Meta Muse 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 + Meta Muse

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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Amazon Ads.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

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

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

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