Collegare Amazon Shipping a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Amazon Shipping.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

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

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.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude