Guida al connettore8 minuti di lettura16 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 8 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 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 Meta Muse in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega UPS con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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 + 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.

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.

  1. 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.
  2. 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.
  3. 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.
  4. Copia il Client ID in UPS_CLIENT_ID e il Client Secret in UPS_CLIENT_SECRET.
  5. 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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

  1. In Muse apri Settings → Connectors e scegli Add custom connector.
  2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
  4. In una chat, chiedi a Muse qualcosa che richiede i tool di UPS.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Strumenti disponibili

StrumentoCosa fa
ups_track_packageTraccia 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_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 rispetto ai dati UPS. Restituisce ValidAddressIndicator, AmbiguousAddressIndicator…
ups_get_ratePrezzo di 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: punti di accesso UPS, The UPS Store, centri clienti e cassette postali. Restituisce…
ups_quote_landed_costStima dazi, tasse e spese di intermediazione per una spedizione internazionale prima della spedizione (UPS Landed Cost Quote). 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_ratePreventivo per 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 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.

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

Questa guida ti è stata utile?

Collega UPS a Meta Muse in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega UPS con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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

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.