Connector-Anleitung7 Minuten Lesezeit29 MCP-Tools7 Sprachen

Ukrposhta MCP mit Gemini CLI verbinden

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.

HCVom HelpCode-TeamAktualisiert 7 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

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.

Tools

29

Region

INTL

Kategorie

Logistik

Authentifizierung

API credentials

Benötigte Env-Vars

UKRPOSHTA_ECOM_BEARERUKRPOSHTA_TRACKING_BEARERUKRPOSHTA_COUNTERPARTY_TOKEN
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

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 Gemini verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Ukrposhta in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

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.

Ukrposhta · live via MCP
Teilen
Opus 4.7

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 + Gemini

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

  1. 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.
  2. Kopiere PRODUCTION BEARER eCom in UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking in UKRPOSHTA_TRACKING_BEARER und PROD_COUNTERPARTY TOKEN in UKRPOSHTA_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 Gemini 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 Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
  2. Speichere die Datei und starte gemini neu.
  3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
  4. Leg los: Gemini CLI kann jetzt die Ukrposhta-Tools aufrufen.

Verfügbare Tools

ToolWas es tut
ukrposhta_track_shipmentVollständige Statushistorie einer Sendung nach Barcode: pro Ereignis Schritt, Datum, Index und Name des Postamts, Ereigniscode und eventName (z.B.…
ukrposhta_get_last_statusDer letzte Status einer Sendung nach Barcode: Datum, Postamtsindex und -name, Ereigniscode, eventName und eventReason. Nur lesbar
ukrposhta_get_last_statusesDer 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_routeWo eine Sendung von und nach (Land und Ort) reist, nach Barcode. Nur lesbar
ukrposhta_get_shipmentLies eine Sendung deines Kontos nach UUID: Barcode, Typ, Absender- und Empfänger-Kunden mit Adressen, Lieferart, Pakete (Gewicht…
ukrposhta_get_shipment_by_barcodeLies eine Sendung deines Kontos nach ihrem Barcode (die gleichen Felder wie ukrposhta_get_shipment). Nur lesbar
ukrposhta_list_sender_shipmentsListe der Sendungen, die für einen Absender-Kunden erstellt wurden: UUID, Barcode, Empfänger, Lieferart, Pakete, Preise und Lebenszyklusstatus. Nur lesbar
ukrposhta_get_shipment_lifecycleAktueller Status einer Sendung von der eCom-Seite: shipmentUuid, shipmentBarcode, Status (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT…
ukrposhta_list_shipment_groupsListe der Sendungsgruppen (Register für Formular 103a) eines Kunden: UUID, Name, Typ, Erstellungsdatum, geschlossenes Flag und Anzahl der Sendungen.…
ukrposhta_list_group_shipmentsListe der Sendungen in einer Sendungsgruppe: UUID, Barcode, Empfänger, Pakete, Preise und Lebenszyklusstatus. Nur lesbar
ukrposhta_get_labelLade 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_priceSchä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_clientLies einen Kunden (Absender oder Empfänger) deines Kontos: UUID, Typ (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), Name, Vorname, Nachname…
ukrposhta_find_clients_by_phoneFinde die Kunden deines Kontos mit einer Telefonnummer: UUID, Name, Typ, Adressen. Nur lesbar
ukrposhta_get_addressLies eine Adresse, die mit ukrposhta_create_address erstellt wurde: ID, Postleitzahl, Region, Bezirk, Stadt, Straße, Hausnummer, Wohnungsnummer, Land…
ukrposhta_create_addressErstelle 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_clientErstelle einen Kunden (Absender oder Empfänger) an einer Adresse von ukrposhta_create_address. Einzelpersonen und private Unternehmer benötigen Vorname…
ukrposhta_create_shipmentErstelle 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_shipmentLö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_postcodePostämter, die eine Postleitzahl bedienen: ID, PO_SHORT und PO_LONG (Name), ADRESSE, TELEFON, TYPE_LONG, BREITENGRAD, LÄNGENGRAD, POSTTERMINAL…
ukrposhta_find_post_offices_nearPostä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_postcodeDie Gemeinde, der Bezirk und die Region einer Postleitzahl, mit ihren IDs. Nur lesbar
ukrposhta_search_regionsFinde 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_districtsFinde Bezirke einer Region nach Namen: DISTRICT_ID, Namen in UA und EN, Region. Nur lesbar
ukrposhta_search_citiesFinde 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_streetsFinde Straßen einer Gemeinde nach Namen: STREET_ID, Namen in UA und EN, Straßentyp. Nur lesbar
ukrposhta_get_house_postcodeDie 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.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

War dieser Guide hilfreich?

Ukrposhta in 2 Minuten mit Gemini verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Ukrposhta in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

Ukrposhta MCP mit ChatGPT verbinden

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.

Connectors

Ukrposhta MCP mit Claude verbinden

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.

Connectors

Ukrposhta MCP mit Microsoft Copilot verbinden

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.

Connectors

Ukrposhta MCP mit Cursor verbinden

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.

Connectors

Ukrposhta MCP mit Meta Muse verbinden

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.

Connectors

Ukrposhta MCP-Server: Sendungen, Preise und Postämter

Ukrposhta (Укрпошта) API für Geschäftskunden in der Ukraine: Sendungsverfolgung, Sendungen und PDF-Etiketten, Schätzungen der Inlandspreise, Routenprüfungen, Kunden und Adressen sowie der Adressklassifizierer mit Postämtern und Öffnungszeiten. Erstellen und Löschen von Sendungen ist deaktiviert. Vertragsträger und Gegenpartei-Token.