Zusammenfassung
Ukrposhta (Укрпошта) API für Geschäftskunden in der Ukraine: Sendungsverfolgung, Sendungen und PDF-Etiketten, Preisabschätzungen für Inlandsversand, Routenprüfungen, Kunden und Adressen sowie der Adressklassifizierer mit Postämtern und Öffnungszeiten. Erstellen und Löschen von Sendungen ist deaktiviert. Vertragsträger und Gegenparteitoken.
Geführte Einrichtung
Ukrposhta in 2 Minuten mit ChatGPT verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Ukrposhta in der geführten Einrichtung und trag deine MCP-URL in ChatGPT ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Das AnythingMCP-Plugin im ChatGPT-Verzeichnis beantwortet auf AnythingMCP Cloud Fragen aus deinen Firmendatenbanken (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, nur lesend): Öffne den Eintrag (öffnet in neuem Tab) und klicke auf Install plugin. Alle anderen Connectors fügst du in ChatGPT als eigenen MCP-Server mit deiner AnythingMCP-MCP-URL hinzu.
Frag einfach
Beispiel-Prompts für Ukrposhta
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Ukrposhta, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Ukrposhta + ChatGPT
Ukrposhta (Укрпошта) API für Geschäftskunden in der Ukraine: Sendungsverfolgung, Sendungen und PDF-Etiketten, Preisabschätzungen für Inlandsversand, Routenprüfungen, Kunden und Adressen sowie der Adressklassifizierer mit Postämtern und Öffnungszeiten. Erstellen und Löschen von Sendungen ist deaktiviert. Vertragsträger und Gegenparteitoken.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector enthalten sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN
Schritt 1 — Zugangsdaten erhalten
- Schließe einen Vertrag für die API mit Ukrposhta (Geschäftskundenservice, [email protected]) ab. Mit dem Vertrag erhältst du einen Anhang mit deinen Produktionsschlüsseln.
- Kopiere PRODUCTION BEARER eCom in
UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking inUKRPOSHTA_TRACKING_BEARERund PROD_COUNTERPARTY TOKEN inUKRPOSHTA_COUNTERPARTY_TOKEN.
Die Sandbox-Schlüssel (SANDBOX ...) funktionieren hier nicht: dieser Connector ruft den Produktionshost auf. Der eCom-Bearer öffnet auch den Adressklassifizierer und den Etikettendienst; die Sendungsverfolgung hat ihren eigenen Bearer; das Gegenparteitoken identifiziert dein Konto bei Anfragen zu deinen Kunden und Sendungen.
Wo anfangen: ukrposhta_track_shipment oder ukrposhta_get_last_status mit einem Barcode. Für die Sendungen deines Kontos, ukrposhta_get_shipment_by_barcode oder ukrposhta_list_sender_shipments mit der UUID des Absenders.
Sendungsverfolgung: ukrposhta_track_shipment (alle Ereignisse), ukrposhta_get_last_status, ukrposhta_get_last_statuses (bis zu 50 Barcodes) und ukrposhta_get_shipment_route. Übergebe lang en für englische Ereignisnamen.
Sendungen: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments und ukrposhta_get_label (PDF). Vor dem Versand, ukrposhta_check_route und ukrposhta_calculate_domestic_price (UAH, ohne deine Vertragsrabatte).
Eine Sendung erstellen folgt der Reihenfolge von Ukrposhta: ukrposhta_create_address für Absender und Empfänger, ukrposhta_create_client für jeden (oder wiederverwenden: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), dann ukrposhta_create_shipment, dann das Etikett. ukrposhta_create_shipment und ukrposhta_delete_shipment sind deaktiviert: eine erstellte Sendung wird einmal berechnet, wenn sie abgegeben wird, und eine gelöschte kann nicht wiederhergestellt werden. Adressen und Kunden kosten nichts.
Adressklassifizierer: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode und für Postämter ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near und ukrposhta_get_post_office_hours. Antworten kommen als Entries.Entry-Listen mit Großbuchstaben-Feldnamen; IDs sind Strings.
Einheiten und Fallstricke: Gewicht in Gramm, Größen in cm, Geld in UAH. Lieferarten: W2W Postamt zu Postamt, W2D bis zur Tür, D2W und D2D von der Tür. Eine Postleitzahl, die mit RESTRICTED_ACCESS gekennzeichnet ist, kann nur eine Absender- oder Rücksendeadresse sein. Status: CREATED (noch nicht abgegeben), REGISTERED, DELIVERING, IN_DEPARTMENT (wartet im Büro), DELIVERED, RETURNING, RETURNED, CANCELLED, DELETED. Zeiten sind Ortszeit in Kiew.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in ChatGPT hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.
- Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
- Gib einen Namen ein, z. B. Name:
Ukrposhta. - Trag unter Connection als Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein und lass Authentication auf OAuth. - Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
- Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
ukrposhta_track_shipment | Vollständige Statushistorie einer Sendung nach Barcode: pro Ereignis Schritt, Datum, Index und Name des Postamts, Ereigniscode und eventName (z.B.… |
ukrposhta_get_last_status | Der letzte Status einer Sendung nach Barcode: Datum, Postamtsindex und -name, Ereigniscode, eventName und eventReason. Nur lesbar |
ukrposhta_get_last_statuses | Der letzte Status von bis zu 50 Sendungen auf einmal, plus die Barcodes, die Ukrposhta nicht kennt: pro Barcode Datum, Postamt, Ereigniscode und… |
ukrposhta_get_shipment_route | Wo eine Sendung von und nach (Land und Ort) reist, nach Barcode. Nur lesbar |
ukrposhta_get_shipment | Lies eine Sendung deines Kontos nach UUID: Barcode, Typ, Absender- und Empfänger-Kunden mit Adressen, Lieferart, Pakete (Gewicht… |
ukrposhta_get_shipment_by_barcode | Lies eine Sendung deines Kontos nach ihrem Barcode (die gleichen Felder wie ukrposhta_get_shipment). Nur lesbar |
ukrposhta_list_sender_shipments | Liste der Sendungen, die für einen Absender-Kunden erstellt wurden: UUID, Barcode, Empfänger, Lieferart, Pakete, Preise und Lebenszyklusstatus. Nur lesbar |
ukrposhta_get_shipment_lifecycle | Aktueller Status einer Sendung von der eCom-Seite: shipmentUuid, shipmentBarcode, Status (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | Liste der Sendungsgruppen (Register für Formular 103a) eines Kunden: UUID, Name, Typ, Erstellungsdatum, geschlossenes Flag und Anzahl der Sendungen.… |
ukrposhta_list_group_shipments | Liste der Sendungen in einer Sendungsgruppe: UUID, Barcode, Empfänger, Pakete, Preise und Lebenszyklusstatus. Nur lesbar |
ukrposhta_get_label | Lade das Adressetikett (Aufkleber) einer Sendung, die du erstellt hast, als PDF-Datei herunter: standardmäßig 100 x 100 mm oder auf einem A4- oder A5-Blatt. Das Drucken eines… |
ukrposhta_calculate_domestic_price | Schätze den Preis einer Sendung innerhalb der Ukraine, bevor du sie erstellst: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice… |
ukrposhta_check_route | Überprüfe, ob Ukrposhta zwischen zwei Postleitzahlen liefert: Code (SUCCESS, wenn verfügbar), Beschreibung und mrtps (wo das mobile Postamt von… |
ukrposhta_get_client | Lies einen Kunden (Absender oder Empfänger) deines Kontos: UUID, Typ (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), Name, Vorname, Nachname… |
ukrposhta_find_clients_by_phone | Finde die Kunden deines Kontos mit einer Telefonnummer: UUID, Name, Typ, Adressen. Nur lesbar |
ukrposhta_get_address | Lies eine Adresse, die mit ukrposhta_create_address erstellt wurde: ID, Postleitzahl, Region, Bezirk, Stadt, Straße, Hausnummer, Wohnungsnummer, Land… |
ukrposhta_create_address | Erstelle eine Adresse, die für einen Kunden oder eine Sendung verwendet werden soll. Nur die Postleitzahl ist erforderlich; füge Straße und Haus für die Lieferung an die Tür hinzu. Kostenlos; Antworten… |
ukrposhta_create_client | Erstelle einen Kunden (Absender oder Empfänger) an einer Adresse von ukrposhta_create_address. Einzelpersonen und private Unternehmer benötigen Vorname… |
ukrposhta_create_shipment | Erstelle eine Inlands-Sendung von einem Absender-Kunden zu einem Empfänger-Kunden. Sie erhält einen Barcode und einen Preis und wird einmal berechnet, wenn sie im… abgegeben wird. |
ukrposhta_delete_shipment | Lösche eine Sendung, die sich noch im Status CREATED (noch nicht abgegeben) befindet. Kann nicht rückgängig gemacht werden. Deaktiviert installiert |
ukrposhta_find_post_offices_by_postcode | Postämter, die eine Postleitzahl bedienen: ID, PO_SHORT und PO_LONG (Name), ADRESSE, TELEFON, TYPE_LONG, BREITENGRAD, LÄNGENGRAD, POSTTERMINAL… |
ukrposhta_find_post_offices_near | Postämter in der Nähe eines Punktes, nächstgelegene zuerst: ID, Name, Adresse, Postleitzahl, Entfernung, Koordinaten und Typ. Nur lesbar |
ukrposhta_get_post_office_hours | Öffnungszeiten eines Postamts nach Postleitzahl: pro Wochentag die Öffnungs- und Schließzeiten sowie Pausen. Nur lesbar |
ukrposhta_get_city_by_postcode | Die Gemeinde, der Bezirk und die Region einer Postleitzahl, mit ihren IDs. Nur lesbar |
ukrposhta_search_regions | Finde Regionen (Oblasten) nach einem Teil des Namens, auf Ukrainisch oder Englisch: REGION_ID, REGION_UA, REGION_EN, KOATUU und KATOTTG-Codes. Lass beide… |
ukrposhta_search_districts | Finde Bezirke einer Region nach Namen: DISTRICT_ID, Namen in UA und EN, Region. Nur lesbar |
ukrposhta_search_cities | Finde Gemeinden nach Namen, optional innerhalb einer Region und eines Bezirks: CITY_ID, Namen in UA und EN, Typ (Stadt, Dorf), Bezirk, Region und… |
ukrposhta_search_streets | Finde Straßen einer Gemeinde nach Namen: STREET_ID, Namen in UA und EN, Straßentyp. Nur lesbar |
ukrposhta_get_house_postcode | Die Postleitzahl eines Hauses in einer Straße: Hausnummer und POSTLEITZAHL. Nur lesbar |
Beispielaufforderungen
- "Wo ist das Ukrposhta-Paket 0503112345678?"
- "Zeige den letzten Status dieser 10 Barcodes aus dem Versand von gestern."
- "Wie viel kostet ein 2 kg Paket von Kiew 01001 nach Lwiw 79000?"
- "Welche Postämter sind in der Nähe der Postleitzahl 65000, und wann haben sie am Samstag geöffnet?"
- "Lade das Etikett der Sendung 0503112345678 herunter."
FAQ
Woher kommen die Schlüssel? Nur aus einem Geschäftskontrakt: Ukrposhta sendet den Produktions-eCom-Bearer, den StatusTracking-Bearer und das Gegenparteitoken in einem Anhang zu deinem API-Vertrag. Sandbox-Schlüssel funktionieren hier nicht.
Was deckt es ab? Sendungsverfolgung, deine Sendungen und Gruppen, PDF-Etiketten, Preisabschätzungen für Inlandsversand, Routenprüfungen, Kunden und Adressen sowie der Adressklassifizierer mit Regionen, Gemeinden, Straßen, Postleitzahlen und Postämtern mit Öffnungszeiten.
Welche Tools sind deaktiviert installiert? ukrposhta_create_shipment und ukrposhta_delete_shipment. Schalte sie auf der Connector-Seite nur ein, wenn die KI Sendungen erstellen oder löschen soll.
Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.
Nächste Schritte
War dieser Guide hilfreich?