MCP: підключення Pricing Fox до ШІ-асистента#

Підключення MCP дає змогу з’єднати Pricing Fox зі ШІ-клієнтом, як-от Claude Desktop, Claude Code, Cursor, або іншими інструментами з підтримкою Model Context Protocol.

Завдяки MCP ШІ-асистент може безпечно отримувати доступ до даних вашого проєкту і допомагати вам керувати ними за допомогою звичайних завдань природною мовою. Тож не потрібно все шукати вручну в інтерфейсі застосунку — про окремі речі можна просто запитати ШІ-асистента.

Можна запитати його, наприклад:

  1. «Скільки товарів зараз обробляється в проєкті?»

  2. «Знайди мені товари з низькою маржею.»

  3. «Виведи мені правила, які використовуються для переоцінки.»

  4. «Перевір, чи є в проєкті товари без закупівельної ціни.»

  5. «Підсумуй мені, що змінилося в проєкті за останні 30 днів.»

  6. «Знайди товари, які дешевші, ніж у конкурентів.»

Доступні можливості завжди залежать від того, які інструменти MCP має Pricing Fox для цього проєкту і які дозволи має використаний токен доступу.

Що таке MCP#

MCP — це скорочення від Model Context Protocol. Це стандарт комунікації, який дає змогу ШІ-інструментам безпечно працювати із зовнішніми застосунками, сервісами і даними.

На практиці це означає, що ШІ-асистент може відповідати не лише на основі загальних знань. Після підключення через MCP він може працювати з конкретними даними вашого проєкту в Pricing Fox і виконувати з ними доступні дії.

Простіше кажучи:

MCP — це міст між Pricing Fox і вашим ШІ-клієнтом. Завдяки йому ШІ-асистент отримує доступ до вибраних інструментів Pricing Fox і може використовувати їх відповідно до вашого завдання.

Для чого знадобиться MCP#

MCP знадобиться передусім тоді, коли ви хочете працювати з проєктом швидше, природніше або в більшому обсязі.

Замість того щоб клацати в застосунку вручну, ви можете поставити ШІ-асистентові запитання або дати завдання.

Зазвичай це може знадобитися, наприклад, для:

  1. швидкої перевірки товарів,

  2. пошуку проблемних позицій,

  3. перевірки маржі,

  4. роботи з правилами,

  5. орієнтування в переоцінці,

  6. підсумку ефективності проєкту,

  7. аналізу асортименту,

  8. перевірки конкурентів,

  9. підготовки матеріалів для подальшої роботи.

Приклад:

Замість того щоб вручну фільтрувати товари за маржею, ви можете запитати ШІ-асистента:

Знайди мені товари з маржею нижче 10 % і відсортуй їх за оборотом.

ШІ-клієнт через MCP попросить у Pricing Fox відповідні дані і поверне вам результат безпосередньо в розмові.

Де знайти MCP у Pricing Fox#

MCP у Pricing Fox ви знайдете в кількох місцях.

1. У налаштуваннях проєкту#

MCP відображається в частині Settings у блоці Active connections.

Серед інших підключень тут ви знайдете картку MCP. Клацнувши на іконку зі знаком питання, ви відкриєте бічну панель з інструкцією з підключення. У ній ви знайдете основну інформацію про MCP, адресу MCP-сервера Pricing Fox і порядок підключення до вибраних ШІ-клієнтів.

2. На сторінці «Підключення»#

MCP ви знайдете також на сторінці Connections, а саме в частині Input data sources.

Воно відображається тут серед інших вхідних підключень, як-от Mergado, Heureka, Zboží.cz, Google Merchant, Google Analytics 4, Shoptet або власне джерело CSV.

MCP тут віднесено до вхідних підключень, бо воно дає змогу ШІ-клієнтові отримувати доступ до даних проєкту через Model Context Protocol.

Тож це не класичне джерело даних про товари чи статистики, а технічне з’єднання між Pricing Fox і ШІ-асистентом.

Клацнувши на іконку зі знаком питання на картці MCP, ви відкриєте ту саму інформаційну панель з інструкцією з підключення.

3. На сторінці «Огляд»#

MCP відображається також на головній сторінці Overview у блоці Active connections.

Завдяки цьому ви одразу бачите, що MCP входить до активних підключень проєкту. Як і для інших підключень, картка тут показує стан з’єднання і дає змогу швидко зорієнтуватися, які джерела і виходи проєкт зараз має.

Якщо біля MCP ви бачите інформаційну іконку, через неї можна відкрити інструкцію з налаштування з’єднання зі ШІ-клієнтом.

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

Що ви знайдете в панелі MCP?#

У панелі ви знайдете:

  1. стисле пояснення, для чого слугує MCP,

  2. адресу MCP-сервера Pricing Fox,

  3. порядок отримання токена доступу,

  4. приклад конфігурації для VSCode,

  5. приклад підключення для Claude Code

Технічно:

MCP-сервер працює за адресою:

https://app-pf.bdfx.cz/mcp

Цю адресу ви вставите в налаштування ШІ-клієнта, який хочете з’єднати з Pricing Fox.

Як працює з’єднання#

З’єднання відбувається через MCP-сервер Pricing Fox і токен доступу з Mergado.

Спрощено:

  1. У Mergado ви створюєте Personal Access Token, скорочено PAT.

  2. Токен вставляєте в конфігурацію свого ШІ-клієнта.

  3. ШІ-клієнт за допомогою токена підключається до MCP-сервера Pricing Fox.

  4. Pricing Fox перевіряє дозволи і відкриває доступні інструменти для роботи з проєктом.

Технічно:

Авторизація відбувається через HTTP-заголовок:

Authorization: Bearer mergado_pat_token

Токен слугує для перевірки того, що ШІ-клієнт має дозвіл працювати з даними проєкту. Обсяг доступних дій залежить від дозволів, призначених токену.

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

Щоб з’єднати Pricing Fox зі ШІ-клієнтом, потрібно створити токен доступу в Mergado.

Порядок дій:

  1. Увійдіть у свій обліковий запис у Mergado.

  2. Перейдіть у налаштування свого профілю.

  3. Відкрийте розділ API and Access.

  4. У частині Personal access tokens натисніть Add.

  5. Заповніть потрібні поля.

  6. Налаштуйте термін дії токена.

  7. Виберіть дозволи.

  8. Натисніть Create token.

  9. Скопіюйте згенерований токен і надійно збережіть його.

Важливо:

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

Рекомендовані налаштування токена#

У поточній інструкції в застосунку ми радимо налаштувати:

  • термін дії токена на максимальний доступний період,

  • дозволи відповідно до того, що ШІ-клієнт має робити в Pricing Fox.

Якщо ШІ-асистент має допомагати з повноцінним керуванням проєктом, йому знадобляться відповідні дозволи. Якщо ви хочете використовувати його лише для перевірки і читання даних, налаштуйте дозволи лише на читання там, де це має сенс.

Рекомендація щодо безпеки:

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

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

Після створення токена потрібно додати MCP-сервер Pricing Fox у конфігурацію ШІ-клієнта.

Конкретний порядок дій може відрізнятися залежно від того, який інструмент ви використовуєте. У застосунку ви знайдете приклад для VSCode і Claude Code.

Підключення у VSCode#

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

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

Після збереження конфігурації ШІ-клієнт має розпізнати MCP-сервер Pricing Fox і відкрити доступ до його інструментів.

Підключення в Claude Code#

У консоль вставте команду:

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

Значення mergado_pat_token замініть своїм справжнім токеном доступу.

Після підключення можна перевірити, чи доступний MCP-сервер, безпосередньо в Claude Code. Потім можна почати ставити запитання або давати завдання щодо вашого проєкту в Pricing Fox.

Що може робити ШІ-асистент через MCP#

ШІ-асистент може працювати лише з тими даними і функціями, до яких Pricing Fox відкриває йому доступ через MCP.

Він може допомогти вам, наприклад, у таких сферах:

Товари:

ШІ може допомогти з пошуком і перевіркою товарів за доступними параметрами.

Наприклад:

  1. товари з низькою або від’ємною маржею,

  2. товари без закупівельної ціни,

  3. товари без правила,

  4. товари зі значною зміною ціни,

  5. товари за джерелом референтної ціни,

  6. товари за позицією відносно конкурентів.

Правила:

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

Наприклад:

  1. вивести активні правила,

  2. підсумувати логіку конкретного правила,

  3. знайти товари, яких стосується правило,

  4. запропонувати, як перевірити правила

Статистика:

Якщо в проєкті є дані про ефективність, ШІ може допомогти з їх інтерпретацією.

Наприклад:

  1. підсумувати замовлення, оборот або кліки,

  2. знайти товари з високою ефективністю,

  3. порівняти ефективність вибраних груп,

  4. звернути увагу на значні зміни.

Конкуренти і референтні дані:

Якщо в проєкті є дані про конкурентів, ШІ може допомогти з їх оцінюванням.

Наприклад:

  1. знайти товари, у яких ваш інтернет-магазин дорожчий за конкурентів,

  2. знайти товари, у яких ви найдешевші,

  3. перевірити ціни за референтним джерелом,

  4. оцінити товари за позицією серед пропозицій.

Важливе обмеження: MCP працює в межах конкретного проєкту#

Pricing Fox MCP зараз працює з інструментами всередині конкретного проєкту. Це означає, що ШІ-клієнт не вміє вивести всі проєкти Pricing Fox, до яких у вас є доступ.

Іншими словами:

  • MCP уміє працювати з даними конкретного проєкту,

  • не вміє автоматично вивести список усіх ваших проєктів Pricing Fox,

  • для роботи потрібно визначити конкретний проєкт або працювати в його контексті.

Якщо ви хочете вирішувати зі ШІ-асистентом питання конкретного проєкту, варто чітко сказати йому в завданні, про який проєкт ідеться, або працювати в середовищі, де цей проєкт уже вибрано.

Безпека і робота з даними#

MCP-з’єднання дає ШІ-клієнтові доступ до даних проєкту, тому важливо працювати з ним обережно.

Радимо:

  • використовувати лише ШІ-клієнти, яким ви довіряєте,

  • зберігати токен надійно,

  • не ділитися токеном у чаті, електронній пошті чи публічних файлах,

  • регулярно перевіряти, де ви використовуєте токен,

  • скасувати токен, який вам уже не потрібен,

  • не вставляти в завдання для ШІ конфіденційні дані, якщо це не потрібно.

Технічно:

PAT слугує для авторизації запитів між ШІ-клієнтом і Pricing Fox. Якщо ви скасуєте токен або зміните його дозволи, це може вплинути і на роботу з’єднання.

Як зрозуміти, що MCP підключено правильно#

Після налаштування ШІ-клієнт має показати доступні інструменти MCP Pricing Fox або бути здатним відповісти на запитання щодо проєкту.

Можна спробувати, наприклад, просте запитання:

Перевір основну інформацію про поточний проєкт у Pricing Fox.

Або:

Виведи доступні інструменти Pricing Fox MCP.

Якщо ШІ-клієнт поверне помилку авторизації, перевірте передусім:

  • чи правильно скопійовано токен,

  • чи використовуєте ви в заголовку формат Bearer,

  • чи не скасовано токен і чи не минув його термін дії,

  • чи має токен потрібні дозволи,

  • чи правильно введено адресу MCP-сервера.

Найпоширеніші проблеми#

ШІ-клієнт повідомляє про помилку 401#

Помилка 401 зазвичай означає проблему з авторизацією.

Перевірте:

  • чи дійсний токен,

  • чи вставили ви його повністю,

  • чи вказано його в конфігурації в правильному форматі,

  • чи використовуєте ви заголовок Authorization: Bearer ....

ШІ-клієнт не бачить інструментів Pricing Fox#

Перевірте:

  • чи правильно введено адресу сервера,

  • чи підтримує ШІ-клієнт MCP через HTTP,

  • чи зберегли ви конфігурацію,

  • чи не потрібно перезапустити клієнт.

ШІ не може знайти всі проєкти#

Це очікувана поведінка. Pricing Fox MCP зараз працює не зі списком усіх проєктів, а з інструментами в межах конкретного проєкту.

ШІ не має доступу до деяких даних#

Причиною може бути:

  • брак дозволів токена,

  • недоступні дані в проєкті,

  • непідтримувана дія в поточному наборі інструментів MCP,

  • робота поза контекстом конкретного проєкту.

Практичні приклади використання#

Швидка перевірка проєкту#

Підсумуй мені поточний стан проєкту і зверни мою увагу на речі, які варто перевірити.

Перевірка маржі#

Знайди товари з маржею нижче 10 % і відсортуй їх від найнижчої маржі.

Перевірка правил#

Поясни мені, за якими правилами зараз переоцінюється проєкт.

Перевірка товарів без потрібних даних#

Знайди товари, у яких бракує закупівельної ціни або референтної ціни.

Аналіз конкурентів#

Знайди товари, у яких ми значно дорожчі за головних конкурентів.

Підсумок для команди#

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

Технічні примітки#

  • MCP-сервер Pricing Fox доступний за адресою https://app-pf.bdfx.cz/mcp.

  • Підключення відбувається через HTTP.

  • Авторизація відбувається за допомогою токена PAT з Mergado.

  • Токен передається в HTTP-заголовку Authorization.

  • ШІ-клієнт працює лише з інструментами, до яких Pricing Fox відкриває доступ через MCP.

  • Обсяг доступних дій залежить від дозволів токена.

  • Pricing Fox MCP зараз працює в контексті конкретного проєкту, а не над списком усіх проєктів.

  • Саме відкриття інструкції в застосунку жодних даних не змінює.

  • MCP-з’єднання не означає, що ШІ автоматично вносить зміни без вашого завдання — дії завжди залежать від доступних інструментів, дозволів і конкретного запиту в ШІ-клієнті.

Підсумок#

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

Для підключення достатньо:

  1. створити токен PAT у Mergado,

  2. вставити його в конфігурацію ШІ-клієнта,

  3. підключити MCP-сервер Pricing Fox,

  4. почати працювати з проєктом через ШІ-асистента.

MCP підходить передусім для користувачів, які хочуть керувати Pricing Fox ефективніше, швидше аналізувати дані і використовувати ШІ як помічника в щоденному керуванні ціноутворенням.

Назад Zboží.cz Вихід Вперед