Come collegare Shippo a Cursor via MCP

💡 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 + Cursor

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SHIPPO_API_TOKEN

Step 1 — Ottieni le credenziali

1. 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.
2. 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 con shippo_live_.
3. Inserisci la chiave in SHIPPO_API_TOKEN esattamente come appare, senza la parola ShippoToken, poi installa il connettore.
4. 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 che shippo_get_tracking si 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.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Shippo.

Tool disponibili

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."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse