In breve
API di Ukrposhta (Укрпошта) per clienti aziendali in Ucraina: tracciamento delle spedizioni, spedizioni e etichette PDF, stime dei prezzi nazionali, controlli delle rotte, clienti e indirizzi, e il classificatore degli indirizzi con uffici postali e orari di apertura. Creazione e cancellazione delle spedizioni installate disattivate. Portatori di contratto e token della controparte.
Configurazione guidata
Collega Ukrposhta a Cursor in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Ukrposhta con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 Ukrposhta
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 → Ukrposhta, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Ukrposhta + Cursor
API di Ukrposhta (Укрпошта) per clienti aziendali in Ucraina: tracciamento delle spedizioni, spedizioni e etichette PDF, stime dei prezzi nazionali, controlli delle rotte, clienti e indirizzi, e il classificatore degli indirizzi con uffici postali e orari di apertura. Creazione e cancellazione delle spedizioni installate disattivate. Portatori di contratto e token della controparte.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN
Passo 1 — Ottieni le credenziali
- Firma un contratto per l'API con Ukrposhta (servizio clienti aziendali, [email protected]). Con il contratto ricevi un allegato con le tue chiavi di produzione.
- Copia PRODUCTION BEARER eCom in
UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking inUKRPOSHTA_TRACKING_BEARERe PROD_COUNTERPARTY TOKEN inUKRPOSHTA_COUNTERPARTY_TOKEN.
Le chiavi sandbox (SANDBOX ...) non funzionano qui: questo connettore chiama l'host di produzione. Il portatore eCom apre anche il classificatore degli indirizzi e il servizio etichette; il tracciamento ha il proprio portatore; il token della controparte identifica il tuo account nelle chiamate riguardanti i tuoi clienti e le spedizioni.
Dove iniziare: ukrposhta_track_shipment o ukrposhta_get_last_status con un codice a barre. Per le spedizioni del tuo account, ukrposhta_get_shipment_by_barcode o ukrposhta_list_sender_shipments con l'uuid del cliente mittente.
Tracciamento: ukrposhta_track_shipment (tutti gli eventi), ukrposhta_get_last_status, ukrposhta_get_last_statuses (fino a 50 codici a barre) e ukrposhta_get_shipment_route. Passa lang en per i nomi degli eventi in inglese.
Spedizioni: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments, e ukrposhta_get_label (PDF). Prima della spedizione, ukrposhta_check_route e ukrposhta_calculate_domestic_price (UAH, senza gli sconti del tuo contratto).
Creazione di una spedizione segue l'ordine di Ukrposhta: ukrposhta_create_address per mittente e destinatario, ukrposhta_create_client per ciascuno (o riutilizzali: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), poi ukrposhta_create_shipment, poi l'etichetta. ukrposhta_create_shipment e ukrposhta_delete_shipment sono installati disattivati: una spedizione creata viene addebitata una volta consegnata, e una cancellata non può essere ripristinata. Indirizzi e clienti non costano nulla.
Classificatore degli indirizzi: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode, e per gli uffici postali ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near e ukrposhta_get_post_office_hours. Le risposte arrivano come elenchi Entries.Entry con nomi di campo in maiuscolo; gli id sono stringhe.
Unità e insidie: peso in grammi, dimensioni in cm, denaro in UAH. Tipi di consegna: W2W da ufficio postale a ufficio postale, W2D a domicilio, D2W e D2D da casa. Un codice postale contrassegnato come RESTRICTED_ACCESS può essere solo un indirizzo di mittente o di ritorno. Stati: CREATED (non ancora consegnato), REGISTERED, DELIVERING, IN_DEPARTMENT (in attesa presso l'ufficio), DELIVERED, RETURNING, RETURNED, CANCELLED, DELETED. Gli orari sono l'ora locale di Kyiv.
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 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 mostraYOUR_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" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
Ukrposhta.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
ukrposhta_track_shipment | Storia completa dello stato di una spedizione tramite codice a barre: per ogni evento, data, indice e nome dell'ufficio postale, codice evento e eventName (es.… |
ukrposhta_get_last_status | L'ultimo stato di una spedizione tramite codice a barre: data, indice e nome dell'ufficio postale, codice evento, eventName e eventReason. Solo lettura |
ukrposhta_get_last_statuses | L'ultimo stato di fino a 50 spedizioni contemporaneamente, più i codici a barre che Ukrposhta non conosce: per codice a barre data, ufficio postale, codice evento e… |
ukrposhta_get_shipment_route | Da dove e verso dove viaggia una spedizione (paese e località) tramite codice a barre. Solo lettura |
ukrposhta_get_shipment | Leggi una spedizione del tuo account tramite uuid: codice a barre, tipo, clienti mittenti e destinatari con indirizzi, deliveryType, pacchi (peso… |
ukrposhta_get_shipment_by_barcode | Leggi una spedizione del tuo account tramite il suo codice a barre (stessi campi di ukrposhta_get_shipment). Solo lettura |
ukrposhta_list_sender_shipments | Elenca le spedizioni create per un cliente mittente: uuid, codice a barre, destinatario, deliveryType, pacchi, prezzi e stato del ciclo di vita. Solo lettura |
ukrposhta_get_shipment_lifecycle | Stato attuale di una spedizione dal lato eCom: shipmentUuid, shipmentBarcode, stato (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | Elenca i gruppi di spedizioni (registri per il modulo 103a) di un cliente: uuid, nome, tipo, data di creazione, flag chiuso e numero di spedizioni.… |
ukrposhta_list_group_shipments | Elenca le spedizioni in un gruppo di spedizioni: uuid, codice a barre, destinatario, pacchi, prezzi e stato del ciclo di vita. Solo lettura |
ukrposhta_get_label | Scarica l'etichetta dell'indirizzo (adesivo) di una spedizione che hai creato, come file PDF: 100 x 100 mm per impostazione predefinita, o su un foglio A4 o A5. La stampa di un… |
ukrposhta_calculate_domestic_price | Stima il prezzo di una spedizione all'interno dell'Ucraina prima di crearla: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice… |
ukrposhta_check_route | Controlla che Ukrposhta consegni tra due codici postali: codice (SUCCESS quando disponibile), descrizione e mrtps (dove si trova l'ufficio postale mobile di… |
ukrposhta_get_client | Leggi un cliente (mittente o destinatario) del tuo account: uuid, tipo (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), nome, firstName, lastName… |
ukrposhta_find_clients_by_phone | Trova i clienti del tuo account con un numero di telefono: uuid, nome, tipo, indirizzi. Solo lettura |
ukrposhta_get_address | Leggi un indirizzo creato con ukrposhta_create_address: id, codice postale, regione, distretto, città, strada, numero civico, numero appartamento, paese… |
ukrposhta_create_address | Crea un indirizzo da utilizzare per un cliente o una spedizione. Solo il codice postale è obbligatorio; aggiungi strada e numero civico per la consegna a domicilio. Gratuito; le risposte… |
ukrposhta_create_client | Crea un cliente (mittente o destinatario) su un indirizzo da ukrposhta_create_address. Le persone fisiche e gli imprenditori privati hanno bisogno di first_name… |
ukrposhta_create_shipment | Crea una spedizione nazionale da un cliente mittente a un cliente destinatario. Ottiene un codice a barre e un prezzo, e viene addebitata una volta consegnata all'… |
ukrposhta_delete_shipment | Cancella una spedizione che è ancora in stato CREATED (non ancora consegnata). Non può essere annullata. Installato disattivato |
ukrposhta_find_post_offices_by_postcode | Uffici postali che servono un codice postale: ID, PO_SHORT e PO_LONG (nome), INDIRIZZO, TELEFONO, TYPE_LONG, LATITUDE, LONGITUDE, POSTTERMINAL… |
ukrposhta_find_post_offices_near | Uffici postali vicino a un punto, più vicini per primi: ID, nome, indirizzo, codice postale, distanza, coordinate e tipo. Solo lettura |
ukrposhta_get_post_office_hours | Orari di apertura di un ufficio postale per codice postale: per giorno della settimana l'orario di apertura e chiusura e le pause. Solo lettura |
ukrposhta_get_city_by_postcode | La località, il distretto e la regione di un codice postale, con i loro id. Solo lettura |
ukrposhta_search_regions | Trova regioni (oblast) per parte del nome, in ucraino o inglese: REGION_ID, REGION_UA, REGION_EN, codici KOATUU e KATOTTG. Lascia entrambi… |
ukrposhta_search_districts | Trova distretti di una regione per nome: DISTRICT_ID, nomi in UA e EN, regione. Solo lettura |
ukrposhta_search_cities | Trova località per nome, eventualmente all'interno di una regione e distretto: CITY_ID, nomi in UA e EN, tipo (città, villaggio), distretto, regione e… |
ukrposhta_search_streets | Trova strade di una località per nome: STREET_ID, nomi in UA e EN, tipo di strada. Solo lettura |
ukrposhta_get_house_postcode | Il codice postale di una casa su una strada: numero civico e POSTCODE. Solo lettura |
Esempi di prompt
- "Dove si trova il pacco Ukrposhta 0503112345678?"
- "Mostra l'ultimo stato di questi 10 codici a barre della spedizione di ieri."
- "Quanto costa un pacco di 2 kg da Kyiv 01001 a Lviv 79000?"
- "Quali uffici postali sono vicino al codice postale 65000, e quando sono aperti sabato?"
- "Scarica l'etichetta della spedizione 0503112345678."
FAQ
Da dove provengono le chiavi? Solo da un contratto aziendale: Ukrposhta invia il portatore eCom di produzione, il portatore StatusTracking e il token della controparte in un allegato al tuo contratto API. Le chiavi sandbox non funzionano qui.
Cosa copre? Tracciamento, le tue spedizioni e gruppi, etichette PDF, stime dei prezzi nazionali, controlli delle rotte, clienti e indirizzi, e il classificatore degli indirizzi con regioni, località, strade, codici postali e uffici postali con orari di apertura.
Quali strumenti sono installati disattivati? ukrposhta_create_shipment e ukrposhta_delete_shipment. Attivali nella pagina del connettore solo se l'IA deve creare o cancellare spedizioni.
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?