Статті на: MCP та підключення ШІ

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

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




Що таке 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.
  2. Оберіть версію під свою операційну систему (Windows або macOS) і завантажте інсталятор.



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



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


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


У Claude Desktop є окрема вкладка Code — саме там працює Claude Code.

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



Крок 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.



  1. 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.



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


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


  1. Впишіть туди ваші облікові дані FOKS у форматі:
  •   FOKS_LOGIN=Ваш_логін
  •   FOKS_PASSWORD=Ваш_пароль
  1. Збережіть файл.


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


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


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


Підключись до MCP-сервера https://my.foks.biz/mcp.
Використай логін та пароль із файлу .env для Basic Auth-автентифікації.


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.



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


Приклади задач, які можна доручити 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 сам підкаже наступний крок або виконає його автоматично.

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

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

Поділіться своїм відгуком

Скасувати

Дякуємо!