> ## 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).

# Підключення Claude Code до FOKS через MCP

## Ця інструкція демонструє, як за кілька хвилин підключити Claude Code до Вашого кабінету FOKS через MCP (Model Context Protocol) і почати доручати ШІ рутинні задачі з картками товарів — переклад характеристик, заповнення описів, перенесення категорій між маркетплейсами.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/chatgpt-image-20-iyul-2026-g-1_11j5qob.png)

* [Що таке Claude, Claude Desktop і Claude Code](#2-sho-take-claude-claude-desktop-i-claude-code)
* [Перед початком](#2-pered-pochatkom)
* [Крок 1. Встановіть Claude Desktop](#2-krok-1-vstanovit-claude-desktop)
* [Крок 2. Відкрийте Claude Code](#2-krok-2-vidkrijte-claude-code)
* [Крок 3. Створіть папку проєкту на комп'ютері](#2-krok-3-stvorit-papku-proyektu-na-kompyuteri)
* [Крок 4. Попросіть Claude Code підготувати структуру проєкту](#2-krok-4-poprosit-claude-code-pidgotuvati-strukturu-proyektu)
* [Крок 5. Заповніть файл .env](#2-krok-5-zapovnit-fajl-env)
* [Крок 6. Підключіть Claude Code до MCP-сервера FOKS](#2-krok-6-pidklyuchit-claude-code-do-mcp-servera-foks)
* [Починайте працювати](#2-pochinajte-pracyuvati)
* [Поширені проблеми](#2-poshireni-problemi)
* [Якщо виникають труднощі](#2-yaksho-vinikayut-trudnoshi)

## **Що таке Claude, Claude Desktop і Claude Code**

Перш ніж почати, варто розуміти три пов'язані, але різні речі:
* **Claude** — це сімейство мовних моделей ШІ від компанії Anthropic. Саме Claude «розуміє» ваші запити та виконує задачі.
* **Claude Desktop** — десктопний застосунок для Windows і macOS, через який ви спілкуєтесь із Claude у звичному чат-інтерфейсі, а також отримуєте доступ до інших інструментів, зокрема до вкладки **Code**.
* **Claude Code** — агентний інструмент для роботи з даними, файлами та зовнішніми сервісами через командний рядок. Саме Claude Code вміє підключатися до MCP-серверів (таких, як FOKS MCP) і виконувати в них дії: шукати товари, редагувати картки, переносити категорії.
Простими словами: Claude Desktop — це «вхідні двері», а Claude Code — «робочий інструмент» усередині цих дверей, який і буде виконувати задачі у вашому кабінеті FOKS.

## **Перед початком**

Підготуйте наступні дані:
* **Активний тарифний план FOKS** — доступ до функціоналу кабінету має бути оплачений.
* **Активна підписка до MCP FOKS** — окрема підписка, без якої MCP-сервер не надасть доступ до Ваших карток товарів.
* **Логін і пароль від вашого кабінету FOKS** (ті самі дані, якими ви заходите на my.foks.biz).
* **Windows 10/11 або macOS**, стабільне інтернет-з'єднання.

**Важливо.** Ніколи не вводьте логін і пароль від FOKS прямо в повідомленні чату. У кроці 4 нижче показано, як зберегти їх безпечно у файлі .env, який Claude Code читає локально й не показує третім особам.

## **Крок 1. Встановіть Claude Desktop**

1. Перейдіть на сторінку завантаження: [__claude.com/download__](http://claude.com/download). 
2. Оберіть версію під свою операційну систему (Windows або macOS) і завантажте інсталятор.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl1_tcdb7k.png)

3. Запустіть встановлення, дотримуючись стандартних кроків майстра встановлення.
4. Відкрийте Claude Desktop і увійдіть у свій обліковий запис Anthropic (або зареєструйтесь, якщо облікового запису ще немає).

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl2_zqjs15.png)

**Примітка.** Під час встановлення система може попросити дозвіл на встановлення застосунку (стандартне вікно macOS/Windows «Дозволити встановлення від невідомого розробника» тощо) — це нормально, підтвердіть встановлення.

## **Крок 2. Відкрийте Claude Code**

У Claude Desktop є окрема вкладка **Code** — саме там працює Claude Code.
1. У боковій панелі Claude Desktop натисніть на вкладку **Code**.
2. Якщо застосунок попросить встановити додаткові компоненти (наприклад, командний рядок Claude Code) — погодьтесь, це частина стандартного встановлення й займає лише кілька секунд.
3. Після завершення встановлення ви побачите інтерфейс Claude Code — робочу область із чатом і файловою системою проєкту.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl3_1fyrmxs.png)

## **Крок 3. Створіть папку проєкту на комп'ютері**

На відміну від Claude Desktop, Claude Code **не створює проєкт «зсередини»** — спочатку потрібно підготувати звичайну папку на вашому комп'ютері, а вже потім вказати Claude Code працювати саме з нею.

1. На робочому столі (або в будь-якому зручному місці — наприклад, «Документи») створіть нову папку через провідник Windows або Finder на macOS. Назвіть її, наприклад: foks-mcp.
2. Поверніться в Claude Desktop, відкрийте вкладку **Code**.
3. Натисніть **Select folder** (або **New session** → **Select folder**) і оберіть щойно створену папку foks-mcp.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl4_5056di.png)

4. Claude Code відкриє сесію, прив'язану саме до цієї папки. Тепер усі файли, які створюватиме Claude Code (у тому числі .env), з'являться саме тут.

**Примітка.** Якщо пізніше захочете підключити ще один сервіс (наприклад, іншу систему), краще створити для нього окрему папку в провіднику та так само вибрати її через **Select folder** — Claude Code працює з тим, що знаходиться в поточній обраній папці, і не змішує різні проєкти автоматично.

## **Крок 4. Попросіть Claude Code підготувати структуру проєкту**

Тепер, коли Claude Code відкрив папку foks-mcp, напишіть у чаті:

> Створи структуру проєкту для роботи з MCP-сервером. Додай файл .env для зберігання логіна та пароля.Якщо потрібно — створи інші файли для коректної роботи з MCP та Basic Auth.

Claude Code самостійно створить потрібні файли всередині папки foks-mcp.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl5_1tzswmi.png)

## **Крок 5. Заповніть файл .env**

1. Відкрийте створений файл .env (Claude Code покаже його у файловій системі проєкту справа).

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl6_70qss6.png)
2. Впишіть туди ваші облікові дані FOKS у форматі:
*   FOKS_LOGIN=Ваш_логін
*   FOKS_PASSWORD=Ваш_пароль
3. Збережіть файл.

Дані у файлі .env лишаються локально на Вашому комп'ютері, у папці foks-mcp, і не потрапляють у листування чи в саму модель напряму — Claude Code лише читає їх, щоб під'єднатися до сервера.

## **Крок 6. Підключіть Claude Code до MCP-сервера FOKS**

Напишіть у чаті проєкту:

> Підключиcь до MCP-сервера FOKS.
> URL: https://my.foks.biz/mcp,  Автентифікація — Basic Auth. Логін і пароль візьми з файлу .env і сформуй з них Basic-заголовок.
> Повідом результат підключення.


Claude Code самостійно сформує та виконає потрібну команду в терміналі.

Кодування логіна й пароля в base64 Claude Code виконає сам — Вам не потрібно робити це вручну.

Після успішного підключення, Ви маєте побачити перелік інструментів FOKS MCP — зокрема:
```
get_product, search_products, update_product_name, update_product_description, update_feature, copy_vendor_category, update_category_mapping.
```

Якщо список порожній або з'явилась помилка авторизації — перевірте правильність логіна й пароля у файлі .env та повторіть крок 6.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/a/2/8/2a28879fe335ec00/fokscl7_1kwmtcj.png)

## **Починайте працювати**

Приклади задач, які можна доручити Claude Code після підключення:
* Знайди товар з Offer ID 46056 та встанови для нього релевантні назву й опис українською мовою для маркетплейсу Mономаркет.
* Онови опис товару, зроби його інформативнішим і додай ключові характеристики з картки.
* Допоможи налаштувати мапінг категорій постачальника до категорії маркетплейсу Rozetka.

**Нагадування.** Усі зміни, які Claude Code вносить через MCP, лишаються всередині вашого кабінету FOKS. Публікація на маркетплейс (перезалив картки) відбувається лише за вашою окремою явною командою — автоматично назовні нічого не публікується.

## **Поширені проблеми**

* **«MCP-сервер не відповідає» / помилка з'єднання** — перевірте інтернет-з'єднання та правильність URL https://my.foks.biz/mcp у команді підключення.
* **«Unauthorized» / «401»** — логін або пароль у .env введено з помилкою, або дані застарілі. Оновіть файл .env і попросіть Claude Code перепідключитися.
* **Claude Code просить встановити Node.js або інші компоненти** — це стандартна частина встановлення для деяких способів запуску Claude Code; погодьтесь на встановлення, це займе кілька хвилин.
* **Інструменти FOKS не з'являються після підключення** — попросіть Claude Code: «Перепідключись до MCP FOKS і онови список інструментів».

## **Якщо виникають труднощі**

Кожен ШІ-інструмент має власні особливості налаштування. Якщо якийсь крок не вдається виконати — найпростіше запитати про це самого Claude Code:
* «Як мені підключити MCP-сервер?»
* «Допоможи створити файл .env.»
* «Чому не вдається підключитися до MCP?»
* «Перевір мою конфігурацію MCP.»

У більшості випадків Claude Code сам підкаже наступний крок або виконає його автоматично.