Collegare Amazon Vendor Central MCP a Cursor

💡 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 + Cursor

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Amazon Vendor Central.

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.

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude