Collegare Amazon Vendor Central MCP a Microsoft Copilot

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

Amazon Vendor Central + Microsoft Copilot

Amazon Vendor Central attraverso l'API Selling Partner: ordini di acquisto al dettaglio, conferme, conferme di spedizione, fatture, ordini di Direct Fulfillment con etichette, bolle di accompagnamento e inventario, stato delle transazioni e report dei fornitori. Accedi con il token di aggiornamento Amazon di un'applicazione fornitore privata.

Prerequisiti

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

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, SPAPI_MARKETPLACE_ID

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 20 minuti. Hai bisogno dell'approvazione di Amazon del profilo sviluppatore.

1. In Vendor Central apri Integrazione, poi Integrazione API, e completa il Profilo Sviluppatore. Sotto Accesso ai Dati scegli Sviluppatore Privato: creo applicazione(i) che integrano la mia azienda con le API dei servizi Amazon, seleziona i ruoli di cui hai bisogno e scegli Registrati. Amazon esamina il profilo e apre un caso con i prossimi passi.
2. Nella stessa pagina scegli Aggiungi nuovo client app, completa il modulo, seleziona Fornitori dove Amazon offre la scelta, e seleziona i ruoli. Poi scegli Visualizza sotto credenziali LWA e copia l'identificatore client in SPAPI_CLIENT_ID e il segreto client in SPAPI_CLIENT_SECRET.
3. Scegli Autorizza app per il tuo account fornitore. Amazon mostra un token di aggiornamento (inizia con Atzr|): incollalo in SPAPI_REFRESH_TOKEN.
4. Scegli la tua regione in SPAPI_ENDPOINT (Nord America, Europa o Estremo Oriente) e inserisci l'id del marketplace del tuo negozio Amazon in SPAPI_MARKETPLACE_ID, ad esempio ATVPDKIKX0DER (US), A1PA6795UKMFR9 (Germania), A1F83G8C2ARO7P (UK), APJ6JRA9NG5V4 (Italia), A13V1IB3VIYZZH (Francia), A1RKKUPIHCS9HS (Spagna), A1VC38T7YXB528 (Giappone).

Ruoli: gli strumenti al dettaglio necessitano del ruolo Amazon Fulfillment. Gli strumenti di Direct Fulfillment necessitano del ruolo Spedizione Diretta al Consumatore (Riservato), un ruolo riservato perché gli ordini contengono indirizzi dei clienti; Amazon richiede ulteriori informazioni sulla protezione dei dati prima di concederlo. I report dei fornitori necessitano di Brand Analytics. Una chiamata senza il suo ruolo restituisce 403.

Da dove iniziare: amazon_vendor_list_purchase_orders con purchase_order_state New mostra cosa ha ordinato Amazon; amazon_vendor_get_purchase_order fornisce un ordine completo.

Acquisti al dettaglio: amazon_vendor_list_purchase_orders, amazon_vendor_get_purchase_order, amazon_vendor_list_purchase_order_statuses (quantità accettate e ricevute). Rispondi a un ordine con amazon_vendor_submit_acknowledgements, annuncia la spedizione con amazon_vendor_submit_shipment_confirmations, e segui con amazon_vendor_list_shipments e amazon_vendor_list_transport_labels. Le conferme e le conferme di spedizione sono risposte vincolanti per Amazon, quindi amazon_vendor_submit_acknowledgements e amazon_vendor_submit_shipment_confirmations sono installati disattivati, così come amazon_vendor_submit_invoices: attivali nella pagina del connettore quando l'AI dovrebbe inviarli; ti chiederà di confermare ogni singolo.

Direct Fulfillment (spedisci al cliente di Amazon): amazon_vendor_list_df_orders, amazon_vendor_get_df_order, amazon_vendor_acknowledge_df_orders, amazon_vendor_list_df_packing_slips, amazon_vendor_get_df_packing_slip, amazon_vendor_list_df_customer_invoices, amazon_vendor_list_df_shipping_labels, amazon_vendor_get_df_shipping_label, amazon_vendor_submit_df_shipment_confirmations e amazon_vendor_update_df_inventory. Creare etichette prenota il trasporto: amazon_vendor_request_df_shipping_labels e amazon_vendor_create_df_shipping_labels sono installati disattivati, così come amazon_vendor_acknowledge_df_orders, amazon_vendor_submit_df_shipment_confirmations e amazon_vendor_submit_df_invoices.

Le sottomissioni sono asincrone: ogni strumento di invio risponde con un transactionId e nient'altro. Leggi l'esito con amazon_vendor_get_transaction_status (al dettaglio) o amazon_vendor_get_df_transaction_status (Direct Fulfillment): Elaborazione, Successo o Fallimento con gli errori. Non segnalare una sottomissione come completata prima che dica Successo.

Report (3 passi): amazon_vendor_create_report, poi amazon_vendor_get_report fino a DONE, poi amazon_vendor_download_report_document.

Note di campo: le chiamate di elenco coprono al massimo 7 giorni per chiamata; gli elenchi di Direct Fulfillment necessitano sia di created_after che di created_before. I tempi sono ISO 8601. Le quantità vengono con un'unità (Casi o Pezzi per il dettaglio, Pezzo per il Direct Fulfillment); il denaro è una stringa decimale con un codice valuta. partyId è il tuo codice fornitore per la parte venditrice e un codice magazzino per le parti di spedizione e ricezione. Pagina degli elenchi con pagination.nextToken.

Limiti di chiamata: 10 chiamate al secondo per operazione con un picco di 10 (stato della transazione: picco 20). In caso di 429 aspetta un momento e riprova.

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 Vendor Central.
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

• "Quali nuovi ordini di acquisto Amazon sono arrivati questa settimana e quali quantità richiedono?"
• "Mostra l'ordine di acquisto 2JK3S9VC con i suoi articoli e la finestra di spedizione."
• "Quali ordini di Direct Fulfillment necessitano ancora di un'etichetta di spedizione?"
• "Controlla la transazione 12345-abcde: Amazon ha accettato la fattura che ho inviato?"
• "Richiedi un report di vendita fornitore per la scorsa settimana e dimmi quando è pronto."

FAQ

Da dove provengono le credenziali? Da un'app privata in Vendor Central (Integrazione, Integrazione API) dopo che Amazon ha esaminato il tuo Profilo Sviluppatore. Copia l'ID client LWA e il segreto, scegli Autorizza app per ottenere il token di aggiornamento e inserisci la tua regione e l'id del marketplace. Non sono necessarie chiavi AWS.

Quali ruoli sono necessari? Gli strumenti al dettaglio necessitano di Amazon Fulfillment, gli strumenti di Direct Fulfillment del ruolo riservato Spedizione Diretta al Consumatore, e i report di Brand Analytics. È per i fornitori (1P); i venditori su Seller Central usano il connettore Amazon Seller Central.

Quali strumenti vengono installati disattivati? Le risposte vincolanti ad Amazon: amazon_vendor_submit_acknowledgements, amazon_vendor_submit_shipment_confirmations, amazon_vendor_submit_invoices, amazon_vendor_acknowledge_df_orders, amazon_vendor_request_df_shipping_labels, amazon_vendor_create_df_shipping_labels, amazon_vendor_submit_df_shipment_confirmations e amazon_vendor_submit_df_invoices. Attivali nella pagina del connettore quando l'AI dovrebbe inviarli.

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