Amazon Shipping MCP: tariffe, tracking ed etichette

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

Amazon Shipping

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

Configurazione

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 dei Servizi Amazon, 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 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 riporta 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 non è fatto.

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 id di tracciamento e id del vettore.

Tariffe: amazon_shipping_get_rates richiede per ogni pacco un packageClientReferenceId di tua scelta, dimensioni, peso, valore assicurato e almeno un articolo. channel_details.channelType è EXTERNAL per ordini dal tuo negozio e AMAZON (con l'id ordine Amazon) per ordini Amazon. La risposta riporta 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 nuovamente l'etichetta di un pacco acquistato (base64) e richiede l'id della spedizione e il 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 vettore collegati. amazon_shipping_generate_collection_form chiude le spedizioni aperte di un vettore ed è installato disattivato.

Acquisto (disattivato): amazon_shipping_purchase_shipment acquista una tariffa, amazon_shipping_one_click_shipment acquista per id 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 cancella una spedizione acquistata prima della consegna. Ogni acquisto viene addebitato sull'account Amazon Shipping. Passa una chiave di idempotenza e riutilizzala quando ripeti, così un timeout non acquista due volte.

Formati: gli importi sono oggetti con value e unit (la valuta); i pesi usano GRAMMO, CHILOGRAMMO, ONCIA o LIBBRA e le dimensioni POLLICE o CENTIMETRO; i tempi sono ISO 8601. Le risposte sono avvolte 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.

Prerequisiti: SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

Installa il connettore localmente

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

Apri http://localhost:3000/connectors/store, scegli Amazon Shipping e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

Esempi di richieste

• "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 nuovamente l'etichetta della spedizione che ho acquistato questa mattina."
• "Quali spedizioni non sono ancora su un modulo di raccolta?"

Prossimi passi

• Collegati a Claude
• Collegati a ChatGPT