Collegare Amazon Shipping a ChatGPT via MCP

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Amazon Shipping, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Amazon Shipping + ChatGPT

Amazon Shipping API v2 (SP-API) per le aziende che spediscono con Amazon come corriere: confronta tariffe, traccia pacchi, recupera etichette e documenti, trova armadietti e punti di ritiro, e leggi i moduli di raccolta. Gli acquisti, l'acquisto con un clic e la cancellazione sono inclusi ma disattivati. App SP-API privata con il ruolo di Amazon Logistics.

Requisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 20 minuti. Hai bisogno delle recensioni Amazon plus.

1. Hai bisogno di un account Amazon Shipping. I venditori su Amazon utilizzano il loro account Seller Central; altri spedizionieri creano un account su https://solutionproviderportal.amazon.com (non è necessario un account venditore) e completano la verifica dell'identità dello sviluppatore.
2. Completa il Profilo Sviluppatore: per Accesso ai Dati scegli Sviluppatore Privato: creo applicazione(i) che integrano la mia azienda con le API di Amazon Services, per Ruoli scegli Amazon Logistics. Amazon risponde entro circa 5 giorni lavorativi.
3. Crea un client app SP-API chiamato AmazonShipping_YourCompany, con l'entità commerciale Shipping e il ruolo Amazon Logistics, e rispondi No alla delega dell'accesso ai dati riservati (PII).
4. Sotto credenziali LWA scegli Visualizza e copia l'identificatore client (amzn1.application-oa2-client.…) in SPAPI_CLIENT_ID e il segreto client in SPAPI_CLIENT_SECRET.
5. Autorizza l'app per il tuo account (Autorizza app) e copia il token di aggiornamento (Atzr|…) in SPAPI_REFRESH_TOKEN.
6. Scegli la regione in SPAPI_ENDPOINT e il tuo paese di Amazon Shipping in AMAZON_SHIPPING_BUSINESS_ID. Stati Uniti: Nord America. Regno Unito, Francia, Italia, Spagna, India, Emirati Arabi Uniti, Arabia Saudita, Egitto: Europa. Giappone: Estremo Oriente.

Il connettore scambia il token di aggiornamento su https://api.amazon.com/auth/o2/token per token di accesso di un'ora e li invia nell'intestazione x-amz-access-token; l'intestazione x-amzn-shipping-business-id contiene il paese. Le variabili hanno gli stessi nomi del connettore Amazon Seller Central, ma l'app deve avere il ruolo di Amazon Logistics: le credenziali di un'app di vendita senza di esso rispondono con 403.

Prima della prima etichetta reale: Amazon richiede a ogni nuova integrazione di produrre un'etichetta di test e farla approvare (Guida all'etichetta di test di Amazon Shipping) e poi conferma la prima data di spedizione. Tieni gli strumenti di acquisto disattivati fino a quando ciò non è completato.

Da dove iniziare: amazon_shipping_get_rates con l'indirizzo di partenza, la destinazione e un pacco restituisce i servizi e i prezzi; amazon_shipping_get_tracking segue un pacco tramite l'id di tracciamento e l'id del corriere.

Tariffe: amazon_shipping_get_rates ha bisogno per ogni pacco di un packageClientReferenceId di tua proprietà, dimensioni, peso, valore assicurato e almeno un articolo. channel_details.channelType è EXTERNAL per ordini dal tuo negozio e AMAZON (con l'id dell'ordine Amazon) per ordini Amazon. La risposta contiene un requestToken e un rateId per servizio; entrambi sono necessari per acquistare e scadono dopo 10 minuti. Quando una tariffa dice requiresAdditionalInputs, leggi lo schema con amazon_shipping_get_additional_inputs.

Tracciamento e documenti: amazon_shipping_get_tracking restituisce lo stato riassuntivo e la cronologia degli eventi; amazon_shipping_get_shipment_documents restituisce di nuovo l'etichetta di un pacco acquistato (base64) e necessita dell'id di spedizione e del tuo packageClientReferenceId. amazon_shipping_get_access_points trova armadietti e punti di ritiro vicino a un codice postale.

Moduli di raccolta: amazon_shipping_get_unmanifested_shipments mostra cosa aspetta ancora un manifesto, amazon_shipping_get_collection_form_history e amazon_shipping_get_collection_form leggono moduli precedenti, e amazon_shipping_get_carrier_accounts elenca gli account corrieri collegati. amazon_shipping_generate_collection_form chiude le spedizioni aperte di un corriere ed è installato disattivato.

Acquisto (disattivato): amazon_shipping_purchase_shipment acquista una tariffa, amazon_shipping_one_click_shipment acquista per id di servizio senza richiesta di tariffa, amazon_shipping_direct_purchase_shipment acquista per un ordine Amazon con il servizio scelto da Amazon, e amazon_shipping_cancel_shipment annulla una spedizione acquistata prima della consegna. Ogni acquisto viene addebitato sull'account Amazon Shipping. Passa una chiave di idempotenza e riutilizzala quando ripeti, in modo che un timeout non acquisti due volte.

Formati: gli importi sono oggetti con value e unit (la valuta); i pesi utilizzano GRAMMO, CHILOGRAMMO, ONCIA o LIBBRA e le dimensioni POLLICE o CENTIMETRO; i tempi sono ISO 8601. Le risposte sono racchiuse in payload; i fallimenti arrivano come errors, un elenco di code, message e details.

Limiti: 80 chiamate al secondo con un picco di 100 nella maggior parte delle operazioni; l'intestazione di risposta x-amzn-RateLimit-Limit mostra il limite applicato. Un 429 significa attendere e riprovare.

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: Amazon Shipping.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Strumenti disponibili

Esempi di prompt

• "Confronta le tariffe di Amazon Shipping per un pacco di 2 kg da Manchester M1 1AE a Londra SW1A 1AA."
• "Traccia il pacco Amazon Shipping QA0123456789 e dimmi l'ultima scansione."
• "Trova armadietti Amazon vicino al codice postale EC1A 1BB."
• "Recupera di nuovo l'etichetta della spedizione che ho acquistato questa mattina."
• "Quali spedizioni non sono ancora su un modulo di raccolta?"

FAQ

Da dove provengono le credenziali? Da un'app SP-API privata con il ruolo di Amazon Logistics, creata in Seller Central o, senza un account venditore, nel Portale dei Fornitori di Soluzioni Amazon. Copia l'ID client LWA e il segreto, autorizza l'app per il tuo account per ottenere il token di aggiornamento e scegli la tua regione e il paese di Amazon Shipping.

Quali paesi copre? I paesi in cui Amazon Shipping opera: Stati Uniti, Regno Unito, Francia, Italia, Spagna, India, Emirati Arabi Uniti, Arabia Saudita, Egitto e Giappone. È per pacchi spediti con Amazon come corriere, anche per ordini che non provengono da Amazon.

Può acquistare etichette o annullare spedizioni? amazon_shipping_purchase_shipment, amazon_shipping_direct_purchase_shipment, amazon_shipping_one_click_shipment, amazon_shipping_cancel_shipment e amazon_shipping_generate_collection_form sono installati disattivati. Attivali nella pagina del connettore solo se l'AI deve usarli.

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude