Guida al connettore6 minuti di lettura16 tool MCP7 lingue

UPS MCP Server: tracking, tariffe e sedi

API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi negli Stati Uniti, 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.

HCA cura del team HelpCodeAggiornato 6 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

UPS

UPS

UPS APIs for shippers: track packages by tracking number or reference, validate US addresses, compare rates and transit times, find drop-off and Access Point locations, estimate landed cost, recover labels and quote pickups. Shipment creation, voids and pickups are included but switched off. OAuth client ID and secret from the UPS Developer Portal.

tool

16

Regione

INTL

Categoria

Logistica

Autenticazione

OAuth 2.0

Env vars richieste

UPS_CLIENT_IDUPS_CLIENT_SECRETUPS_ACCOUNT_NUMBER
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi negli Stati Uniti, 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 Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega UPS con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

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.

UPS · live via MCP
Condividi
Opus 4.7

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

API UPS per spedizionieri: traccia pacchi tramite numero di tracciamento o riferimento, valida indirizzi negli Stati Uniti, 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

La configurazione richiede circa 10 minuti.

  1. Accedi a https://developer.ups.com con il profilo ups.com che possiede il tuo account spedizioni (registrane uno prima se necessario) e apri la pagina per creare un'applicazione.
  2. Dì che vuoi integrare la tecnologia UPS nella tua attività, scegli il numero di account UPS a cui l'app dovrebbe fatturare e dai un nome all'app.
  3. Aggiungi i prodotti utilizzati dal connettore: Tracciamento, Validazione Indirizzi, Valutazione, Tempo di Transito, Localizzatore, e, per gli strumenti disattivati, Spedizione, Ritiro e Preventivo Costo Totale. Un prodotto mancante restituisce errori 401 o 403 solo per i suoi strumenti.
  4. Copia il Client ID in UPS_CLIENT_ID e il Client Secret in UPS_CLIENT_SECRET.
  5. Inserisci il tuo numero di account UPS di 6 caratteri (numero spedizioniere) 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 è utilizzato.

Da 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 valuta un servizio; ups_get_time_in_transit fornisce 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 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, le più recenti per prime.

Indirizzi e localizzazioni: ups_validate_address copre solo indirizzi stradali negli Stati Uniti e a Porto Rico. ups_find_locations trova luoghi di consegna e localizzazioni UPS Access Point vicino a un indirizzo in qualsiasi paese servito da UPS.

Tariffe: ups_shop_rates e ups_get_rate inviano il tuo numero di account come numero spedizioniere. 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 all'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 valutazione chiamano l'imballaggio PackagingType, lo strumento di spedizione Packaging.

Ritiri: ups_get_pickup_rate quota 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 dati per il numero ancora (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.

Prerequisiti: UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER

Installa il connettore localmente

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

Apri http://localhost:3000/connectors/store, scegli UPS e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

StrumentoCosa fa
ups_track_packageTraccia un pacco UPS tramite numero di tracciamento: stato attuale con codice e descrizione, ogni scansione (data come YYYYMMDD, ora locale come HHMMSS…
ups_track_by_referenceTrova 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_packagesTraccia 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_addressControlla un indirizzo stradale negli Stati Uniti o a Porto Rico contro i dati UPS. Restituisce ValidAddressIndicator, AmbiguousAddressIndicator…
ups_get_rateValuta un servizio UPS per una spedizione. Restituisce RateResponse.RatedShipment con il codice del servizio, peso di fatturazione, trasporto, servizio…
ups_shop_ratesConfronta ogni servizio UPS disponibile tra due indirizzi per una spedizione. Restituisce un RatedShipment per servizio con il suo codice, fatturazione…
ups_get_time_in_transitElenca i servizi UPS disponibili tra due luoghi sotto emsResponse.services: serviceLevel e serviceLevelDescription…
ups_find_locationsTrova luoghi di consegna UPS vicino a un indirizzo: localizzazioni UPS Access Point, The UPS Store, centri clienti e cassette postali. Restituisce…
ups_quote_landed_costStima dazi, tasse e spese di intermediazione per una spedizione internazionale prima che venga spedita (Preventivo Costo Totale UPS). Restituisce per merce il…
ups_recover_labelOttieni nuovamente l'etichetta di una spedizione che esiste già, tramite numero di tracciamento. Restituisce LabelRecoveryResponse.LabelResults con l'etichetta come…
ups_get_pickup_rateQuota quanto costerebbe un ritiro UPS su chiamata a un indirizzo, senza prenotarlo. Restituisce PickupRateResponse.RateResult con il tipo di tariffa…
ups_get_pending_pickupsElenca i ritiri prenotati sul tuo account UPS che non sono ancora avvenuti. Restituisce PickupPendingStatusResponse.PendingStatus con il ritiro…
ups_create_shipmentCrea 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_shipmentAnnulla (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_pickupPrenota 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_pickupAnnulla 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 richieste

  • "Dove si trova il pacco UPS 1Z999AA10123456784?"
  • "Confronta le tariffe UPS da Chicago 60601 a Austin 78701 per una scatola da 5 libbre."
  • "1600 Amphitheatre Pkwy, Mountain View, CA 94043 è un indirizzo valido?"
  • "Quando arriverebbe un pacco UPS Ground da Atlanta a Seattle se spedito oggi?"
  • "Trova localizzazioni UPS Access Point vicino a 10115 Berlino."

Prossimi passi

Questa guida ti è stata utile?

Collega UPS a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega UPS con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare UPS MCP a 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.

Connettori

Collegare UPS MCP a Claude

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.

Connettori

Collegare UPS MCP a Microsoft Copilot

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.

Connettori

Collegare UPS MCP a Cursor

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.

Connettori

Collegare UPS MCP a Gemini CLI

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.

Connettori

Collegare UPS MCP a Meta Muse

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.