Guida al connettore8 minuti di lettura29 tool MCP7 lingue

Collegare Ukrposhta a ChatGPT via MCP

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.

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

Ukrposhta

Ukrposhta

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

tool

29

Regione

INTL

Categoria

Logistica

Autenticazione

API credentials

Env vars richieste

UKRPOSHTA_ECOM_BEARERUKRPOSHTA_TRACKING_BEARERUKRPOSHTA_COUNTERPARTY_TOKEN
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 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 ChatGPT in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Ukrposhta con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.

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.

Ukrposhta · 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 → Ukrposhta, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Ukrposhta + ChatGPT

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

  1. 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.
  2. Copia PRODUCTION BEARER eCom in UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking in UKRPOSHTA_TRACKING_BEARER e PROD_COUNTERPARTY TOKEN in UKRPOSHTA_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 ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

  1. Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
  2. Inserisci un nome, ad esempio Name: Ukrposhta.
  3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
  4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
  5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Strumenti disponibili

StrumentoCosa fa
ukrposhta_track_shipmentStoria 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_statusL'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_statusesL'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_routeDa dove e verso dove viaggia una spedizione (paese e località) tramite codice a barre. Solo lettura
ukrposhta_get_shipmentLeggi una spedizione del tuo account tramite uuid: codice a barre, tipo, clienti mittenti e destinatari con indirizzi, deliveryType, pacchi (peso…
ukrposhta_get_shipment_by_barcodeLeggi una spedizione del tuo account tramite il suo codice a barre (stessi campi di ukrposhta_get_shipment). Solo lettura
ukrposhta_list_sender_shipmentsElenca 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_lifecycleStato attuale di una spedizione dal lato eCom: shipmentUuid, shipmentBarcode, stato (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT…
ukrposhta_list_shipment_groupsElenca 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_shipmentsElenca le spedizioni in un gruppo di spedizioni: uuid, codice a barre, destinatario, pacchi, prezzi e stato del ciclo di vita. Solo lettura
ukrposhta_get_labelScarica 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_priceStima il prezzo di una spedizione all'interno dell'Ucraina prima di crearla: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice…
ukrposhta_check_routeControlla che Ukrposhta consegni tra due codici postali: codice (SUCCESS quando disponibile), descrizione e mrtps (dove si trova l'ufficio postale mobile di…
ukrposhta_get_clientLeggi un cliente (mittente o destinatario) del tuo account: uuid, tipo (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), nome, firstName, lastName…
ukrposhta_find_clients_by_phoneTrova i clienti del tuo account con un numero di telefono: uuid, nome, tipo, indirizzi. Solo lettura
ukrposhta_get_addressLeggi un indirizzo creato con ukrposhta_create_address: id, codice postale, regione, distretto, città, strada, numero civico, numero appartamento, paese…
ukrposhta_create_addressCrea 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_clientCrea 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_shipmentCrea 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_shipmentCancella una spedizione che è ancora in stato CREATED (non ancora consegnata). Non può essere annullata. Installato disattivato
ukrposhta_find_post_offices_by_postcodeUffici postali che servono un codice postale: ID, PO_SHORT e PO_LONG (nome), INDIRIZZO, TELEFONO, TYPE_LONG, LATITUDE, LONGITUDE, POSTTERMINAL…
ukrposhta_find_post_offices_nearUffici postali vicino a un punto, più vicini per primi: ID, nome, indirizzo, codice postale, distanza, coordinate e tipo. Solo lettura
ukrposhta_get_post_office_hoursOrari 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_postcodeLa località, il distretto e la regione di un codice postale, con i loro id. Solo lettura
ukrposhta_search_regionsTrova regioni (oblast) per parte del nome, in ucraino o inglese: REGION_ID, REGION_UA, REGION_EN, codici KOATUU e KATOTTG. Lascia entrambi…
ukrposhta_search_districtsTrova distretti di una regione per nome: DISTRICT_ID, nomi in UA e EN, regione. Solo lettura
ukrposhta_search_citiesTrova 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_streetsTrova strade di una località per nome: STREET_ID, nomi in UA e EN, tipo di strada. Solo lettura
ukrposhta_get_house_postcodeIl 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.

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

Questa guida ti è stata utile?

Collega Ukrposhta a ChatGPT in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Ukrposhta con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Ukrposhta a Claude via MCP

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.

Connettori

Collegare Ukrposhta a Microsoft Copilot via MCP

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.

Connettori

Collegare Ukrposhta a Cursor via MCP

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.

Connettori

Collegare Ukrposhta a Gemini CLI via MCP

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.

Connettori

Collegare Ukrposhta a Meta Muse via MCP

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.

Connettori

Ukrposhta MCP: tracking, tariffe e uffici postali

API di Ukrposhta (Укрпошта) per clienti aziendali in Ucraina: tracciamento delle spedizioni, spedizioni ed 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 controparte.