MCP FOKS: AI-агент для карток товарів на маркетплейсах — що це та як працює

AI-агент читає й редагує Ваші картки товарів у FOKS звичайною мовою: ціни, залишки, назви, описи, характеристики й категорії — одразу для всіх маркетплейсів. Ця стаття пояснює, що таке MCP, як працює MCP FOKS, чим він зручний і як його підключити.

Кому підійде: продавцям на маркетплейсах, які ведуть асортимент у FOKS і хочуть автоматизувати рутину заповнення та локалізації карток за допомогою AI (Claude Code, ChatGPT Codex та інших сумісних клієнтів).

Що таке MCP простими словами

MCP (Model Context Protocol) — це стандартний «місток», який з'єднує AI-асистента з Вашим кабінетом FOKS.

Сам по собі AI вміє розуміти мову й міркувати, але не має доступу до Вашої системи. MCP дає йому набір безпечних дій — інструментів, — якими він користується за Вашою командою. Образно кажучи: AI — це «розум», а MCP — його «руки» всередині FOKS.

Головна ідея: Ви керуєте товарами й маркетплейсами звичайною мовою, а не через десятки меню, вкладок і ручних операцій.

Що таке MCP FOKS

MCP FOKS — це реалізація протоколу MCP на боці платформи FOKS. FOKS — єдина PIM-база товарних карток для всіх Ваших маркетплейсів. MCP FOKS відкриває цю базу для AI-агента: він під'єднується напряму до Вашого кабінету й працює з картками як оператор — лише швидше та без втоми.

Що це дає на практиці:

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

Як це працює

Ланцюжок роботи простий:

Ви даєте текстову команду AI-агенту (наприклад, «онови ціну цих 5 товарів на +10%»).
AI-агент обирає потрібний інструмент і звертається до сервера FOKS через протокол MCP.
Сервер FOKS виконує дію у Вашій базі карток.
Агент повертає Вам результат і показує, що саме змінив.

Технічні деталі підключення:

Ендпоінт: AI звертається до https://my.foks.biz/mcp захищеним каналом.
Авторизація: Basic Auth за логіном і паролем Вашого акаунта FOKS.
Ізоляція: усі дії виконуються лише в межах Вашого акаунта — агент не бачить чужих даних.
Формат обміну: структуровані запити JSON-RPC; для кожної задачі агент викликає окремий інструмент і отримує результат.

Важливо: усі зміни лишаються всередині FOKS — наружу на маркетплейс нічого не вивантажується без Вашої окремої дії.

Що вміє AI-агент

Під капотом MCP FOKS надає агенту набір інструментів. Ось повний перелік за групами.

Перегляд і пошук (читання):

search_products — пошук товарів за фільтрами (бренд, ціна, наявність, статус тощо).
get_product — дані картки: назви, описи, категорії, характеристики, ціна, залишок.
list_marketplace_categories — категорії маркетплейсу.
list_marketplace_features — характеристики категорії маркетплейсу.
list_marketplace_feature_values — дозволені значення характеристики.
resolve_marketplace_feature — перетворення ID на читабельні назви.

Робота з товарами:

create_product — створення нового товару, зокрема з фото за посиланням.
copy_product — копіювання наявного товару.
update_product_data — зміна цін, залишку, назв і описів, у тому числі окремих для кожного маркетплейсу.
update_product_feature — заповнення характеристик товару.

Налаштування маркетплейсів:

update_category_mapping — призначення категорії маркетплейсу.
copy_vendor_category — копіювання категорії постачальника між маркетплейсами.
update_feature_mapping — зіставлення характеристики прайсу з характеристикою маркетплейсу.
update_feature_value_mapping — зіставлення значень характеристик.

Службовий:

hello — перевірка з'єднання й авторизації.

Крім інструментів, агент користується довідниками, щоб працювати з коректними значеннями: список маркетплейсів, мови (ua, ru), виробники, мітки товарів і профілі прайсів.

З якими маркетплейсами й мовами працює

AI-агент працює з усіма площадками, підключеними до Вашого кабінету FOKS. Серед них: Rozetka, Allo, Epicentr, Eva, Kasta, Prom, Hotline, Мономаркет, Joom, F.ua.

Ключові можливості охоплення:

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

Практичні сценарії

Масові зміни цін. «Підніми ціну на 10% для всіх ноутбуків» — окремо для кожного маркетплейсу.
Заповнення карток. Агент бере характеристики з прайсу й сам зіставляє їх із вимогами Rozetka, Prom, Epicentr та інших площадок.
Локалізація рос → укр. Агент читає значення характеристик, готує коректні українські відповідники за довідником площадки й записує українську версію в картку без ручного вводу.
Перенесення асортименту. Товар оформлено на Rozetka — агент копіює категорію постачальника, налаштовує маппінг і підтягує характеристики й описи, щоб швидко завести той самий асортимент на новій площадці.
Унікальний контент. Різні описи під кожен маркетплейс, щоб уникнути санкцій за дублювання.
Створення й копіювання карток із фото за посиланням.

Безпека та контроль

Ви контролюєте кожен крок:

Усе всередині FOKS. Редагування назв, описів і характеристик відбувається лише у Вашій базі.
Наружу — лише з підтвердженням. Перезалив на маркетплейс і зміна маппінгу виконуються тільки за Вашою явною командою.
Захищене з'єднання. Доступ через HTTPS та Basic Auth під Вашим акаунтом; персональні дані не покидають Ваш контур.
Прозорість дій. Агент показує, що саме змінив і де — нічого не відбувається «мовчки».
Обмежений набір дій. Агент виконує лише ті дії, які є в переліку інструментів, — нічого поза цим списком.

Токени: як формується вартість роботи AI

Токени — це «одиниці тексту», якими вимірюється робота AI. Увесь текст (Ваша команда + дані з FOKS + відповідь) розбивається на токени (приблизно 1 слово = 1–2 токени), і робота тарифікується за їхньою кількістю.

Що це означає на практиці:

Точкові запити («онови ціну цих 5 товарів») коштують дешевше, ніж «вивантаж усе».
MCP FOKS спроєктований економно: пошук повертає лише ідентифікатори товарів, а деталі підвантажуються за потреби. Це заощаджує токени й гроші.

Що потрібно для підключення

Для роботи з AI-агентом потрібні дві активні підписки:

Активна підписка FOKS — доступ до платформи й Вашої бази карток.
Активна підписка MCP FOKS — доступ до MCP-ендпоінта для AI-агента.

Також знадобиться AI-клієнт із підтримкою MCP і облікові дані Вашого акаунта FOKS для авторизації.

FAQ

Чи оновлюється набір інструментів і чи треба щось встановлювати? Ні, встановлювати нічого не потрібно: інструменти живуть на сервері FOKS. Коли команда додає новий інструмент чи поле, воно автоматично стає доступним усім — агент отримує актуальний набір при кожному підключенні. Набір розвивається за реальними запитами продавців.
Чи змінить агент щось на маркетплейсі без мене? Ні — перезалив на маркетплейс виконується тільки за Вашою явною командою.
Чи бачить агент дані інших акаунтів? Ні. Агент працює лише з Вашим акаунтом за Вашими обліковими даними.
Які AI-клієнти підтримуються? Будь-який клієнт із підтримкою MCP. Найпоширеніші варіанти — Claude Code, ChatGPT Codex.

Корисні статті

Оновлено: 07/08/2026

Чи була ця стаття корисною?

Дякуємо!