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

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

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

HCАвтор: команда HelpCodeОбновлено 7 мин чтения Открытый код на 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-совместимый клиент

Кратко

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

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

Подключи Ukrposhta к Cursor за 2 минуты

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

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

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

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

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

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

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

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

Укрпошта + Cursor

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

Предварительные требования

Смотри полные инструкции по настройке, встроенные в коннектор (видно в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN

Шаг 1 — Получи учетные данные

  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 с именами полей в верхнем регистре; id — строки.

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

Шаг 2 — Установи адаптер

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

Шаг 3 — Добавь коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
  2. Сохрани файл и перезапусти Cursor.
  3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
  4. Начинай общаться: агент теперь может вызывать инструменты Укрпошта.

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

ИнструментЧто он делает
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Местность, район и регион почтового индекса с их id. Только для чтения
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."

Часто задаваемые вопросы

Откуда берутся ключи? Только из бизнес-контракта: Укрпошта отправляет производственный токен eCom, токен StatusTracking и токен контрагента в приложении к твоему API-контракту. Ключи песочницы здесь не работают.

Что это охватывает? Отслеживание, твои отправления и группы, PDF-этикетки, расчеты внутренних цен, проверки маршрутов, клиенты и адреса, а также классификатор адресов с регионами, местностями, улицами, почтовыми индексами и почтовыми отделениями с часами работы.

Какие инструменты установлены отключенными? ukrposhta_create_shipment и ukrposhta_delete_shipment. Включай их на странице коннектора только если ИИ должен создавать или удалять отправления.

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да — MCP доступен на тарифах Hobby, Pro и Business.

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

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

Подключи Ukrposhta к Cursor за 2 минуты

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

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

Коннекторы

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

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

Коннекторы

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

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

Коннекторы

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

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

Коннекторы

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

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

Коннекторы

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

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

Коннекторы

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

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