> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.foks.ai/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/chatgpt-image-7-avg-2026-g-131_1ajux3p.png)

## Зміст
* [Що таке MCP простими словами](#2-sho-take-mcp-prostimi-slovami)
* [Що таке MCP FOKS](#2-sho-take-mcp-foks)
* [Як це працює](#2-yak-ce-pracyuye)
* [Що вміє AI-агент](#2-sho-vmiye-ai-agent)
* [З якими маркетплейсами й мовами працює](#2-z-yakimi-marketplejsami-j-movami-pracyuye)
* [Практичні сценарії](#2-praktichni-scenariyi)
* [Безпека та контроль](#2-bezpeka-ta-kontrol)
* [Токени: як формується вартість роботи AI](#2-tokeni-yak-formuyetsya-vartist-roboti-ai)
* [Що потрібно для підключення](#2-sho-potribno-dlya-pidklyuchennya)
* [FAQ](#2-faq)
* [Корисні статті](#2-korisni-statti)

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

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

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

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

## Що таке MCP FOKS

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/8f2e5e5a-5630-418d-ba73-7baf45_114xn33.png)

## Як це працює

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

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/98bd1fac-64f9-4733-8e03-bf1c1e_176043d.png)

## Що вміє 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), виробники, мітки товарів і профілі прайсів.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/ca116a43-561d-4f74-a212-45d4eb_1cwrpo4.png)

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

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

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

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/chatgpt-image-7-avg-2026-g-133_998pkc.png)

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/chatgpt-image-7-avg-2026-g-133_12crkx1.png)

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

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/chatgpt-image-7-avg-2026-g-134_178ersh.png)

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

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

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

## FAQ

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

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

* [Як підключити MCP-доступ (AI-асистента) у FOKS](https://help.foks.ai/uk/article/yak-pidklyuchiti-mcp-dostup-ai-asistenta-u-foks-gq1clb/)
* [Підключення MCP FOKS через Claude Code](https://help.foks.ai/uk/article/pidklyuchennya-claude-code-do-foks-cherez-mcp-1r4bmct/)
* [Підключення MCP FOKS через ChatGPT Codex](https://help.foks.ai/uk/article/pidklyuchennya-chat-gpt-codex-do-foks-cherez-mcp-lacdbv/)