Collega il Tuo Account Amazon Seller alla Tua IA: Guida Completa MCP

> ✨ **Scrittura assistita dall'AI, revisione editoriale umana a cura di Avanta Global EOOD.** [Scopri di più](/disclosure)

![Connetti il tuo account venditore Amazon al tuo assistente AI personale](/blog/images/connect-amazon-seller-account-ai-assistant-mcp/hero.png)

La maggior parte dei "tool AI" per Amazon sono semplici chat integrate in una dashboard. Devi comunque accedere alla loro app, leggere i loro grafici e l'AI continua a fare supposizioni su numeri che non può vedere.

AgentXray funziona al contrario. Colleghi il tuo account venditore Amazon una sola volta e il **tuo** assistente AI personale — Claude, ChatGPT, Cursor, quello che già usi — ottiene un accesso diretto e autenticato ai tuoi dati Amazon misurabili. Fai domande con le tue parole, nella tua lingua, nell'app che hai già aperto. E quando l'assistente vuole modificare qualcosa nel tuo account, non può: può solo preparare una bozza che tu approverai.

Questa guida ti accompagna passo dopo passo: connettere l'account, collegare l'assistente, fare domande, agire in base alle risposte e valutare se l'azione ha dato risultati.

## Cos'è l'MCP, in trenta secondi

MCP (Model Context Protocol) è uno standard aperto per collegare un assistente AI a un sistema esterno — un set di strumenti che il modello può chiamare, con uno schema definito per ciascuno. È lo stesso meccanismo che permette a Claude di leggere un repository GitHub o una cartella Google Drive.

AgentXray gestisce un server MCP remoto all'indirizzo `https://agentxray.ai/api/mcp`. Espone **19 strumenti**: 13 che leggono i tuoi dati Amazon misurabili e 6 che preparano modifiche per la tua approvazione. Il tuo assistente li scopre automaticamente non appena viene stabilita la connessione.

Per un venditore, ciò che conta è ciò che questo sistema elimina:

- **Niente copia-incolla.** Non devi esportare report e incollarli in una finestra di chat, dove il modello fa calcoli su un foglio di calcolo obsoleto.
- **Niente seconda dashboard.** La risposta arriva dove già ti trovi — incluso l'app mobile di Claude, a voce alta.
- **Niente numeri inventati.** Ogni risultato indica la sua provenienza. Ne parleremo meglio dopo, perché è la parte che ha richiesto più lavoro.

## Passo 1 — Connetti il tuo account venditore Amazon

Questo è l'unico passaggio che richiede l'accesso a Seller Central e richiede circa un minuto.

1. Apri AgentXray → **Impostazioni → Connessione Amazon**.
2. **Scegli il tuo marketplace principale.** Il selettore è raggruppato per regione — Nord America, Europa, Estremo Oriente — perché la regione di autorizzazione dipende da dove risiede il tuo account, non da dove vendi di più.
3. Clicca **Connetti account Amazon**. Verrai reindirizzato a Amazon Seller Central per autorizzare AgentXray. Questa è la schermata OAuth di Amazon; le tue credenziali non vengono mai inserite in AgentXray.
4. Approva e tornerai alla pagina di connessione.

A questo punto l'account inizia a popolarsi. AgentXray recupera sei flussi di dati in background e ti mostra lo stato di ciascuno: **ordini, pagamenti, inventario, spedizioni in entrata, listing, stato dell'account**. I primi ordini di solito compaiono entro un minuto; lo storico dei pagamenti richiede più tempo perché è più corposo.

Due cose da sapere:

- Se un flusso segnala **"richiede il ruolo ... — riconnetti per concederlo"**, la tua autorizzazione manca di uno dei ruoli SP-API necessari. Riconnettersi e concederlo risolve il problema; nient'altro è compromesso.
- Puoi **disconnetterti in qualsiasi momento** dalla stessa pagina. La disconnessione interrompe la sincronizzazione; riautorizzandoti la riprendi.

## Passo 2 — Collega il tuo assistente AI

Ora arriva la parte interessante. Ci sono quattro modi per farlo, a seconda dell'assistente che usi. Tutti puntano allo stesso endpoint.

### Claude Code (terminal)

In AgentXray, vai a **Impostazioni → Assistente AI → Crea token**. Il pannello ti mostra un comando da una riga con il token già inserito — incollalo nel terminale:

```
claude mcp add --transport http agentxray https://agentxray.ai/api/mcp --header "Authorization: Bearer axr_..."
```

Il token viene mostrato **una sola volta**. Il server non lo restituirà mai più, quindi copialo mentre è visualizzato. Puoi revocarlo dallo stesso pannello quando vuoi e generarne uno nuovo.

### Claude Desktop e claude.ai

**Impostazioni → Connettori → "Aggiungi connettore personalizzato"** e inserisci `https://agentxray.ai/api/mcp`. Il browser apre una schermata di consenso di AgentXray; approva l'accesso in sola lettura e sei connesso. Nessun token da copiare, nessun terminale. (I connettori personalizzati richiedono un piano a pagamento di Claude.)

Un connettore aggiunto su claude.ai è disponibile anche nell'**app mobile di Claude** — quindi questo singolo passaggio configura anche la possibilità di fare domande sul tuo account Amazon a voce, mentre vai al lavoro.

### ChatGPT

Funziona anche con un account ChatGPT **gratuito**, verificato in tempo reale: **Impostazioni → App → Avanzate → attiva la Modalità sviluppatore**, poi **Impostazioni → Connettori → Crea** con `https://agentxray.ai/api/mcp` e OAuth. Appare la stessa schermata di consenso di AgentXray nel browser.

### Qualsiasi altro client MCP

Cursor e simili: endpoint HTTP streamabile `https://agentxray.ai/api/mcp`, con OAuth o un token bearer nell'intestazione `Authorization`.

### Vuoi provare prima di connettere qualcosa?

Sulla [pagina dei connettori](/connect) c'è un **token demo pubblico** che legge un venditore sintetico — tre prodotti, 90 giorni di storico, uno che sta perdendo soldi in silenzio, uno senza costi registrati, uno che invecchia in FBA. Nessun account, nessuna connessione Amazon, nessun rischio. È il modo più veloce per vedere come sono strutturate le risposte.

![Come funziona la connessione: da Amazon Seller Central ad AgentXray al tuo assistente AI](/blog/images/connect-amazon-seller-account-ai-assistant-mcp/connection-flow.png)

## Passo 3 — Cosa puoi chiedere ora

Una volta connesso, il tuo assistente può chiamare tredici strumenti di lettura. Non devi nominarli; fai semplicemente domande normali e il modello sceglie. Raggruppati per argomento:

**Soldi.** `get_profit_summary` — ricavi reali, fee Amazon, COGS, profitto netto e margine in un periodo, raggruppati per valuta. `get_profit_by_sku` — lo stesso, classificato per SKU, così "quale prodotto sta realmente guadagnando" ha una risposta invece di essere una sensazione. `get_my_product_costs` — quali costi unitari sono registrati, perché una SKU senza costi salvati viene conteggiata a costo zero e il suo profitto è sovrastimato.

**Ads.** `get_ads_overview`, `get_ads_campaigns`, `get_ads_targets`, `get_ads_search_terms` — spesa, vendite, clic, ordini, ACOS, ROAS, utilizzo budget, offerte attuali e quali termini di ricerca sono già negati.

**Operazioni.** `get_buybox_status` — tasso di vincita, quali SKU stanno perdendo il Buy Box in questo momento e di quanto. `get_inventory_age` — come il magazzino è distribuito tra fasce di età e cosa si avvicina alle fee di stoccaggio a lungo termine. `list_my_marketplaces` — così l'assistente non deve indovinare un ID marketplace.

**Giudizio.** `daily_brief` — un breve paragrafo, scritto per essere ascoltato più che letto. `did_my_changes_work` — il risultato misurabile delle modifiche che hai approvato. `what_i_cannot_tell_you` — i limiti onesti dei dati del tuo account, verificati in tempo reale.

Domande reali che i venditori fanno il primo giorno:

- "Com'è andata oggi?"
- "Quanto ho guadagnato negli ultimi 30 giorni — e cosa *non* è incluso in quel numero?"
- "Quale delle mie SKU sta perdendo soldi in questo momento?"
- "Dove sto perdendo il Buy Box e di quanto?"
- "C'è qualche stock FBA che si avvicina alle fee di stoccaggio a lungo termine?"
- "Quanto posso fidarmi di questi numeri?"

Se non sai cosa chiedere, non devi comporre nulla. Il server include **prompt pronti all'uso** che appaiono in Claude Code come comandi slash — `weekly_profit_audit`, `losing_money`, `ad_waste_scan`, `inventory_risk`, `buybox_check`, `did_it_work`, `daily_brief`. La prima domanda è una scelta da menu.

## La parte che rende le risposte utilizzabili: ogni numero indica la sua fonte

Ecco il punto debole di ogni prodotto AI più dashboard: il modello ottiene un numero, perde traccia della sua provenienza e produce una frase sicura di sé che è silenziosamente sbagliata.

Ogni risultato da questo server è avvolto in un **involucro di provenienza** con tre campi:

- **`basis`** — il percorso dati da cui proviene il numero. Per il profitto, è *eventi di fee Amazon registrati nel periodo, uniti ai tuoi ordini, più i tuoi costi prodotto salvati* — non l'endpoint di *stima* delle fee di Amazon, noto per sottostimare (esclude tasse come l'AU GST).
- **`gaps`** — cosa manca in questo momento, rispetto al tuo account.
- **`not_included`** — le cose che un venditore potrebbe ragionevolmente assumere siano incluse nel numero ma non lo sono.

Quest'ultimo è dove risiede l'onestà. Alcuni esempi che compaiono testualmente nei risultati degli strumenti:

- **Amazon registra gli eventi di fee circa 7,5-13 giorni dopo l'acquisto.** Una finestra di profitto che termina oggi sottostima le vendite delle ultime due settimane. Il profitto di oggi non esiste come numero misurabile e il daily brief lo dice esplicitamente invece di darti una cifra.
- **La spesa pubblicitaria viene fatturata separatamente dai pagamenti Amazon** e non è dedotta dagli strumenti di profitto. I report degli ads e i dati dei pagamenti sono registri diversi con tempistiche diverse; non si conciliano riga per riga.
- **L'offerta mostrata su un target è il massimo che hai impostato, non il prezzo che hai pagato per clic.**
- **Gli importi non vengono mai convertiti tra valute.** Ogni valuta viene riportata separatamente.

L'assistente è istruito a dichiarare la base, ripetere i gap testualmente e mai riempire un vuoto con una stima. Se un numero manca, la risposta dice che manca.

## Passo 4 — Quando l'assistente vuole cambiare qualcosa

La lettura è dove la maggior parte dei tool si ferma. Qui è dove AgentXray inizia a essere un'app operativa.

Il tuo assistente può preparare sei tipi di modifica: un **aggiornamento di listing** (titolo e bullet point), un **piano di spedizione FBA**, un **cambio di offerta**, **parole chiave negative**, un **budget di campagna** e l'**attivazione o pausa di una campagna**.

Nessuna di queste tocca Amazon direttamente. Ognuna crea una bozza nell'airlock di approvazione di AgentXray e l'assistente è istruito a dirtelo.

![L'airlock di approvazione: l'assistente prepara, solo una sessione browser approva](/blog/images/connect-amazon-seller-account-ai-assistant-mcp/approval-airlock.png)

### Due chiavi, e l'assistente ne ha solo una

La separazione è strutturale, non una politica che ci ricordiamo di seguire. **Un token connettore MCP può creare bozze e nient'altro.** L'approvazione avviene solo nel pannello AgentXray, con una sessione browser. Un token connettore perso può proporre tutto ciò che vuole ma non cambiare nulla.

Anche l'accesso in scrittura è opt-in per token: spunti una casella quando lo generi e la casella si resetta dopo, così il prossimo token non eredita silenziosamente la decisione. La schermata di consenso OAuth non offre mai la scrittura.

### Cosa porta con sé la bozza

Le bozze vengono controllate prima di arrivare a te e il controllo ha due livelli che significano cose diverse:

- **Blocco** — Amazon rifiuterà questo. Un'offerta fuori dai limiti consentiti, un budget a zero, un titolo oltre 75 caratteri. Una bozza bloccata non può mai essere approvata, perché approvarla potrebbe solo fallire.
- **Avviso** — i *tuoi stessi numeri* dicono che questo fa perdere soldi. Ancora approvabile. Potresti essere in fase di lancio, di liquidazione o di acquisizione di quota per motivi che il software non può vedere, e bloccarlo sarebbe noi che sovrascriviamo un business che non gestiamo.

L'economia dietro l'avviso è misurata, non modellata: le proposte di offerta sono valutate rispetto alle fee che Amazon ha effettivamente detratto dai *tuoi* pagamenti, quindi ciò che ottieni è il *tuo* CPC di pareggio, non un listino. Una parola chiave negativa proposta su una manciata di clic ti avverte che zero ordini su clic a una cifra è ciò che un tasso di conversione normale sembra la maggior parte del tempo. Mettere in pausa una campagna che produce ordini ti dice il contributo che smetteresti insieme alla spesa.

E quando i numeri non possono essere prodotti — pochi ordini registrati, nessun costo unitario salvato per la SKU — la bozza lo dice. Un cambiamento non prezzato presentato come sicuro è esattamente il difetto che questo sistema è costruito per prevenire.

### Approvazione

Apri **Impostazioni → Approvazioni**. Ogni bozza mostra cosa cambia, i suoi rischi e da quanto tempo esiste. Due pulsanti contano:

- **"Chiedi prima ad Amazon"** invia il payload esatto attraverso l'anteprima di convalida di Amazon e restituisce il *verdetto di Amazon* — accettato o rifiutato — senza toccare la listing. Scoprire dopo che Amazon ha rifiutato una modifica costa ore di visibilità idonea agli annunci, quindi vale la pena cliccare.
- **"Approva e invia ad Amazon"** la applica. La riga va in `applied` con l'ID di invio di Amazon o in `failed` con il vero messaggio di errore. Non esiste uno stato in cui il pannello dice approvato mentre non è stato tentato nulla.

Una bozza più vecchia di sette giorni è contrassegnata come **obsoleta** — l'economia al suo interno è stata congelata quando è stata scritta e le tariffe delle fee cambiano. È un avviso: puoi comunque applicarla con una conferma aggiuntiva.

Non devi vivere nel pannello, comunque. Partono automaticamente quattro email: quando una bozza è creata, una volta al giorno mentre attende, nel momento in cui viene applicata o fallisce e ancora quando il risultato è giudicato.

## Passo 5 — Ha funzionato davvero?

Due settimane dopo l'applicazione di una modifica, `did_my_changes_work` riporta cosa è successo alla conversione nel quindicennio successivo, giudicato rispetto a finestre congelate al momento della modifica.

I verdetti sono deliberatamente conservativi e questa è la caratteristica, non un limite. A basso volume, **"inconcludente" è la risposta onesta** — e dice esattamente perché: traffico scarso, normale variazione giorno per giorno o un'altra modifica alla stessa listing nella finestra. Una modifica la cui finestra non è ancora chiusa riporta `measuring`, con la data in cui può essere letta per la prima volta.

Dichiara anche il suo limite: questo è ciò che è accaduto *insieme* alla modifica, non la prova che l'ha causato. Ads, concorrenti, recensioni, promozioni e stagionalità si sono tutti mossi nella stessa finestra. E le modifiche che hai fatto direttamente in Seller Central sono invisibili, comprese quelle arrivate dentro una finestra misurata.

Chiunque ti prometta un'attribuzione causale pulita su una listing a singola SKU con poche vendite al giorno ti sta vendendo un intervallo di confidenza che non ha calcolato.

## Cosa non fa

- Non ricerca prodotti, non scansiona concorrenti o stima le vendite altrui. Misura il **tuo** account. Se è quello che cerchi, il nostro [confronto di tool per venditori EU](/it/blog/best-amazon-fba-tools-eu-sellers-2026) è un punto di partenza migliore.
- Non agisce da solo. Non c'è pilota automatico; ogni modifica attende un umano.
- Non converte valute e non inventa un numero per riempire un vuoto.
- Senza un costo unitario salvato per una SKU, il suo profitto è sovrastimato dell'intero COGS — e `what_i_cannot_tell_you` te lo dirà per quali SKU, senza che tu lo chieda.

## Inizia ora

1. [Prova il connettore demo](/connect) — nessun account necessario, 60 secondi.
2. Connetti il tuo account Amazon in Impostazioni → Connessione Amazon.
3. Genera un token in Impostazioni → Assistente AI o aggiungi il connettore personalizzato in Claude o ChatGPT.
4. Chiedi: *"Quanto posso fidarmi di questi numeri?"* È la prima domanda più rivelatrice che puoi fare a qualsiasi tool Amazon e questo risponde con una misurazione invece che con una frase di marketing.

[Vedi piani e prezzi →](/pricing)