Easyship MCP ti consente di gestire le operazioni di spedizione usando il linguaggio naturale: basta digitare ciò di cui hai bisogno, proprio come se stessi chattando con un assistente.
Invece di passare da uno strumento all'altro o gestire manualmente le spedizioni, puoi confrontare le tariffe, generare etichette, monitorare le spedizioni, sincronizzare gli ordini, verificare gli indirizzi, gestire i ritiri, calcolare imposte e dazi e molto altro.
In questo articolo:
- A chi è rivolto?
- Piattaforme supportate
- Cosa ti serve
- Configurazione rapida
- Ambito del token API
- Azioni disponibili
- Domande frequenti
A chi è rivolto?
Easyship MCP è progettato per:
- Commercianti e-commerce
- Team operativi e di gestione degli ordini
- Agenti dell'assistenza clienti
- Chiunque gestisca spedizioni e logistica
Non è necessaria alcuna programmazione: una conoscenza di base delle impostazioni e delle chiavi API è utile per la configurazione iniziale.
Piattaforme supportate
Easyship MCP è compatibile con qualsiasi piattaforma che supporti il Model Context Protocol. La modalità di connessione dipende dall'app:
- Accedi con Easyship (OAuth): non è necessario alcun token API. Accedi a Easyship e autorizzi l'accesso dall'interno dell'app.
- Token API: crei un token API Easyship e lo aggiungi alle impostazioni MCP dell'app.
| Tipo di piattaforma | App supportate | App supportate |
| App di chat/assistenti | ChatGPT, Grok (grok.com), Claude (Desktop, Claude Code e altre) | ChatGPT e Grok: accedi con Easyship (OAuth). Claude: token API. Un connettore Claude nativo con accesso Easyship (OAuth) sarà disponibile prossimamente. |
| Ambienti di programmazione IA | Cursor, Windsurf, Google Antigravity | Token API |
| IA e API cloud | OpenAI (Responses API, Agents SDK), Google Gemini (CLI, Code Assist e browser), Grok (API xAI e browser) | Token API |
| Automazione dei flussi di lavoro | n8n, make.com, Zapier, Celigo | Token API |
| Skills-first/ibrido | Perplexity, OpenClaw | Easyship Skill (disponibile su ClawHub) |
Cosa ti serve
Prima di iniziare, assicurati di avere:
- Un account Easyship attivo
- Un'app compatibile con MCP (vedi Piattaforme supportate sopra)
- Un token API Easyship, solo se l'app si connette tramite un token API (non necessario per ChatGPT o Grok)
Come connettersi
Opzione A: Accedi con Easyship (OAuth): ChatGPT e Grok
Non è necessario alcun token API. Connetti Easyship dall'interno dell'app e autorizzi l'accesso usando le tue credenziali Easyship.
- Aggiungi Easyship nella tua app (installa il plugin Easyship in ChatGPT oppure aggiungi un connettore personalizzato in Grok)
- Accedi al tuo account Easyship quando vieni reindirizzato
- Esamina le autorizzazioni e fai clic su Autorizza
- Torna alla tua app. Easyship apparirà come connesso e potrai iniziare a digitare i prompt
Per istruzioni dettagliate relative alla tua piattaforma, consulta:
- Come connettere ChatGPT e l'API OpenAI al server Easyship MCP
- Come connettere Grok al server Easyship MCP
Opzione B: Token API: Cursor, Claude, API OpenAI e altri client MCP
Ottieni il token API
- Accedi a Easyship e vai su Connetti > Nuova integrazione.
- Scorri verso il basso e seleziona Integrazione API.
- In Tipo di integrazione, seleziona Sto sviluppando un'integrazione personalizzata.
- Assegna alla chiave il nome Easyship MCP per poterla identificare facilmente.
- Mantieni la versione predefinita 2024-09 e fai clic su Connetti.
- Fai clic su Token di accesso e copialo usando il pulsante di copia.
⚠️ Avviso di sicurezza: conserva il token in modo sicuro. Non incollare mai il token API in un messaggio di chat. Aggiungilo solo nelle impostazioni dell'app, dove viene archiviato in modo sicuro. Chiunque disponga del tuo token può acquistare etichette utilizzando il tuo account.
Connettiti
- Aggiungi il server Easyship MCP nell'app scelta.
- Incolla il token API quando richiesto.
- Salva e connettiti.
Per istruzioni dettagliate relative alla tua piattaforma, consulta:
- Guida alla configurazione di Easyship MCP per Cursor
- Come connettere ChatGPT e l'API OpenAI al server Easyship MCP
- Documentazione per sviluppatori Easyship MCP
⚠️ Attenzione: non esiste un ambiente di test separato per le azioni MCP. Qualsiasi azione che consumi crediti (come la generazione di etichette) comporterà addebiti reali. Se ti connetti con un token API, ti consigliamo di utilizzare per la prima esecuzione un token API di test con ambiti limitati. Consulta i tuoi piani tariffari e i limiti inclusi.
Ambiti del token API
Questa sezione si applica solo se ti connetti con un token API. Se ti connetti con l'accesso Easyship (OAuth), le autorizzazioni vengono concesse quando fai clic su Autorizza.
Il token API Easyship richiede i seguenti ambiti. Senza di essi, alcuni strumenti non funzioneranno:
| Ambito | Utilizzato per |
| public.shipment:read | Elencare, ottenere e monitorare le spedizioni |
| public.shipment:write | Creare, aggiornare, eliminare e annullare le spedizioni |
| public.label:write | Acquistare etichette di spedizione |
| public.pickup:read | Elencare i ritiri e ottenere le fasce orarie disponibili |
| public.pickup:write | Creare e annullare i ritiri |
| public.address_validation:write | Convalidare gli indirizzi internazionali |
| public.address_validation_domestic:write | Convalidare gli indirizzi statunitensi |
| public.shipment_document:read | Recuperare i metadati delle fatture commerciali |
| public.transaction_record:read | Visualizzare transazioni e fatturazione |
| public.analytics:read | Tutti gli strumenti di analisi |
| public.rate:read | Confrontare le opzioni e le tariffe dei corrieri |
| public.track:read | Monitorare lo stato della consegna del pacco |
Azioni disponibili
Tariffe
| Strumento | Cosa fa | Prova questo prompt |
| get_rates | Confronta le opzioni dei corrieri con tariffe scontate e pre-negoziate e i tempi di consegna. | "Voglio spedire un pacco da 0,05 kg (6×2×4 cm) da 350 5th Avenue, New York, USA a 220 Yonge Street, Toronto, Canada. Mostrami le opzioni più economiche e con il miglior rapporto qualità-prezzo, indicando i tempi di consegna." |
Spedizioni
| Strumento | Cosa fa | Prova questo prompt |
| create_shipment | Avvia una spedizione con indirizzi e dettagli del pacco. Salvala come bozza oppure acquista un'etichetta quando è pronta. | "Crea una spedizione come bozza da Jane Sender, 350 5th Avenue, New York, NY a John Recipient, 220 Yonge Street, Toronto, ON. Pacco: 0,12 kg, 22×15×3 cm. Non acquistare ancora un'etichetta." |
| create_label | Acquista e genera un'etichetta di spedizione per una spedizione esistente. | "Acquista un'etichetta per la spedizione ESSG10006001 e forniscimi il link per il download." |
| get_shipment | Controlla lo stato e i costi di una spedizione e i link per scaricare l'etichetta, la distinta di imballaggio o la fattura. | "Apri la spedizione ESSG10006001. Ho bisogno dei dettagli completi e dei link ai documenti: etichetta 4×6, distinta di imballaggio e fattura commerciale A4." |
| list_shipments | Sfoglia o cerca le tue spedizioni per paese, stato e altro. | "Mostrami la pagina 1 delle mie spedizioni, 20 per pagina. Escludi quelle annullate. Mostra solo le spedizioni dirette in Canada con un'etichetta generata o stampata." |
| update_shipment | Modifica i dettagli di una spedizione esistente prima della spedizione. | "Per la spedizione ESSG10006001, aggiorna il telefono del destinatario a +1 416-555-0200 e aggiungi Suite 400 come riga 2 dell'indirizzo. Lascia invariato tutto il resto." |
| cancel_shipment | Annulla una spedizione che non è ancora stata ritirata. | "Annulla la spedizione ESSG10006001 e dimmi se l'operazione è riuscita o quale errore è stato restituito." |
| delete_shipment | Rimuove una spedizione in bozza o non spedita. | "Elimina la spedizione ESSG10006001: è ancora una bozza. Conferma quando hai terminato." |
| track_shipment | Mostra dove si trova un pacco, la stima di consegna e gli eventi di tracciamento recenti. | "Monitora la spedizione ESSG10006001. Qual è lo stato più recente, esiste un orario stimato di arrivo e quali sono stati gli ultimi tre eventi di tracciamento?" |
Convalida degli indirizzi
| Strumento | Cosa fa | Prova questo prompt |
| validate_address | Verifica se un indirizzo è idoneo alla consegna e fornisce correzioni suggerite. | "Questo indirizzo è valido per la spedizione con Easyship: 1600 Amphitheatre Parkway, Building 43, Mountain View, CA 94043, US? Non sostituirlo automaticamente: mostra solo se è valido e le eventuali correzioni consigliate." |
Ritiri
| Strumento | Cosa fa | Prova questo prompt |
| get_pickup_slots | Mostra quando un corriere può ritirare i pacchi prima della prenotazione. | "Per la spedizione ESSG10006001, cerca l'ID del servizio del corriere, quindi recupera le fasce orarie disponibili per il ritiro. Riassumi i prossimi tre giorni con le fasce disponibili." |
| create_pickup | Prenota un corriere per ritirare uno o più pacchi dallo stesso vettore. | "Pianifica un ritiro per le spedizioni ESSG10006001 e ESSG10006002 il 14 aprile 2026. Recupera l'ID del corriere dalla prima spedizione e conferma l'ID del ritiro al momento della creazione." |
| list_pickups | Visualizza i ritiri pianificati, filtrati per corriere, data o stato. | "Mostrami i miei ritiri: pagina 1, 25 per pagina, corriere USPS, data del ritiro 15 aprile 2026, stato richiesto." |
| get_pickup | Apre un ritiro per visualizzare tutti i dettagli, inclusi orario, corriere e spedizioni collegate. | "Forniscimi tutti i dettagli del ritiro ESPICKUP-US-2026-0001." |
| cancel_pickup | Annulla un ritiro pianificato. | "Annulla il ritiro ESPICKUP-US-2026-0001 e comunicami il risultato." |
| list_pickup_shipments | Mostra quali pacchi sono inclusi in un ritiro pianificato. | "Per il ritiro ESPICKUP-US-2026-0001, elenca gli ID delle spedizioni e le destinazioni: pagina 1, 20 per pagina." |
Fatturazione e analisi
| Strumento | Cosa fa | Prova questo prompt |
| list_transactions | Esamina addebiti e crediti sul tuo account Easyship per data, tipo o spedizione. | "Recupera le mie transazioni: pagina 1, 50 per pagina, dal 1° marzo al 9 aprile 2026, tipo: spedizione." |
| list_billing_transactions | Visualizza le singole voci alla base di una fattura specifica. | "Per il documento di fatturazione BDOC-2026-03-0042, elenca le transazioni di fatturazione, pagina 1, 50 per pagina, dal 1° al 31 marzo 2026." |
| analytics_shipments | Mostra quante spedizioni hai creato nel tempo, incluse le tendenze giornaliere. | "Mostra le analisi del volume delle spedizioni dal 9 gennaio al 9 aprile 2026, inclusa la tendenza giornaliera e il giorno di picco." |
| analytics_shipped_activity | Mostra se le etichette sono state effettivamente utilizzate in un determinato periodo, non solo se sono state create delle bozze. | "Dal 9 gennaio al 9 aprile 2026, cosa mostra Easyship sull'attività di spedizione effettiva in quel periodo?" |
| analytics_status_breakdown | Mostra una suddivisione delle spedizioni per fase. | "Mostrami la suddivisione dello stato delle spedizioni dal 9 gennaio al 9 aprile 2026: cosa è in corso e cosa è completato?" |
| analytics_top_couriers | Mostra quali vettori utilizzi più spesso in base al volume. | "Dal 9 gennaio al 9 aprile 2026, quali corrieri ho utilizzato più spesso? Classificali con il numero e la percentuale del volume." |
| analytics_top_destinations | Mostra dove invii il maggior numero di pacchi. | "Dal 9 gennaio al 9 aprile 2026, dove effettuo più spedizioni? Riassumi i principali paesi e le zone." |
| analytics_by_channel | Mostra quale fonte genera le tue spedizioni. | "Per gli ultimi 3 mesi, suddividi le mie spedizioni per canale di vendita con il numero e la percentuale per canale." |
Domande frequenti
È necessario un token API per utilizzare Easyship MCP?
Non sempre. ChatGPT e Grok si connettono accedendo con il tuo account Easyship (OAuth), quindi non è necessario alcun token API. App come Cursor, Claude Desktop, n8n e l'API OpenAI utilizzano un token API Easyship. Consulta la sezione Piattaforme supportate sopra per sapere come si connette ciascuna app.
Devo imparare comandi specifici?
No, digita semplicemente ciò di cui hai bisogno in inglese semplice. Cerca di includere più dettagli possibile fin dall'inizio. Se manca qualche informazione necessaria, l'agente te la chiederà o suggerirà dei valori tra cui scegliere.
Posso usarlo con Shopify o altre piattaforme?
Sì. Connetti il tuo agente con MCP di Shopify (o con l'MCP della tua piattaforma) insieme a Easyship MCP per gestire i flussi di lavoro di spedizione multipiattaforma da un unico luogo.
Si applicano le mie regole di automazione delle spedizioni Easyship?
Sì. Le spedizioni elaborate tramite MCP sono spedizioni Easyship standard, quindi si applicano tutte le regole di spedizione, le preferenze relative alle tariffe e le impostazioni di automazione esistenti.
Mi verrà addebitato un costo per recuperare le tariffe tramite MCP?
No. Il recupero delle tariffe, l'elenco delle spedizioni e il monitoraggio sono gratuiti. Solo l'acquisto di etichette o la prenotazione di ritiri consuma crediti.
Devo pagare per utilizzare Easyship MCP?
No. Easyship fornisce l'accesso API a tutti i piani senza costi aggiuntivi. Potrebbero essere applicati costi per eccedenza se superi i limiti mensili. Consulta tutti i piani tariffari e i limiti API per maggiori informazioni.
Posso connettere Easyship MCP a più app?
Sì. Puoi connettere Easyship a tutte le app MCP che desideri. Le app OAuth, come ChatGPT e Grok, si connettono ciascuna con il proprio accesso Easyship. Per le app che utilizzano un token API, lo stesso token funziona con Cursor, Claude, Gemini e altre. Presta attenzione ai limiti di frequenza ed evita di eseguire contemporaneamente operazioni in conflitto.
Posso elaborare più spedizioni contemporaneamente?
Sì. Puoi gestire ordini in blocco usando semplici prompt: carica un CSV oppure chiedi all'agente di recuperare le ultime X spedizioni e generare automaticamente le etichette per tutte. L'agente selezionerà ogni spedizione e acquisterà un'etichetta per volta, segnalando le spedizioni per cui sono necessari i tuoi dati prima di poter acquistare l'etichetta.
Perché visualizzo un errore Subscription inactive e come posso risolverlo?
Il tuo abbonamento Easyship non è attivo, quindi non è possibile elaborare le richieste dal tuo account. Riattiva il piano o aggiorna il metodo di pagamento nella Dashboard Easyship, quindi riprova. Non è necessario effettuare nuovamente la connessione.