Come collegare ChatGPT e l'API OpenAI al server MCP di Easyship

Questo articolo spiega come usare Easyship con OpenAI per gestire le attività di spedizione, tra cui confrontare le tariffe, creare spedizioni, acquistare etichette, programmare ritiri e monitorare le consegne, tutto tramite il linguaggio naturale.

Opzione Ideale per Come effettuare la connessione?
Parte 1: plugin Easyship per ChatGPT Chiunque voglia effettuare spedizioni da una chat ChatGPT, senza bisogno di codice Accedi a Easyship e autorizza (OAuth). Non è necessario alcun token API.
Parte 2: API Responses di OpenAI o SDK Agents Sviluppatori che creano i propri agenti o le proprie app AI con OpenAI Token API Easyship

Parte 1: utilizzo del plugin Easyship con ChatGPT

Prima di iniziare

Ti serviranno:

  • Un account ChatGPT su chatgpt.com

  • Un account Easyship attivo

Per questa opzione non è necessario un token API Easyship.

Passaggio 1: installa il plugin Easyship

  1. Accedi a ChatGPT

  2. Vai a Plugin

  3. Cerca Easyship

  4. Fai clic su Installa plugin

 

Passaggio 2: autorizza Easyship

  1. Al termine dell'installazione, fai clic su Connetti

  2. Verrai reindirizzato a Easyship per effettuare l'accesso. Accedi al tuo account Easyship se non l'hai già fatto

  3. Esamina le autorizzazioni richieste e fai clic su Autorizza

  4. Tornerai a ChatGPT e il plugin Easyship verrà visualizzato come Connesso

Attenzione: non esiste un ambiente di test separato per le azioni MCP. Qualsiasi azione che consuma crediti, come la generazione di etichette, comporterà addebiti reali.

Passaggio 3: inizia a usare Easyship in una chat

  1. Apri una nuova chat in ChatGPT

  2. Digita @easyship e seleziona Easyship - Shipping MCP dal menu a discesa

  3. Digita il tuo prompt per iniziare

Prova un prompt come questo:

Voglio spedire un pacco da New York, USA a Toronto, Canada. Origine: 350 5th Avenue, New York, US 10001. Destinazione: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Pacco: 1,98 lb, 6 × 4 × 2 cm. Articolo: documenti aziendali, quantità 1, HS Code 4911.99, valore dichiarato $1.00 USD, categoria documenti, DDU. Mostrami le opzioni di spedizione più economiche e con il miglior rapporto qualità-prezzo, indicando i tempi di consegna e i nomi dei corrieri.

Parte 2: utilizzo di Easyship MCP con l'API Responses di OpenAI o l'SDK Agents

Prima di iniziare

Ti serviranno:

  • Accesso all'API Responses di OpenAI o all'SDK Agents
  • Accesso alla Dashboard Easyship
  • Un account Easyship (l'accesso API è disponibile in tutti i piani senza costi aggiuntivi)

Passaggio 1: ottieni il token API Easyship

  1. Vai alla tua Dashboard Easyship e fai clic su Connetti
  2. Fai clic su Nuova integrazione
  3. Scorri verso il basso fino a Integrazione API
  4. In Tipo di integrazione, seleziona Sto sviluppando un'integrazione personalizzata
  5. Assegna alla chiave il nome Easyship MCP per poterla identificare facilmente
  6. Mantieni la versione predefinita 2024-09 e fai clic su Connetti
  7. Nella pagina successiva, fai clic su Token di accesso e copialo usando il pulsante di copia

Ambiti obbligatori: il token API deve includere i seguenti ambiti. Se mancano alcuni ambiti, alcuni strumenti non funzioneranno, mentre altri continueranno a funzionare.

public.shipment:read              public.shipment:write
public.label:write                public.pickup:read
public.pickup:write               public.address_validation:write
public.address_validation_domestic:write
public.shipment_document:read     public.transaction_record:read
public.analytics:read             public.rate:read
public.track:read

Puoi controllare e aggiornare gli ambiti in qualsiasi momento in Dashboard → Connetti → API senza creare un nuovo token.

Passaggio 2: aggiungi il server MCP Easyship all'API Responses

Passa il server MCP Easyship come strumento nella chiamata responses.create(). Consulta la documentazione degli strumenti MCP di OpenAI per il riferimento completo.

python

from openai import OpenAI
client = OpenAI()


resp = client.responses.create(
    model="gpt-4.1",
    tools=[{
        "type": "mcp",
        "server_label": "easyship",
        "server_url": "https://mcp.easyship.com/mcp",
        "require_approval": "never",
        "headers": {
            "Authorization": "Bearer YOUR_EASYSHIP_TOKEN"
        }
    }],
    input="What are the cheapest shipping options from HK to NYC for a 1.5kg package?"
)


print(resp.output_text)

Sostituisci YOUR_EASYSHIP_TOKEN con il token API copiato nel passaggio 1.

Nota: require_approval: "never" indica al modello di chiamare automaticamente gli strumenti Easyship senza interrompersi per chiedere conferma. Impostalo su "always" se vuoi che il modello chieda l'approvazione prima di eseguire azioni come creare spedizioni o acquistare etichette.

Sicurezza: non inserire mai il token API direttamente nel codice sorgente e non condividerlo in una finestra di chat. Conservalo come variabile d'ambiente, ad esempio EASYSHIP_API_ACCESS_TOKEN, e fai riferimento a esso durante l'esecuzione. Se lo esponi accidentalmente, revoca e sostituisci immediatamente la chiave nella Dashboard Easyship in Connetti → API.

Passaggio 3: verifica la connessione

Esegui lo script. Se il server MCP Easyship è connesso correttamente, il modello chiamerà automaticamente gli strumenti Easyship e restituirà i risultati della spedizione in resp.output_text.

Se visualizzi un errore di connessione o autenticazione, controlla nuovamente il token e verifica che tutti gli ambiti obbligatori siano abilitati nella Dashboard Easyship.

Passaggio 4: provalo

Una volta effettuata la connessione, prova un prompt come questo:

Voglio spedire un pacco da New York, USA a Toronto, Canada. Origine: 350 5th Avenue, New York, US 10001. Destinazione: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Pacco: 1,98 lb, 6 × 4 × 2 cm. Articolo: documenti aziendali, quantità 1, HS Code 4911.99, valore dichiarato $1.00 USD, categoria documenti, DDU. Mostrami le opzioni di spedizione più economiche e con il miglior rapporto qualità-prezzo, indicando i tempi di consegna e i nomi dei corrieri.

Per un elenco completo degli strumenti e dei flussi di lavoro disponibili, consulta la documentazione per sviluppatori di Easyship MCP.

Interfaccia utente ChatGPT per consumatori — In arrivo

L'integrazione diretta con l'interfaccia utente ChatGPT per consumatori su chat.openai.com richiede il supporto OAuth. Questa funzionalità non è ancora disponibile per il server MCP Easyship. Quando il supporto OAuth sarà disponibile, gli utenti potranno collegare Easyship direttamente dall'interfaccia ChatGPT senza usare codice.

Domande frequenti

Posso usare un token API esistente oppure devo crearne uno nuovo? 

Puoi usare un token esistente del tuo account Easyship. Assicurati semplicemente che disponga di tutti gli ambiti obbligatori elencati nel passaggio 1. Se mancano alcuni ambiti, determinati strumenti non funzioneranno, mentre altri continueranno a funzionare.

Funziona con l'app ChatGPT o con chat.openai.com? 

Non ancora. L'integrazione con l'API Responses e l'SDK Agents è già disponibile per gli sviluppatori che creano applicazioni con OpenAI. L'interfaccia utente ChatGPT per consumatori richiede il supporto OAuth da parte del server MCP, che sarà disponibile prossimamente.

Cosa fa require_approval: "never"? 

Questa impostazione indica al modello OpenAI di chiamare automaticamente gli strumenti MCP Easyship senza interrompersi per chiedere l'approvazione dell'utente a ogni chiamata dello strumento. Impostala su "always" se vuoi che il modello chieda conferma prima di eseguire azioni come creare spedizioni o acquistare etichette.

Cosa succede se il modello non chiama gli strumenti Easyship? 

Controlla nuovamente il token e verifica che server_url sia https://mcp.easyship.com/mcp. Assicurati che il valore dell'intestazione Authorization inizi con Bearer (seguito da uno spazio) e prosegua con il token. Verifica inoltre che tutti gli ambiti obbligatori siano abilitati nella Dashboard Easyship.

Cosa succede se non vengono caricati tutti gli strumenti?

  • Verifica che il token API Easyship sia valido e attivo
  • Verifica che tutti gli ambiti obbligatori siano abilitati nella Dashboard Easyship
  • Controlla la connessione di rete della macchina che esegue lo script
  • Controlla la risposta dell'API OpenAI per individuare eventuali messaggi di errore relativi al server MCP

Perché il mio token API Easyship non funziona? 

Controlla gli ambiti del token nella Dashboard Easyship in Connetti → API. Un token potrebbe funzionare per alcune azioni ma non per altre, a seconda degli ambiti di cui dispone. Per ottenere l'accesso completo a tutti gli strumenti, abilita tutti gli ambiti elencati nel passaggio 1.

Cosa succede se non concedo tutti gli ambiti obbligatori? 

Funzioneranno solo gli strumenti corrispondenti agli ambiti concessi. Gli altri strumenti restituiranno un errore. Puoi aggiornare gli ambiti nella Dashboard Easyship senza creare un nuovo token.

Devo pagare per il token API Easyship? 

No. Easyship offre l'accesso API in tutti i piani senza costi aggiuntivi. Se superi i limiti API inclusi nel tuo piano, potrebbero essere applicati costi aggiuntivi. Consulta [piani tariffari e limiti inclusi].

Posso usare lo stesso token Easyship con altri client, come Claude o Cursor? 

Sì. Lo stesso token API Easyship funziona con qualsiasi client MCP. Presta attenzione ai limiti di frequenza ed evita di eseguire operazioni in conflitto, come modificare la stessa spedizione contemporaneamente da due client.

Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 0 su 0
Argomenti popolari