In breve
API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi statunitensi, confronta tariffe e tempi di transito, trova luoghi di consegna e punti di accesso, stima il costo totale, recupera etichette e richiedi ritiri. La creazione di spedizioni, le annullazioni e i ritiri sono inclusi ma disattivati. ID client OAuth e segreto dal Portale Sviluppatori UPS.
Configurazione guidata
Collega UPS a ChatGPT in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega UPS con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.
Prova a chiedere
Prompt di esempio per UPS
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → UPS, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
UPS + ChatGPT
API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi statunitensi, confronta tariffe e tempi di transito, trova luoghi di consegna e punti di accesso, stima il costo totale, recupera etichette e richiedi ritiri. La creazione di spedizioni, le annullazioni e i ritiri sono inclusi ma disattivati. ID client OAuth e segreto dal Portale Sviluppatori UPS.
Requisiti
Consulta le istruzioni complete di configurazione incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti.
- Accedi a https://developer.ups.com con il profilo ups.com che possiede il tuo account di spedizione (registrane uno prima se necessario) e apri la pagina per creare un'applicazione.
- Dichiara che desideri integrare la tecnologia UPS nel tuo business, scegli il numero di conto UPS a cui l'app dovrebbe fatturare e dai un nome all'app.
- Aggiungi i prodotti utilizzati dal connettore: Tracking, Address Validation, Rating, Time in Transit, Locator, e, per gli strumenti disattivati, Shipping, Pickup e Landed Cost Quote. Un prodotto mancante restituisce 401 o 403 solo per i suoi strumenti.
- Copia il Client ID in
UPS_CLIENT_IDe il Client Secret inUPS_CLIENT_SECRET. - Inserisci il tuo numero di conto UPS a 6 caratteri (numero di spedizione) in
UPS_ACCOUNT_NUMBER.
Il connettore scambia l'ID client e il segreto a https://onlinetools.ups.com/security/v1/oauth/token (credenziali client, HTTP Basic) per un token bearer a breve termine e lo rinnova autonomamente. Queste sono credenziali di produzione; il sistema di test UPS (wwwcie.ups.com) non viene utilizzato.
Dove iniziare: ups_track_package con un numero di tracciamento. Per un prezzo, ups_shop_rates confronta tutti i servizi tra due indirizzi e ups_get_rate calcola il prezzo di un servizio; ups_get_time_in_transit fornisce le date di consegna senza prezzi.
Tracciamento: ups_track_package (qualsiasi numero di tracciamento), ups_track_by_reference (il tuo riferimento, ad esempio un numero d'ordine, all'interno del tuo account) e ups_track_shipment_packages (tutti i pacchi di una spedizione multipla). Le date sono nel formato YYYYMMDD e gli orari HHMMSS nell'ora locale della scansione; gmtDate, gmtTime e gmtOffset forniscono lo stesso momento in UTC. Leggi lo stato da currentStatus.description e le scansioni da activity, dalla più recente alla più vecchia.
Indirizzi e luoghi: ups_validate_address copre solo gli indirizzi stradali negli Stati Uniti e a Porto Rico. ups_find_locations trova luoghi di consegna e punti di accesso UPS vicino a un indirizzo in qualsiasi paese servito da UPS.
Tariffe: ups_shop_rates e ups_get_rate inviano il tuo numero di conto come numero di spedizione. Le tariffe pubblicate tornano per impostazione predefinita; passa rating_options con NegotiatedRatesIndicator per vedere le tariffe contrattuali del tuo account in NegotiatedRateCharges. Gli importi sono stringhe nella valuta indicata accanto a loro. I pesi sono in LBS o KGS e le dimensioni in IN o CM: usa le unità del paese di origine. ups_quote_landed_cost stima dazi e tasse per una spedizione transfrontaliera e funziona meglio con un codice HS per articolo.
Etichette e spedizioni: ups_recover_label restituisce nuovamente l'etichetta di una spedizione esistente e non costa nulla. ups_create_shipment crea una spedizione che UPS fattura al tuo account, e ups_void_shipment annulla una spedizione prima del ritiro; entrambi sono installati disattivati. Attivali nel connettore solo se l'assistente deve creare spedizioni reali. I nomi dei campi UPS differiscono tra le chiamate: gli strumenti di tariffazione chiamano l'imballaggio PackagingType, lo strumento di spedizione Packaging.
Ritiri: ups_get_pickup_rate fornisce un preventivo per un ritiro su chiamata e ups_get_pending_pickups elenca quelli prenotati. ups_create_pickup prenota un autista per una tariffa e ups_cancel_pickup annulla tramite PRN; entrambi sono installati disattivati.
Errori: UPS risponde con response.errors, un elenco di code e message. 401 significa che le credenziali o il token sono stati rifiutati, 403 che l'app non ha accesso a quel prodotto o che UPS ha bloccato l'account, 404 su tracciamento che UPS non ha ancora dati per il numero (le etichette appaiono dopo la prima scansione o alcune ore dopo la creazione), 429 che la quota dell'app è esaurita.
Limiti: UPS imposta una quota per app e prodotto e non pubblica i numeri nei suoi file API; un 429 significa attendere e riprovare più tardi. Tracciare un numero per chiamata è l'uso documentato: non fare loop su lunghe liste rapidamente.
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 ChatGPT
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 mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
UPS. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
ups_track_package | Traccia un pacco UPS tramite numero di tracciamento: stato attuale con codice e descrizione, ogni scansione (data nel formato YYYYMMDD, ora locale nel formato HHMMSS… |
ups_track_by_reference | Trova e traccia spedizioni del tuo account UPS tramite un numero di riferimento che hai messo sulla spedizione (numero d'ordine, numero di fattura). Restituisce lo stesso… |
ups_track_shipment_packages | Traccia ogni pacco di una spedizione multipla UPS da uno dei suoi numeri di tracciamento: per pacco il numero di tracciamento, stato attuale, ultima… |
ups_validate_address | Controlla un indirizzo stradale negli Stati Uniti o a Porto Rico rispetto ai dati UPS. Restituisce ValidAddressIndicator, AmbiguousAddressIndicator… |
ups_get_rate | Prezzo di un servizio UPS per una spedizione. Restituisce RateResponse.RatedShipment con il codice del servizio, peso di fatturazione, trasporto, servizio… |
ups_shop_rates | Confronta ogni servizio UPS disponibile tra due indirizzi per una spedizione. Restituisce un RatedShipment per servizio con il suo codice, fatturazione… |
ups_get_time_in_transit | Elenca i servizi UPS disponibili tra due luoghi sotto emsResponse.services: serviceLevel e serviceLevelDescription… |
ups_find_locations | Trova luoghi di consegna UPS vicino a un indirizzo: punti di accesso UPS, The UPS Store, centri clienti e cassette postali. Restituisce… |
ups_quote_landed_cost | Stima dazi, tasse e spese di intermediazione per una spedizione internazionale prima della spedizione (UPS Landed Cost Quote). Restituisce per merce il… |
ups_recover_label | Ottieni nuovamente l'etichetta di una spedizione che esiste già, tramite numero di tracciamento. Restituisce LabelRecoveryResponse.LabelResults con l'etichetta come… |
ups_get_pickup_rate | Preventivo per un ritiro UPS su chiamata a un indirizzo, senza prenotarlo. Restituisce PickupRateResponse.RateResult con il tipo di tariffa… |
ups_get_pending_pickups | Elenca i ritiri prenotati sul tuo account UPS che non sono ancora avvenuti. Restituisce PickupPendingStatusResponse.PendingStatus con il ritiro… |
ups_create_shipment | Crea una spedizione UPS e la sua etichetta. UPS fattura la spedizione al tuo account non appena questa chiamata ha successo, quindi lo strumento è installato… |
ups_void_shipment | Annulla (cancella) una spedizione UPS che è stata creata ma non ancora ritirata, o pacchi singoli di essa. Non può essere annullato: le etichette diventano… |
ups_create_pickup | Prenota un ritiro UPS su chiamata: un autista viene all'indirizzo nel giorno indicato. UPS addebita una tariffa di ritiro al tuo account, quindi lo strumento è… |
ups_cancel_pickup | Annulla un ritiro UPS prenotato tramite il suo numero di richiesta di ritiro (PRN). Non può essere annullato; deve essere prenotato un nuovo ritiro. Restituisce… |
Esempi di prompt
- "Dove si trova il pacco UPS 1Z999AA10123456784?"
- "Confronta le tariffe UPS da Chicago 60601 a Austin 78701 per una scatola da 5 lb."
- "È 1600 Amphitheatre Pkwy, Mountain View, CA 94043 un indirizzo valido?"
- "Quando arriverà un pacco UPS Ground da Atlanta a Seattle se spedito oggi?"
- "Trova i punti di accesso UPS vicino a 10115 Berlino."
FAQ
Da dove provengono le credenziali UPS? Da un'app nel Portale Sviluppatori UPS (developer.ups.com), creata con il profilo ups.com che possiede il tuo account di spedizione. Aggiungi i prodotti Tracking, Address Validation, Rating, Time in Transit e Locator, poi copia il Client ID e il Client Secret. UPS_ACCOUNT_NUMBER è il tuo numero di spedizione a 6 caratteri.
Cosa copre e cosa no? Tracciamento per numero o riferimento, validazione degli indirizzi statunitensi (solo Stati Uniti e Porto Rico), tariffe e tempi di transito, luoghi di consegna e punti di accesso, stime dei costi totali, recupero etichette e preventivi per ritiri. Utilizza credenziali di produzione, non il sistema di test UPS.
Può creare spedizioni o prenotare ritiri? ups_create_shipment, ups_void_shipment, ups_create_pickup e ups_cancel_pickup sono installati disattivati, perché costano denaro. Aggiungi i prodotti Shipping e Pickup alla tua app e attivali nella pagina del connettore solo se l'AI deve usarli.
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
Questa guida ti è stata utile?