Nova Post MCP — інструменти доставки

Підключення

Почніть за три кроки

Додайте URL сервера до свого AI-агента через MCP. Окремий плагін або передавання Nova Post API key у чат не потрібні.

01Додайте конектор

Вкажіть MCP endpoint у ChatGPT, Claude, Cursor або іншому сумісному застосунку, щоб підключити AI-агента.

02Авторизуйтеся

Під час підключення відкриється стандартна сторінка входу - увійдіть як зазвичай та підтвердіть доступи для AI-агента

03Сформулюйте задачу

AI-агент обере потрібний інструмент самостійно та, в залежності від налаштувань, попросить підтвердження перед зміною даних.

{
  "mcpServers": {
    "nova-post": { "url": "https://mcp.novapost.com/mcp" }
  }
}

Можливості

Пишіть так, як зручно

Технічні назви інструментів знати не обовʼязково — достатньо описати потрібний результат.

Знайди вантажне відділення у Львові на Городоцькій.

Розрахуй вартість доставки посилки вагою 2 кг з Києва до Варшави.

Які посилки до мене їдуть?

Продублюй останнє відправлення, яке я робив.

Доступ і безпека

Безпечне підключення до MCP

Авторизація проходить через стандартний OAuth 2.1 / OIDC flow, а доступ до операцій надається лише після підтвердження користувача.

Вхід через Nova Post

Ви входите на захищеній сторінці Нової пошти. Логін і пароль ніколи не передаються AI-агенту.

Лише потрібний доступ

AI-агент не отримує прямого доступу до вашого кабінету чи всіх його даних. Він може виконувати лише доступні MCP-операції в межах наданих дозволів.

Дані під захистом MCP

MCP зберігає токени авторизації на сервері й передає агенту лише результат запитаної операції, а не ваші облікові дані.

Перед змінами потрібне підтвердження

Створення, повне оновлення та видалення відправлення виконуються лише після явної згоди користувача.

Інструменти доставки

Локації

Пошук населених пунктів, вулиць, відділень, поштоматів та інших точок обслуговування.

Знайти відділення

get_divisions

Лише читання

Шукає відділення, поштомати й інші точки Nova Post.

Знайти населений пункт

get_settlements

Лише читання

Шукає населені пункти Nova Post за назвою та повертає точний settlementId, потрібний для подальшого пошуку відділень.

Знайти вулицю

get_streets

Лише читання

Шукає записи вулиць Nova Post за назвою та ISO-кодом країни.

Довідники

Валюти, одиниці вимірювання, митні класифікатори й обмеження.

Отримати одиниці вимірювання

get_dictionary_measurements

Лише читання

Повертає допустимі одиниці вимірювання для ваги, розмірів і кількості вантажу.

Отримати підтримувані валюти

get_dictionary_currencies

Лише читання

Повертає перелік валют, які можна використовувати у відправленнях і митних даних.

Знайти код вантажу

get_dictionary_classifier

Лише читання

Шукає митний HS-код або класифікацію вантажу за ключовим словом, країною та мовою відповіді.

Отримати митні правила країни

get_dictionary_customs_fees_code

Лише читання

Повертає митні обмеження й пороги задекларованої вартості для країни, заданої ISO-кодом.

Розрахунок

Попередній розрахунок вартості, строків і способів доставки.

Розрахувати доставку

post_shipments_calculations

Змінює дані

Розраховує вартість, строк і доступні типи доставки до створення або зміни відправлення.

Трекінг

Статуси відправлень, історія переміщень і деталі доставки.

Отримати історію руху

get_shipments_tracking_history

Лише читання

Повертає історію переміщень відправлення за його номером і за потреби включає повʼязані відправлення.

Відстежити відправлення

get_shipments_tracking

Лише читання

Повертає детальні події, місця перебування та інформацію про доставку за номером або ID відправлення.

Відправлення

Створення, перегляд, редагування та видалення відправлень.

Завантажити документи відправлення

get_shipments_print

Лише читання

Формує офіційні PDF-документи для одного чи кількох відправлень — маркування, міжнародний документ або інвойс — і повертає тимчасові посилання для завантаження.

Знайти відправлення

get_shipments

Лише читання

Повертає список наявних відправлень із пошуком за номерами, ID, реєстром або відділенням відправника.

Створити відправлення

post_shipments

Змінює дані

Створює реальне відправлення після явного підтвердження користувача.

Видалити відправлення

delete_shipments_id

Небезпечна дія

Безповоротно видаляє конкретне відправлення за точним ID і потребує явного підтвердження користувача.