Come trasformare Amazon Seller Central in un server MCP (SP-API)

Il tuo account Amazon Seller, disponibile per qualsiasi agente AI

L'API Selling Partner di Amazon (SP-API) è l'interfaccia ufficiale per tutto ciò che riguarda Seller Central — ordini, catalogo prodotti, stock FBA, prezzi, commissioni e report finanziari. È anche notoriamente noioso da integrare: flussi OAuth, endpoint regionali, ID marketplace, limiti di velocità per endpoint.

AnythingMCP trasforma l'SP-API in un server MCP pronto all'uso, così Claude, ChatGPT, Cursor, Gemini o qualsiasi agente compatibile con MCP possono rispondere a domande come "Quanti ordini ho ricevuto ieri e quali SKU sono in esaurimento in FBA?" — senza alcun codice di integrazione.

Cosa ottieni (15 strumenti)

Requisiti

1. Un account Seller Central professionale.
2. Una registrazione sviluppatore (gratuita): Seller Central → App e Servizi → Sviluppa App. Amazon esamina manualmente il profilo dello sviluppatore — consenti alcuni giorni.
3. Un app privata: Sviluppa App → Aggiungi nuovo client app → digita Sellers → seleziona ruoli come "Inventario e Monitoraggio Ordini", "Prezzi", "Evasione Amazon", "Finanza e Contabilità". Non hai bisogno dei ruoli PII riservati.

Configurazione

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

Oppure usa AnythingMCP Cloud — non è necessaria l'auto-ospitazione.

1. Apri il negozio dei connettori e importa Amazon Seller Central (SP-API).
2. Dal tuo app in Seller Central, copia il Client ID (amzn1.application-oa2-client…) e il Client Secret.
3. Clicca su Autorizza nella riga dell'app — Amazon mostra il tuo Refresh Token (Atzr|…).
4. Compila le variabili d'ambiente del connettore:

5. Assegna il connettore a un server MCP e collega il tuo client AI.

Il connettore gestisce per te l'intero ballo Login-with-Amazon OAuth2: il tuo refresh token viene scambiato automaticamente per token di accesso di 1 ora, inviati nell'intestazione x-amz-access-token esattamente come richiesto dall'SP-API. Nessuna chiave AWS IAM e nessuna firma SigV4 — Amazon ha eliminato quel requisito.

Esempi di richieste

• "Quanti ordini sono arrivati negli ultimi 7 giorni e qual è il loro valore totale?"
• "Quali dei miei SKU FBA hanno meno di 10 unità evadibili?"
• "Possiedo la buy box per l'ASIN B08N5WRWNW? Chi mi sta sottocosto?"
• "Se prezzo questo articolo a €24,99, quali commissioni prenderà Amazon e qual è il mio margine?"
• "Richiedi il report vendite e traffico per giugno e riassumi la tendenza."

FAQ

Funziona con FBA e FBM?

Sì. Gli ordini espongono il canale di evasione (AFN/MFN) e amazon_fba_inventory copre lo stock FBA. I venditori che evadono gli ordini utilizzano gli stessi strumenti di ordine e prezzo.

Quali marketplace sono supportati?

Tutti — il connettore è indipendente dalla regione. Imposta SPAPI_ENDPOINT sul tuo host regionale (EU/NA/FE) e SPAPI_MARKETPLACE_ID sul tuo marketplace. Vendi in diversi marketplace? Crea un connettore per ogni marketplace con le stesse credenziali.

L'AI può vedere i nomi e gli indirizzi dei clienti?

No — per design. I PII degli acquirenti richiedono il Restricted Data Token di Amazon e un ruolo appositamente approvato. Questo connettore utilizza la vista standard non-PII: ID ordine, stati, totali, SKU e quantità, che è ciò di cui hanno bisogno le analisi e i flussi di lavoro operativi.

Può cambiare i prezzi o modificare le inserzioni?

La versione 1 è focalizzata sulla lettura per sicurezza. Le operazioni di scrittura (ri-prezzatura, aggiornamenti delle inserzioni, feed) sono nella roadmap — facci sapere il tuo caso d'uso nelle discussioni della comunità.

C'è un sandbox?

Sì. Punta SPAPI_ENDPOINT su https://sandbox.sellingpartnerapi-eu.amazon.com (o -na/-fe) per ottenere risposte statiche predefinite con le stesse credenziali.