🤖 MCP та ШІ-асистент#

Bidding Fox підтримує Model Context Protocol (MCP). Завдяки йому до даних вашого проєкту отримає доступ ШІ-асистент, наприклад Claude, ChatGPT, Cursor або Claude Code, і ви можете ставити йому запитання звичайною мовою, замість того щоб вручну шукати цифри в інтерфейсі.

Інструкція з підключення є безпосередньо в застосунку: на сторінці Налаштування у розділі AI / MCP натисніть How to?. Відкриється панель з адресою MCP-сервера, порядком створення токена доступу і прикладами конфігурації для окремих ШІ-клієнтів.

Для чого підходить MCP#

ШІ-асистент через MCP працює з даними конкретного проєкту, тож підходить насамперед для швидких запитів і перевірок, для яких ви інакше перебирали б фільтри та експорти:

«Скільки товарів зараз потрапляє до моєї стратегії на TOP-товари?»
«Виведи товари, у яких CPC вищий за половину ціни.»
«Підсумуй, як за останній місяць змінювалося PNO.»
«Яке налаштування проєкту змінювалося востаннє і ким?»
«Знайди товари, у яких конкретний конкурент дешевший.»

Обсяг того, що асистент зможе, залежить від інструментів, які Bidding Fox пропонує через MCP, і від прав доступу використаного токена.

Адреса сервера та авторизація#

Параметр	Значення
MCP-сервер	`https://app.bdfx.cz/mcp`
Авторизація	Mergado PAT у заголовку `Authorization: Bearer <ваш-токен>`, у вебклієнтів OAuth
Обсяг прав	відповідно до прав доступу токена та ваших прав у Bidding Fox

Як отримати токен доступу (PAT)#

Увійдіть у свій обліковий запис у Mergado.
У налаштуваннях профілю відкрийте розділ API and Access.
У частині Personal access tokens натисніть Add і заповніть потрібні поля. Радимо встановити максимальний строк дії та права доступу відповідно до того, що має робити асистент.
Натисніть Create token і скопіюйте згенерований токен.

⚠️ Після закриття сторінки токен більше не відобразиться. Якщо ви його втратите, доведеться створити новий. Поводьтеся з ним як із паролем: не діліться ним у чаті, електронній пошті чи публічних репозиторіях.

Подробиці про токени знайдете у статті Персональний токен доступу (PAT).

Підключення до ШІ-клієнтів#

ChatGPT і Claude у вебінтерфейсі#

Скористайтеся опцією власний конектор (у ChatGPT — плагін), як адресу введіть https://app.bdfx.cz/mcp, а як авторизацію виберіть OAUTH. Після підключення застосунок перенаправить вас на форму, куди ви вставите свій Mergado PAT.

VSCode#

Вставте в конфігурацію наведені нижче налаштування і замініть mergado_pat_token своїм токеном:

{
  "servers": {
    "bidding-fox": {
      "url": "https://app.bdfx.cz/mcp",
      "type": "http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "Authorization": "Bearer mergado_pat_token"
      }
    }
  },
  "inputs": []
}

Claude Code#

Вставте в консоль команду і замініть mergado_pat_token своїм токеном:

claude mcp add --transport http bidding-fox https://app.bdfx.cz/mcp \
  --header "Authorization: Bearer mergado_pat_token"

З чим вам допоможе ШІ-асистент#

Сфера	Що асистент зможе
Товари	Шукати товари й читати їхні деталі (ціна, CPC, позиція, статистика), працювати зі збереженими фільтрами та мітками.
Стратегії та налаштування	Виводити стратегії та налаштування проєкту, пояснювати, чим керуються ставки, перевіряти коректність налаштувань і переглядати їхню історію.
Діагностика і звіти	Читати огляд проєкту, звіти й метрики, зокрема їхню динаміку в часі.
Конкуренція	Виводити конкурентів і порівнювати, де ви дорожчі чи дешевші.
Експорти й події	Виводити створені експорти і переглядати події в проєкті.

Зміни асистент вносить лише там, де це дозволяють доступні інструменти та права доступу токена, і завжди на підставі вашого запиту.

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

Часті запитання#

Де знайти адресу сервера та інструкцію? На сторінці Налаштування у розділі AI / MCP під кнопкою How to?. Адреса сервера — https://app.bdfx.cz/mcp.
Що потрібно для підключення? Mergado PAT з відповідними правами доступу та ШІ-клієнт, який підтримує MCP через HTTP.
ШІ-клієнт повідомляє про помилку авторизації. Перевірте, чи токен вставлено повністю, чи не закінчився строк його дії і чи він у заголовку у форматі Authorization: Bearer <token>.
Чи може ШІ-асистент змінювати налаштування ставок? Так, якщо це дозволяють доступні інструменти та права доступу токена. Якщо ви хочете лише перевіряти й читати дані, створіть токен лише з правами на читання.
Чи потрібно казати асистентові, про який проєкт ідеться? Так. Інструменти Bidding Fox працюють із конкретним проєктом, тож у запиті завжди вказуйте, з яким проєктом він має працювати.