AI-асистентам   Офіційний MCP-сервер незалежної лабораторії СМАРТЛАБ
smartlab.ua  ·  Акції  ·  Адреси відділень
0 800 750 070дзвінки в межах України безкоштовні
Версія 0.1 · публічний каталог

Каталог СМАРТЛАБ у вашому AI-асистенті

Один URL — і ChatGPT, Claude, Cursor чи будь-який інший MCP-сумісний клієнт може знайти аналіз, назвати ціну й термін, пояснити підготовку, показати найближче відділення та чинні акції. Без реєстрації, без персональних даних, лише читання.

ТранспортStreamable HTTP
MCP 2025-06-18, без сесій
ДоступПублічні дані
без авторизації пацієнта
Інструменти15, усі read-only
нічого не створюють і не змінюють
Мовиuk · en · ru
параметр locale
Підключити Переглянути інструменти

Що це і для кого

MCP (Model Context Protocol) — відкритий стандарт, за яким AI-модель підключається до зовнішніх сервісів. Сервер описує свої інструменти, а клієнт викликає їх під час розмови. ТОВ "СМАРТЛАБ" публікує такий сервер для свого відкритого каталогу.

П

Пацієнтам

Запитайте свого асистента: «Скільки коштує ТТГ у СМАРТЛАБ і як підготуватись?» — і отримаєте актуальну відповідь із прайсу, а не з пам'яті моделі. Замовлення й результати — як і раніше, на smartlab.ua, у застосунку або у відділенні.

Р

Розробникам

Стандартний MCP-сервер без кастомних SDK. Підключається за одним URL до Claude, ChatGPT, Cursor, Claude Code та власних агентів. Строга схема входу, передбачувана структура відповіді, зрозумілі помилки.

Л

Лабораторії

Асистенти відповідають про аналізи з нашого прайсу, а не вигадують. Сервер захищає бекенд від навантаження (кеш, ліміти, запобіжник) і віддає лише те, що вже є на сайті.

Що доступно, а що — ні

Версія 0.1 свідомо обмежена відкритим каталогом: лише те, що вже опубліковано на smartlab.ua.

Є у версії 0.1

  • Пошук аналізів, комплексів, check-up і УЗД за назвою, абревіатурою чи кодом
  • Картка дослідження: опис, показання, метод дослідження
  • Правила підготовки до аналізу: натще, час доби, ліки, обмеження
  • Базова ціна, термін виконання, CITO, вартість взяття біоматеріалу
  • Склад комплексів і check-up
  • Групи каталогу та топ-10 популярних досліджень
  • Міста, відділення, координати, тижневий графік, послуги у відділенні
  • Чинні акції та «Дні здоров'я»
  • Новини лабораторії: нові лікарі, відділення, послуги

Швидкий старт

Ключ доступу видає ТОВ "СМАРТЛАБ". Введіть його нижче — і адреса в усіх інструкціях підставиться сама.

  1. Settings → Connectors → увімкніть Developer mode (потрібен тариф із підтримкою custom connectors).
  2. Create → назва «СМАРТЛАБ», MCP Server URL — адреса вище, Authentication — No authentication.
  3. У новому чаті увімкніть конектор і запитайте: «Скільки коштує загальний аналіз крові у СМАРТЛАБ?»
  1. Settings → Connectors → Add custom connector.
  2. Назва «СМАРТЛАБ», Remote MCP server URL — адреса вище. OAuth не потрібен.
  3. У чаті натисніть «+» → увімкніть СМАРТЛАБ і ставте питання українською.
claude mcp add --transport http smartlab "https://mcp.smartlab.ua/mcp/<ключ>"
# перевірка
claude mcp list

Файл .cursor/mcp.json у проєкті або глобальний:

{
  "mcpServers": {
    "smartlab": { "url": "https://mcp.smartlab.ua/mcp/<ключ>" }
  }
}

Будь-який MCP SDK зі Streamable HTTP. Приклад на TypeScript:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://mcp.smartlab.ua/mcp/<ключ>")));

const r = await client.callTool({ name: "smartlab_search_tests", arguments: { query: "ТТГ", per_page: 5 } });
console.log(r.structuredContent);

Для скриптів, які вміють надсилати заголовки, ТОВ "СМАРТЛАБ" може видати ключ: тоді додайте Authorization: Bearer <ключ>.

Інструменти (15)

Кожен інструмент повертає текст і structuredContent з фіксованим набором полів. Ідентифікатори (test_id, branch_id, group_id, promotion_id) беруться з відповідей інших інструментів. Усі приймають locale: uk (типово), ru, en.

Пошук і каталог 4 інструменти

smartlab_search_tests

Пошук аналізів, комплексів, check-up та УЗД за назвою, абревіатурою («ТТГ», «TSH») або кодом. Повертає ціни, термін, біоматеріал, ознаку комплексу, id.

Вхід: query (≤ 100 символів) або group_id, page, per_page (≤ 50)
smartlab_get_test_groups

Дерево груп каталогу з підгрупами та кількістю досліджень. Id групи підходить для перегляду через пошук.

Вхід: locale
smartlab_get_popular_tests

Топ-10 досліджень, як на головній smartlab.ua, з актуальними цінами. Добрий старт, коли пацієнт не знає, що шукати.

Вхід: locale
smartlab_get_complex_composition

Склад комплексу або check-up: перелік досліджень із цінами, ціна комплексу та сума частин окремо.

Вхід: complex_id

Картка, ціна, підготовка 4 інструменти

smartlab_get_test_info

Повна картка: опис, показання, метод і референтні значення, підготовка, ціна, взяття біоматеріалу, склад, пов'язані дослідження, кількість відділень.

Вхід: test_id, include_branch_ids
smartlab_get_test_price

Базова ціна, CITO, термін, вартість взяття біоматеріалу та орієнтовний підсумок. Акційна ціна — окремим полем promo_price_uah, коли є.

Вхід: test_id
smartlab_get_preparation

Правила підготовки простим текстом: натще, час доби, ліки, обмеження.

Вхід: test_id
smartlab_get_sampling_fees

Тарифи на взяття біоматеріалу (венозна кров, зішкріб тощо), які додаються до ціни дослідження.

Вхід: locale

Відділення 3 інструменти

smartlab_list_cities

Усі міста й містечка, де є відділення СМАРТЛАБ.

Вхід: locale
smartlab_find_branches

Відділення за містом, адресою, координатами (сортує за відстанню), послугами (УЗД, ЕКГ, лікар, дитяче) або за доступністю конкретного аналізу.

Вхід: city, address, near {lat,lng}, services[], test_id, limit (≤ 30)
smartlab_get_branch

Адреса, телефон, посилання на карту та нормалізований тижневий графік: відкриття, забір крові до, видача результатів до.

Вхід: branch_id

Акції 2 інструменти

smartlab_get_promotions

Чинні акції: назва, короткий опис, максимальна знижка, дати, місто (якщо акція локальна), посилання на умови. Плюс постійні «Дні здоров'я».

Вхід: include_expired (типово false), locale
smartlab_get_promotion

Повні умови однієї акції та дослідження, які в неї входять, з акційними цінами.

Вхід: promotion_id

Новини 2 інструменти

smartlab_get_news

Останні новини smartlab.ua: нові лікарі, відділення, послуги, обладнання, бонусні програми. Тизер і посилання, найновіші першими.

Вхід: limit (≤ 20), locale
smartlab_get_news_article

Повний текст однієї новини без розмітки.

Вхід: news_id

Типові сценарії

Асистент сам обирає ланцюжок інструментів. Так виглядають найчастіші запити пацієнтів.

Скільки коштує ТТГ і як підготуватись?
smartlab_search_tests→smartlab_get_test_price→smartlab_get_preparation
Ціна з прайсу, вартість взяття крові, орієнтовний підсумок, термін і правила підготовки. Асистент нагадує, що остаточну ціну підтвердять у відділенні або на гарячій лінії.
Де найближче відділення з УЗД в Одесі і коли там забір крові?
smartlab_find_branches→smartlab_get_branch
Фільтр за містом і послугою, сортування за відстанню, графік на кожен день тижня з позначкою «у свята уточнюйте».
Що входить у check-up для жінок і чи є на нього знижка?
smartlab_search_tests→smartlab_get_complex_composition→smartlab_get_promotions→smartlab_get_promotion
Склад комплексу, ціна комплексу проти суми частин, чинна акція з акційною ціною та посиланням на умови.
Які аналізи мені потрібні, якщо я постійно втомлений?
smartlab_get_popular_tests→smartlab_get_test_info
Асистент не призначає обстеження: він покаже, для чого потрібні поширені дослідження, і порадить звернутися до лікаря. Це прописано в інструкціях сервера.

Обмеження та помилки

ЩоЗначенняНавіщо
Ліміт запитів60 за хвилину на клієнта, сплеск до 20захист бекенду лабораторії; у відповідь — HTTP 429
Пакетні запити JSON-RPCзаборонені (HTTP 400)один HTTP-запит = один виклик
Розмір сторінкиper_page ≤ 50, limit ≤ 30каталог не для масового вивантаження
Кеш5–15 хвилинціни оновлюються з прайсу з такою затримкою
Цінибазові, у гривняхакції — окремими інструментами та полем promo_price_uah
Графік відділеньтижневийсвяткові дні уточнюйте за 0 800 750 070
Тимчасова недоступністьisError: true з людяним текстомвнутрішні помилки бекенду назовні не виходять; повторіть за хвилину
Невалідний вхідпомилка валідації з описом поляid — hex або число до 32 символів; запит — до 100 символів без розмітки

Безпека та приватність

Лише читання

Усі інструменти позначені readOnlyHint. Сервер фізично не має маршрутів до замовлень, результатів чи особистого кабінету: у його allow-list лише 13 публічних GET-адрес каталогу та сайту.

Без персональних даних

Сервер не приймає й не зберігає жодних даних пацієнта. Заголовки клієнта (у тому числі Authorization) ніколи не передаються далі. У логах — лише назва інструмента, тривалість і тип помилки.

Без медичних порад

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

Дані як дані

Тексти з каталогу очищаються від розмітки та прихованих символів; асистент отримує інструкцію не сприймати їх як команди. Внутрішні помилки бекенду назовні не потрапляють.

Адреса сервера з ключем доступу видається ТОВ "СМАРТЛАБ" і може бути змінена з попередженням користувачів. Про вразливості повідомляйте ТОВ "СМАРТЛАБ" через гарячу лінію 0 800 750 070 або форму зворотного зв'язку на smartlab.ua.
Документи: Політика конфіденційності MCP-сервера (що саме отримує сервер, скільки зберігає, кому не передає) та Умови користування (ключ доступу, ціни, авторське право, обмеження). Вони доповнюють політику і умови сайту smartlab.ua.