Як ми підключили українські API до AI-агентів через MCP-сервери — і що це дало бізнесу

Українські компанії щоденно працюють з Монобанком, ПриватБанком, Укрпоштою, Horoshop та Google Business Profile. Кожна з цих платформ має свій API, свою документацію, свої нюанси автентифікації. Наша команда в IIP побудувала 6 MCP-серверів, які дозволяють AI-агентам (Claude, GPT, будь-який LLM з підтримкою Model Context Protocol) працювати з цими API напряму — без написання жодного рядка інтеграційного коду на стороні клієнта.

У цій статті ми розповімо, що саме ми побудували, які конкретні задачі це автоматизує, і скільки часу та грошей це економить.

Model Context Protocol (MCP) — це відкритий стандарт від Anthropic, який дозволяє AI-агентам викликати зовнішні інструменти (tools) через уніфікований інтерфейс.

Замість того, щоб писати окремий код для кожної інтеграції, ви підключаєте MCP-сервер — і AI-агент отримує доступ до всіх його функцій автоматично.

Ми побудували 114 інструментів у 6 серверах, які покривають фінтех, логістику, e-commerce та маркетинг в Україні.

Що ми побудували: 6 MCP-серверів

Найбільший з наших серверів. Покриває всі три рівні API Монобанку:

- Персональний API: інформація про клієнта, виписки за до 31 дня, вебхуки на транзакції

- Еквайринг (Plata by Mono): створення рахунків на оплату, перевірка статусу платежу, повне/часткове повернення коштів, фіскальні чеки (pRRO/Checkbox), QR-коди, токенізовані картки, підписки на рекурентні платежі, управління субмерчантами

- Корпоративний API: баланси рахунків, транзакції по IBAN, підготовка платежів до підпису в додатку, зарплатні реєстри з пакетними виплатами

Конкретний приклад: Бухгалтер питає AI-агента: "Покажи всі вхідні платежі на рахунок UA21... за останній тиждень і порівняй із виставленими рахунками". Агент викликає monobank_corp_get_statement, отримує транзакції, і зіставляє з даними з облікової системи — без жодного ручного експорту в Excel.

Виграш у часі: Формування зарплатного реєстру через monobank_corp_create_salary_registry — замість 2-3 годин ручного введення в інтерфейсі банку, агент формує реєстр за 15 секунд на основі даних з HR-системи. Це скорочення ~98% часу на рутинну операцію.

Повна інтеграція з 4-ма суб-API Укрпошти:

- eCom API: створення відправлень (W2W, W2D, D2W, D2D), управління адресами та клієнтами, генерація PDF-стікерів та форми 103а

- Tracking API: відстеження по штрих-коду, повна історія статусів, маршрут доставки

- Address Classifier: пошук областей, районів, міст, відділень, нечіткий пошук міст (UA/EN), пошук найближчих відділень по GPS-координатах

Конкретний приклад: Оператор e-commerce каже агенту: "Створи відправлення для замовлення #4521 — адреса клієнта: Київ, вул. Хрещатик 1, вага 2 кг". Агент через

  ukrposhta_create_client → ukrposhta_create_address → ukrposhta_create_shipment → ukrposhta_get_shipment_label_url створює відправлення і повертає посилання на

  PDF-стікер — весь ланцюжок за одне повідомлення в чаті.

(ukrposhta_create_shipment_group) — 15-20 хвилин, включаючи валідацію адрес. Скорочення на ~90%.

Корпоративний банкінг через Autoclient v3 API ПриватБанку:

  - Баланси та виписки (interim — протягом дня, final — кінець дня)

  - Фільтрація по картках та датах

  - Створення платіжних доручень

  - Курси валют ПриватБанку (поточні та історичні)

Конкретний приклад: Фінансовий директор запитує: "Яка була різниця між курсом долара ПриватБанку та Монобанку 15 березня?". Агент паралельно викликає privat24_business_get_exchange_rate_history та monobank_get_currency_rates і порівнює — за 3 секунди замість ручного відкриття двох сайтів і пошуку по архівах.

Підключення до API e-commerce платформи Horoshop:

  - Експорт замовлень та товарів з фільтрацією

  - Оновлення статусів замовлень

  - Універсальний виклик будь-якого ендпоінту Horoshop API

Виграш у часі: Обробка 30 нових замовлень (перегляд + зміна статусу) — 20 хвилин вручну vs 1 хвилина через агента. Скорочення на ~95%.

  ---

  5. Google Business Profile MCP Server — 12 інструментів

  Управління бізнес-профілями Google:

  - Публікація постів (стандартні, події, акції з купонами)

  - Кнопки CTA: BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL

  - Управління відгуками: перегляд, відповідь, видалення відповіді

  - Робота з медіа (фото/відео)

  - OAuth 2.0 з автоматичним оновленням токена

  Конкретний приклад: Маркетолог мережі з 12 локаціями: "Опублікуй пост про знижку 20% на каву до кінця тижня на всіх наших локаціях з кнопкою ORDER". Агент через

  gbp_list_locations → gbp_create_post (з типом OFFER, купоном і CTA) публікує на всі 12 — за одне повідомлення замість 12 ручних публікацій.

  Виграш у часі: Публікація поста на 12 локаціях вручну — ~30 хвилин (вхід, навігація, заповнення форми × 12). Через агента — 30 секунд. Скорочення на ~98%.

  Відповідь на 20 відгуків — з 40 хвилин до 3 хвилин (агент генерує персоналізовані відповіді та публікує через gbp_reply_review).

  ---

  6. API Change Sentinel MCP — 5 інструментів

  Унікальний продукт: аналіз змін між версіями API-специфікацій:

  - Порівняння двох OpenAPI-специфікацій з виявленням breaking changes

  - Оцінка blast radius (скільки споживачів зачепить зміна)

  - Генерація міграційних гайдів

  - Автоматичні release notes

  Конкретний приклад: Техлід: "Порівняй v2.1 і v2.2 нашого API і скажи, що зламається у клієнтів". Агент через compare_api_specs → list_breaking_changes →

  estimate_consumer_blast_radius → draft_migration_guide видає повний звіт з severity scoring.

  Виграш у часі: Ручний аналіз API-дифа — 2-4 години інженерного часу. Через агента — 30 секунд. Це ~99% скорочення часу з повною елімінацією людської помилки при

  ревью.

  ---

  Загальні цифри покращення

  ┌───────────────────────────────────────────────────┬────────────┬──────────────┬────────────┐

  │                      Метрика                      │   До MCP   │    З MCP     │ Покращення │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Створення зарплатного реєстру (50 співробітників) │ 2-3 години │ 15 секунд    │ ~98%       │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Створення 50 відправлень Укрпоштою                │ 3 години   │ 15-20 хвилин │ ~90%       │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Щоденна звірка виписок по 5 рахунках              │ 45 хвилин  │ 2 хвилини    │ ~95%       │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Публікація поста на 12 GBP-локаціях               │ 30 хвилин  │ 30 секунд    │ ~98%       │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Обробка 30 замовлень Horoshop                     │ 20 хвилин  │ 1 хвилина    │ ~95%       │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Аналіз breaking changes API                       │ 2-4 години │ 30 секунд    │ ~99%       │

  ├───────────────────────────────────────────────────┼────────────┼──────────────┼────────────┤

  │ Загальна кількість автоматизованих інструментів   │ —          │ 114          │ —          │

  └───────────────────────────────────────────────────┴────────────┴──────────────┴────────────┘

  1. Нульовий інтеграційний код на стороні клієнта. Традиційна інтеграція з API Укрпошти потребує 2-3 тижні розробки: автентифікація, обробка помилок, маппінг

  даних. З нашим MCP-сервером — підключив і працюєш.

  2. AI розуміє контекст. Агент не просто передає дані — він інтерпретує їх. Запит "чи є проблемні платежі" перетворюється на виклик потрібних ендпоінтів,

  фільтрацію по статусах, і людську відповідь.

  3. Один інтерфейс для всього. Замість 5 різних адмінок (банк, пошта, магазин, Google, API-специфікації) — один чат з AI-агентом, який має доступ до всіх систем

  одночасно.

  4. Масштабування без зусиль. Додати нового співробітника — це не навчити його 5 інтерфейсів, а дати доступ до агента. Onboarding скорочується з тижнів до годин.

  Усі сервери побудовані на єдиному стеку:

  - TypeScript — типобезпечність на всіх рівнях

  - @modelcontextprotocol/sdk — офіційний SDK від Anthropic

  - Zod — валідація вхідних параметрів з автогенерацією JSON Schema

  - Підтримка різних моделей автентифікації: OAuth 2.0 (Google), токени (Monobank, PrivatBank), логін/пароль + токен (Horoshop), двотокенна система (Ukrposhta)

Ми в IIP створили мости між українськими бізнес-API та світом AI-агентів. 114 інструментів у 6 серверах покривають фінанси, логістику, e-commerce та маркетинг — і кожен з них перетворює години ручної роботи на секунди автоматизованих операцій.

Якщо ваш бізнес працює з українськими сервісами і ви хочете підключити AI-агентів до вашої щоденної роботи — зв'яжіться з нами.