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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Ukrposhta con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Ukrposhta. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?