Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Shippo con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai gestire le spedizioni alla tua AI tramite Shippo: convalida indirizzi, confronta le tariffe in tempo reale dei tuoi corrieri, acquista e rimborsa etichette, traccia i pacchi, prepara i documenti doganali e crea scan form. La modalità di test è gratuita.
Prova a chiedere
Prompt di esempio per Shippo
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.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Shippo, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Shippo
Fai gestire le spedizioni alla tua AI tramite Shippo: convalida indirizzi, confronta le tariffe in tempo reale dei tuoi corrieri, acquista e rimborsa etichette, traccia i pacchi, prepara i documenti doganali e crea scan form. La modalità di test è gratuita.
Setup
- Registrati gratis su apps.goshippo.com/join, poi apri il portale API su portal.goshippo.com/api-config/api e vai in API Configuration → Developer keys.
- Clicca Create new test key per provare tutto gratis, oppure Create new live key per acquistare etichette vere. Copia subito la chiave: Shippo la mostra una sola volta. Le chiavi di test iniziano con
shippo_test_, quelle live conshippo_live_. - Inserisci la chiave in
SHIPPO_API_TOKENesattamente come appare, senza la parola ShippoToken, poi installa il connettore. - Inizia con
shippo_list_carrier_accounts: dovrebbe elencare gli account corriere di Shippo (per esempio USPS), pronti all'uso negli Stati Uniti, insieme ai nomi dei corrieri cheshippo_get_trackingsi aspetta.
Test o live: decide la chiave. Con una chiave di test le etichette sono gratuite e portano la filigrana "SAMPLE - DO NOT MAIL", i numeri di tracking non si aggiornano mai, i rimborsi riescono sempre e i manifest (scan form) non sono disponibili. Una chiave di test vede solo dati di test e una chiave live solo dati live. Gli account corriere che colleghi in Shippo con le tue credenziali del corriere funzionano solo nella modalità in cui sono stati aggiunti.
Acquistare un'etichetta costa: con una chiave live, shippo_buy_label addebita subito il prezzo dell'etichetta (più l'eventuale assicurazione) sul tuo account Shippo, perciò l'AI indica prima corriere, servizio, prezzo ed entrambi gli indirizzi e aspetta il tuo sì. shippo_create_shipment recupera solo le tariffe in tempo reale e non acquista nulla. Il link all'etichetta scade dopo un po'; shippo_get_label ne restituisce uno nuovo. shippo_request_refund annulla un'etichetta, che poi non si può più usare, e chiede al corriere la restituzione dell'importo. Valgono solo etichette non usate e con al massimo 90 giorni, e il rimborso richiede da qualche giorno a qualche settimana.
Permessi e solo lettura: una chiave può fare tutto ciò che può fare il tuo account Shippo. Per una configurazione che non spende mai soldi e non annulla etichette, disattiva shippo_buy_label, shippo_request_refund e shippo_create_manifest. L'AI può comunque convalidare indirizzi, confrontare tariffe, tracciare pacchi e consultare le etichette passate.
Spedizioni internazionali: richiedono una dichiarazione doganale. L'AI crea una riga per prodotto con shippo_create_customs_item (descrizione, quantità, peso netto, valore, paese d'origine, codice doganale), poi shippo_create_customs_declaration con una persona che certifica i dati, e la allega alla spedizione. Tieni a portata di mano codici doganali e valori dei tuoi prodotti.
Convalida degli indirizzi: shippo_validate_address salva l'indirizzo verificato e standardizzato (per esempio con il codice ZIP+4) come nuovo indirizzo e lascia l'originale com'era; le spedizioni vanno poi a quello nuovo. Con una chiave di test gli indirizzi fuori dagli Stati Uniti tornano indietro senza verifica; con una chiave live la loro convalida è a pagamento.
Limiti: al minuto Shippo consente 500 creazioni e 4.000 letture di singoli oggetti, ma solo 50 chiamate di elenco (10 con una chiave di test). Oltre un limite Shippo risponde 429: attendi un minuto e riprova.
Errori comuni: 401 Token does not exist significa che la chiave è sbagliata o è stata eliminata: creane una nuova in API Configuration → Developer keys e inseriscila senza la parola ShippoToken. 400 indica il campo mancante o non valido, per esempio un indirizzo che il corriere rifiuta. 422, o un'etichetta con stato ERROR, significa che il corriere ha rifiutato, per esempio perché il servizio non copre quella tratta o mancano i dati doganali; i messaggi spiegano il motivo. Un'etichetta o un rimborso con stato QUEUED o WAITING è ancora in lavorazione: richiedilo di nuovo dopo qualche secondo.
Il connettore non gestisce batch, ordini, ritiri, webhook diversi dalla registrazione del tracking né il collegamento dei tuoi account corriere.
Prerequisiti: SHIPPO_API_TOKEN
Installazione locale del connettore
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 Shippo e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
shippo_create_address | Save an address, optionally validated |
shippo_get_address | Read a saved address by object_id, with its fields, completeness and any validation results |
shippo_validate_address | Validate a saved address |
shippo_list_addresses | List saved addresses, newest first, with next and previous page links |
shippo_create_parcel | Save a parcel (dimensions and weight, or a carrier parcel template plus weight) |
shippo_get_parcel | Read a saved parcel by object_id: dimensions, weight, units and template |
shippo_list_parcel_templates | List carrier parcel templates (flat rate boxes and envelopes): token, name, carrier and dimensions |
shippo_create_shipment | Create a shipment and get live rates from the account's carriers |
shippo_get_shipment | Read a shipment with its addresses, parcels, rates and messages |
shippo_list_shipments | List shipments, newest first, with status and addresses (Shippo keeps the last 390 days) |
shippo_list_shipment_rates | List the rates of a shipment again (the same rates[] shippo_create_shipment returned), with paging |
shippo_get_rate | Read one rate: amount, currency, provider, service level, estimated days, duration terms and zone |
shippo_buy_label | Buy a shipping label for a rate |
shippo_list_labels | List purchased labels (transactions), newest first, with status, tracking number and tracking status |
shippo_get_label | Read one purchased label (transaction): status, tracking number and status, ETA, a fresh label_url and commercial invoice URL, and messages |
shippo_get_tracking | Read the tracking status and history of a parcel by carrier and tracking number, for labels bought anywhere |
shippo_register_tracking | Register a tracking number for status updates, which Shippo then sends to the account's "track updated" webhook (set up in the Shippo… |
shippo_list_carrier_accounts | List the carrier accounts usable for rates and labels: object_id, carrier, account_id, active, whether it is a Shippo-provided account, and… |
shippo_get_carrier_account | Read one carrier account by object_id: carrier, account number, active flag and parameters |
shippo_create_customs_item | Create a customs item (one line of a customs declaration) |
shippo_get_customs_item | Read a customs item by object_id: description, quantity, weight, value, origin and tariff number |
shippo_create_customs_declaration | Create a customs declaration for an international shipment from customs items |
shippo_get_customs_declaration | Read a customs declaration by object_id, with its items, contents type, incoterm and signer |
shippo_list_customs_declarations | List customs declarations, newest first, with contents type, items and certification details |
shippo_request_refund | Void a purchased label and ask for its price back |
shippo_list_refunds | List label refunds with their status (QUEUED, PENDING, SUCCESS, ERROR) and the label they belong to |
shippo_get_refund | Read one label refund by object_id: status, label (transaction) and dates |
shippo_create_manifest | Create a manifest (scan form) for a carrier pickup: one document listing the labels of one carrier account, ship date and origin address |
shippo_list_manifests | List manifests (scan forms), newest first, with carrier account, ship date, status and documents |
shippo_get_manifest | Read one manifest (scan form) with its status, the labels on it, document URLs and errors |
Esempi di prompt
- "Confronta le tariffe UPS e USPS per un pacco da 2 kg (30 x 20 x 15 cm) dal nostro indirizzo di magazzino salvato a 350 5th Ave, New York, NY 10118, e mostrami l'opzione più economica e quella più veloce."
- "Dov'è adesso il pacco con numero di tracking USPS 9400111899223197428490 e quando dovrebbe arrivare?"
- "Acquista l'etichetta USPS più economica per l'ordine di Acme Ltd diretto a 233 S Wacker Dr, Chicago, IL 60606, e dammi il numero di tracking e il link all'etichetta."
- "Prepara i documenti doganali per 3 tazze in ceramica dal valore totale di 45 USD per un cliente a Toronto, in Canada, poi mostrami le tariffe disponibili."
Prossimi passi
Questa guida ti è stata utile?
