Конектор 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 catalogue by name, brand, category and availability. Returns name, price in hryvnia, availability with the time it was last confirmed, 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, price and availability with the time it was last confirmed.

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 previews of the first few 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 отримують звичайний структурований вміст і втрачають лише оформлення.

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

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

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

Оскільки вхід не потрібен, сервера авторизації немає: документи OAuth-discovery та шляхи /oauth/* відповідають 404, тож клієнт підключається напряму, а не проходить через екран згоди, який йому не потрібен. Якщо конектор колись почне зберігати щось, що належить конкретному користувачу, перед цим буде додано OAuth 2.1.

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

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

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

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

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

Обмеження

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

Підтримка

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