Конектор Ibis Gear

MCP-сервер над каталогом https://ibis.net.ua — рибальство, одяг і взуття, туристичне спорядження, ножі та ліхтарі, полювання й спортивна стрільба.

https://mcp.ibis-gear.shop/mcp

Конектор працює лише на читання. Він відповідає на питання про каталог: що є в наявності, скільки коштує, як змінювалася ціна, що пишуть покупці і що підходить під конкретну стрілецьку дисципліну. Він не може оформити замовлення, прийняти оплату чи змінити щось у магазині — коли покупець визначився, конектор дає посилання на картку товару на https://ibis.net.ua.

Навіщо це

Спорядження купують за характеристиками. У вудлища є довжина, тест і стрій; у спальника — температура комфорту; у куртки — мембрана й проклейка швів; у прицілу — кратність, об'єктив і сітка. Що саме підійде, залежить від того, як людина цим користується, а це розмова, а не фільтр.

Конектор дозволяє спитати своїми словами — «спінінг на окуня до 2 500 ₴», «двомісний намет, який тримає справжній вітер», «черевики, щоб висидіти січневу засідку» — і отримати відповідь із живого каталогу, а не здогад.

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

Знайти товари за описом, брендом, категорією, ціновим діапазоном чи наявністю.
Відкрити повну картку: характеристики, шлях у категоріях, рейтинг.
Подивитися, як рухалася ціна за останні місяці, перш ніж купувати.
Прочитати відгуки покупців разом із відповідями магазину.
Окремо для стрільби — підібрати спорядження під дисципліну за правилами самого магазину.

Дані

Джерело: Публічний каталог https://ibis.net.ua, який веде Ibis.
Обсяг: Близько 132 000 товарних позицій у 71 000 товарів, 1 300+ брендів, 1 000+ категорій.
Асортимент: Рибальство (~52 тис. позицій), одяг та взуття (~38 тис.), спорядження для туризму (~20 тис.), зброя з оптикою та боєприпасами (~13 тис.), товари для військових (~9 тис.), ножі та ліхтарі (~8 тис.), подарунки (~2 тис.).
Свіжість: Ціни й наявність асортименту оновлюються щодня з товарного фіду магазину; ширший каталог — за повільнішим циклом.
Валюта: Усі ціни — гривні (UAH).
Мова: Назви, описи й відгуки українською, як їх публікує магазин.

Каталог — це знімок, а не каса. Наявність і ціни можуть відставати від магазину до доби. Сервер повідомляє про це у власних інструкціях, тож модель попереджає користувача, коли питання впирається в актуальність. Перед тим як покластися на ціну, перевіряйте на https://ibis.net.ua.

Інструменти

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

search_products catalog:read

Search the ibis.net.ua catalogue by name, brand, category and availability. Returns name, price in hryvnia, availability, brand and a link to the product page, together with the total number of matches.

get_product catalog:read

Full product card by id: description, specifications, category path, rating and a couple of photos.

get_price_history prices:read

Price history of a product over the given period: observation points, the minimum, the maximum and the current value.

list_categories catalog:read

The shop's category tree with the number of products at each node. An empty parent returns the roots.

list_brands catalog:read

The shop's brands with the number of items each carries. The optional query filters by name.

get_reviews reviews:read

Customer reviews of a product together with the shop's replies: rating, text, date, reply threads.

get_product_images images:read

Product photos: temporary signed URLs valid for about an hour, and the images themselves as image content blocks.

get_sport_profile catalog:read

The shop's equipment profile for a shooting discipline: selection rules (magnification, reticle, objective), ready-made filter values and a list of related guides. An empty sport returns the list of known disciplines.

Промпти

/find-product — Підбір товару: пошук, порівняння кандидатів, перевірка історії ціни, підсумок.
/compare-variants — Порівняння двох і більше позицій — характеристики, ціни, відгуки, висновок.
/price-watch — Динаміка ціни: тренд, мінімум і максимум, купувати чи чекати.
/advise — Підбір спорядження під стрілецьку дисципліну за правилами самого магазину.

Ресурси

Каталог також читається як документи, а не лише викликається як інструменти:

catalog://about — Зведення про каталог — обсяг, охоплення, свіжість знімка.
catalog://brands — Усі бренди з кількістю позицій.
catalog://variant/{id} — Картка товару як markdown-документ.
catalog://category/{code} — Категорія як markdown-документ.
catalog://guides — Опубліковані експертні гайди.

Картка товару в чаті

Сервер віддає ресурс MCP Apps UI — ui://ibis/product-card, який малює товар прямо в розмові з фото й ціною і вміє дозапитати історію ціни. Клієнти без підтримки MCP Apps отримують звичайний структурований вміст і втрачають лише оформлення.

Автентифікація

Вхід не потрібен. Конектор віддає каталог товарів — те саме, що будь-хто читає на сайті, — тож не треба ні реєструватися, ні вставляти ключ. Підключіть і питайте.

Клієнт отримує права лише на читання (catalog:read, prices:read, reviews:read, images:read) і обмеження кількості запитів на адресу. Права на запис не існує в принципі: сервер не вміє нічого змінювати.

Оскільки вхід не потрібен, сервер не оголошує сервер авторизації: документи OAuth-discovery та ендпоінти /oauth/* у цій конфігурації відповідають 404, тож клієнт підключається напряму, а не проходить через екран згоди, який йому не потрібен. Реалізація OAuth 2.1 за цим перемикачем існує — метадані захищеного ресурсу (RFC 9728), метадані сервера авторизації (RFC 8414), динамічна реєстрація клієнтів (RFC 7591), PKCE S256, refresh-токени, resource indicators і відкликання (RFC 7009) — і буде увімкнена, якщо конектор колись почне зберігати щось, що належить конкретному користувачу. Організація, якій уже сьогодні потрібен іменований креденшл із власним лімітом, може запросити статичний API-ключ.

Налаштування для організації

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

Питання, на яких зазвичай зупиняється погодження:

Дані вашої організації нікуди не йдуть. Конектор читає публічний каталог товарів. Він отримує лише те, що людина шукає, — без облікового запису, історії розмови й файлів.
Записати нічого не можна. Усі інструменти лише читають; права на запис клієнтам із каталогу конекторів не видаються.
Запити обмежені за частотою на кожен креденшл, а ліміт і підказку про повтор клієнт отримує в самій помилці — некоректний клієнт деградує, а не заважає іншим.
Строк зберігання журналу викликів описано в політиці конфіденційності.

Якщо організації потрібен окремий креденшл, інший ліміт або підписана угода — пишіть на ibisarms@pm.me.

Обмеження

Один пошук повертає щонайбільше 50 позицій; разом із ними йде загальна кількість збігів, щоб модель запропонувала звузити фільтри, а не гортала наосліп.
Посилання на фото підписані й діють близько години.
Історія ціни типово за 180 днів.

Підтримка

Питання, звіти про помилки та запити на доступ — сторінка підтримки.