Руководство по коннектору6 мин чтенияMCP-инструментов: 297 языков

Ukrposhta MCP-сервер: посылки, цены и отделения

Ukrposhta (Укрпошта) API для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF этикетки, оценки внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми офисами и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

HCАвтор: команда HelpCodeОбновлено 6 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

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.

инструментов

29

Регион

INTL

Категория

Логистика

Аутентификация

API credentials

Требуемые env-vars

UKRPOSHTA_ECOM_BEARERUKRPOSHTA_TRACKING_BEARERUKRPOSHTA_COUNTERPARTY_TOKEN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

Ukrposhta (Укрпошта) API для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF этикетки, оценки внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми офисами и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Пошаговая настройка

Подключи Ukrposhta к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Ukrposhta в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для Ukrposhta

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Ukrposhta · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Ukrposhta, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого git clone, никакого локального сервера.

Ukrposhta

Ukrposhta (Укрпошта) API для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF этикетки, оценки внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми офисами и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Настройка

  1. Подпиши контракт на API с Укрпоштой (служба поддержки бизнес-клиентов, [email protected]). С контрактом ты получишь приложение с твоими производственными ключами.
  2. Скопируй PRODUCTION BEARER eCom в UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking в UKRPOSHTA_TRACKING_BEARER и PROD_COUNTERPARTY TOKEN в UKRPOSHTA_COUNTERPARTY_TOKEN.

Ключи песочницы (SANDBOX ...) здесь не работают: этот коннектор вызывает производственный хост. Держатель eCom также открывает классификатор адресов и сервис этикеток; отслеживание имеет своего держателя; токен контрагента идентифицирует твой аккаунт при вызовах о твоих клиентах и отправлениях.

С чего начать: ukrposhta_track_shipment или ukrposhta_get_last_status с штрих-кодом. Для отправлений твоего аккаунта, ukrposhta_get_shipment_by_barcode или ukrposhta_list_sender_shipments с uuid клиента отправителя.

Отслеживание: ukrposhta_track_shipment (все события), ukrposhta_get_last_status, ukrposhta_get_last_statuses (до 50 штрих-кодов) и ukrposhta_get_shipment_route. Передай lang en для английских названий событий.

Отправления: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments и ukrposhta_get_label (PDF). Перед отправкой, ukrposhta_check_route и ukrposhta_calculate_domestic_price (UAH, без твоих контрактных скидок).

Создание отправления следует порядку Укрпошты: ukrposhta_create_address для отправителя и получателя, ukrposhta_create_client для каждого (или используй их повторно: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), затем ukrposhta_create_shipment, затем этикетка. ukrposhta_create_shipment и ukrposhta_delete_shipment отключены: созданное отправление оплачивается один раз при сдаче, а удаленное не может быть восстановлено. Адреса и клиенты ничего не стоят.

Классификатор адресов: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode, а для почтовых офисов ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near и ukrposhta_get_post_office_hours. Ответы приходят в виде списков Entries.Entry с именами полей в верхнем регистре; идентификаторы — строки.

Единицы и подводные камни: вес в граммах, размеры в см, деньги в UAH. Типы доставки: W2W от почтового офиса до почтового офиса, W2D до двери, D2W и D2D от двери. Почтовый индекс, помеченный как RESTRICTED_ACCESS, может быть только адресом отправителя или возврата. Статусы: CREATED (еще не сдано), REGISTERED, DELIVERING, IN_DEPARTMENT (ожидание в офисе), DELIVERED, RETURNING, RETURNED, CANCELLED, DELETED. Время — по местному времени Киева.

Предварительные условия: UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN

Установи коннектор локально

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

Открой http://localhost:3000/connectors/store, выбери Ukrposhta и вставь переменные окружения, указанные в предварительных условиях.

Доступные инструменты

ИнструментЧто он делает
ukrposhta_track_shipmentПолная история статусов одного отправления по штрих-коду: по шагам события, дата, индекс и название почтового офиса, код события и eventName (например…
ukrposhta_get_last_statusПоследний статус одного отправления по штрих-коду: дата, индекс и название почтового офиса, код события, eventName и eventReason. Только для чтения
ukrposhta_get_last_statusesПоследний статус до 50 отправлений одновременно, плюс штрих-коды, которые Укрпошта не знает: по штрих-коду дата, почтовый офис, код события и…
ukrposhta_get_shipment_routeОткуда и куда едет отправление (страна и местность) по штрих-коду. Только для чтения
ukrposhta_get_shipmentПрочитать одно отправление твоего аккаунта по uuid: штрих-код, тип, клиенты отправителя и получателя с адресами, deliveryType, посылки (вес…
ukrposhta_get_shipment_by_barcodeПрочитать одно отправление твоего аккаунта по его штрих-коду (те же поля, что и у ukrposhta_get_shipment). Только для чтения
ukrposhta_list_sender_shipmentsСписок отправлений, созданных для одного клиента-отправителя: uuid, штрих-код, получатель, deliveryType, посылки, цены и статус жизненного цикла. Только для чтения
ukrposhta_get_shipment_lifecycleТекущий статус одного отправления со стороны eCom: shipmentUuid, shipmentBarcode, статус (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT…
ukrposhta_list_shipment_groupsСписок групп отправлений (реестры для формы 103a) одного клиента: uuid, имя, тип, дата создания, флаг закрытия и количество отправлений.…
ukrposhta_list_group_shipmentsСписок отправлений в одной группе отправлений: uuid, штрих-код, получатель, посылки, цены и статус жизненного цикла. Только для чтения
ukrposhta_get_labelСкачать этикетку адреса (наклейку) отправления, которое ты создал, в формате PDF: 100 x 100 мм по умолчанию или на листе A4 или A5. Печать…
ukrposhta_calculate_domestic_priceОценить цену отправления внутри Украины перед его созданием: deliveryPrice в UAH, rawDeliveryPrice, postPayDeliveryPrice…
ukrposhta_check_routeПроверить, что Укрпошта доставляет между двумя почтовыми индексами: код (SUCCESS, когда доступно), описание и mrtps (где мобильный почтовый офис…
ukrposhta_get_clientПрочитать одного клиента (отправителя или получателя) твоего аккаунта: uuid, тип (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), имя, firstName, lastName…
ukrposhta_find_clients_by_phoneНайти клиентов твоего аккаунта по номеру телефона: uuid, имя, тип, адреса. Только для чтения
ukrposhta_get_addressПрочитать адрес, созданный с помощью ukrposhta_create_address: id, почтовый индекс, регион, район, город, улица, номер дома, номер квартиры, страна…
ukrposhta_create_addressСоздать адрес для использования клиентом или отправлением. Только почтовый индекс обязателен; добавь улицу и дом для доставки до двери. Бесплатно; ответы…
ukrposhta_create_clientСоздать клиента (отправителя или получателя) по адресу из ukrposhta_create_address. Физические лица и частные предприниматели должны указать first_name…
ukrposhta_create_shipmentСоздать внутреннее отправление от клиента-отправителя к клиенту-получателю. Оно получает штрих-код и цену, и оплачивается один раз при сдаче в…
ukrposhta_delete_shipmentУдалить отправление, которое все еще имеет статус CREATED (еще не сдано). Не может быть отменено. Отключено
ukrposhta_find_post_offices_by_postcodeПочтовые офисы, обслуживающие почтовый индекс: ID, PO_SHORT и PO_LONG (название), АДРЕС, ТЕЛЕФОН, TYPE_LONG, ШИРОТА, ДОЛГОТА, POSTTERMINAL…
ukrposhta_find_post_offices_nearПочтовые офисы рядом с точкой, ближайшие первыми: ID, название, адрес, почтовый индекс, расстояние, координаты и тип. Только для чтения
ukrposhta_get_post_office_hoursЧасы работы почтового офиса по почтовому индексу: по рабочим дням время открытия и закрытия и перерывы. Только для чтения
ukrposhta_get_city_by_postcodeМестность, район и регион почтового индекса с их идентификаторами. Только для чтения
ukrposhta_search_regionsНайти регионы (области) по части названия, на украинском или английском: REGION_ID, REGION_UA, REGION_EN, коды KOATUU и KATOTTG. Оставь оба…
ukrposhta_search_districtsНайти районы региона по названию: DISTRICT_ID, названия на UA и EN, регион. Только для чтения
ukrposhta_search_citiesНайти местности по названию, при необходимости в пределах региона и района: CITY_ID, названия на UA и EN, тип (город, село), район, регион и…
ukrposhta_search_streetsНайти улицы местности по названию: STREET_ID, названия на UA и EN, тип улицы. Только для чтения
ukrposhta_get_house_postcodeПочтовый индекс дома на улице: номер дома и POSTCODE. Только для чтения

Примеры запросов

  • "Где находится посылка Укрпошты 0503112345678?"
  • "Покажи последний статус этих 10 штрих-кодов из отправки вчера."
  • "Сколько стоит посылка весом 2 кг из Киева 01001 в Львов 79000?"
  • "Какие почтовые офисы находятся рядом с почтовым индексом 65000, и когда они открыты в субботу?"
  • "Скачать этикетку отправления 0503112345678."

Следующие шаги

Это руководство помогло?

Подключи Ukrposhta к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Ukrposhta в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключи Ukrposhta MCP к ChatGPT

API Укрпошты для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми отделениями и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Коннекторы

Подключи Ukrposhta MCP к Claude

API Укрпошты для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми отделениями и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Коннекторы

Подключи Ukrposhta MCP к Microsoft Copilot

API Укрпошты для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми отделениями и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Коннекторы

Подключи Ukrposhta MCP к Cursor

API Укрпошты для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми отделениями и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Коннекторы

Подключи Ukrposhta MCP к Gemini CLI

API Укрпошты для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми отделениями и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.

Коннекторы

Подключи Ukrposhta MCP к Meta Muse

API Укрпошты для бизнес-клиентов в Украине: отслеживание отправлений, отправления и PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с почтовыми отделениями и часами работы. Создание и удаление отправлений отключено. Токены контрагентов и держателей контрактов.