Підключення Mergado до ШІ-агентів (ChatGPT, Claude, Cursor)#

Що таке MCP і навіщо ним користуватися?#

MCP (Model Context Protocol) — це стандарт, який дає змогу ШІ-агентам (ChatGPT, Claude, Cursor та інші) працювати з вашими даними і сервісами. Після підключення через MCP ШІ-агент може від вашого імені в Mergado читати проєкти, правила і статистику та відповідно до вашого завдання з ними працювати – усе це прямо в розмові з ШІ.

Замість того щоб вручну копіювати дані з Mergado до ШІ і назад, ШІ сам їх візьме і одразу поверне вам результат.

Mergado MCP HUB#

Через одне підключення MCP ви маєте в одному місці інструменти Mergado Editor і підключених розширень — не потрібно керувати кількома окремими з’єднаннями. Коли розширення змінить свої інструменти або додасть нові, це відобразиться автоматично, без повторного налаштування з вашого боку.

Наразі в HUB доступний Mergado Editor, розширення як-от Pricing Fox і Feed Image Editor додаватимуться поступово. Pricing Fox поки що має й власне окреме підключення MCP, яке залишається доступним і після включення в HUB — докладніше на pricing-fox.cz.

Приклади, що можна робити з ШІ після підключення#

• «Скільки товарів зараз має кожен мій проєкт?»
• «Мені потрібно побачити всі товари, які не мають заповненого EAN.»
• «Запусти аудит фіду в проєкті XY і підсумуй, що потрібно виправити.»
• «Мені потрібно змінити назву позиції, щоб вона мала структуру: виробник + назва позиції + розмір + колір.»

Що вміє сервер Mergado MCP#

Після підключення ШІ-агент отримує доступ до таких сфер даних і операцій у Mergado:

💡 Фільтрування за часом: під час створення вибірки — чи то безпосередньо в UI, через API (create_project_query + query_products), чи через інструмент MCP query_products — можна фільтрувати за віком товару у фіді (@@DAYS_IN_PROJECT) або за тим, як довго значення не змінювалося — @@DAYS_WITHOUT_INPUT_CHANGE (дні від останньої зміни на вході), @@DAYS_WITHOUT_OUTPUT_CHANGE (дні від останньої зміни на виході) і @@DAYS_WITHOUT_CHANGE (дні від новішої з двох попередніх змін). Корисно, наприклад, для виявлення новинок у фіді або товарів, яких давно ніхто не редагував.

Обсяг того, що ШІ може робити, визначається правами доступу (scopes) вашого токена доступу або авторизації OAuth – див. Безпека. Якщо, наприклад, ви надасте токену лише право «Read rules», ШІ зможе правила читати, але не змінювати чи видаляти.

Повний список окремих прав доступу (scopes) є в статті Персональний токен доступу (PAT).

💡 Порада для точнішої роботи з ШІ: Підключення MCP дає ШІ доступ до ваших даних у Mergado. Якщо ви хочете, щоб ШІ також глибоко знав правила, елементи і можливості Mergado – наприклад, точно знав, які правила існують і як їх правильно скласти, – додайте набори Mergado Skills:

• Mergado Skills – Context7
• Mergado Skills – GitHub

Можливості підключення – огляд#

Є два шляхи:

Коротко: Якщо ви не хочете генерувати токен, скористайтеся Шляхом Б – OAuth працює в клієнтах, які підтримують динамічну реєстрацію (наприклад, n8n або Claude Desktop із платним планом). Офіційні конектори безпосередньо в ChatGPT і Claude ще готуються.

Шлях А: підключення через PAT#

Передумови#

1. Згенерований PAT – див. Персональний токен доступу (PAT).
2. Вибрані права доступу (scopes), що відповідають тому, що ви хочете робити через ШІ. Якщо, наприклад, ви хочете лише читати статистику, дайте токену лише право на читання.
3. MCP-клієнт (Cursor, Claude Code, Claude Desktop, власний скрипт).

Спільні дані для всіх клієнтів#

Cursor#

1. Відкрийте Settings → MCP.
2. Натисніть Add new MCP server.
3. Заповніть:
   • Name: Mergado
   • URL: https://mcp.mergado.com
   • Header: Authorization: Bearer mergado_pat_…
4. Збережіть і перезапустіть Cursor.
5. У чаті перевірте, що інструменти Mergado з’явилися у списку доступних інструментів.

Докладна інструкція, як підключити Mergado MCP до застосунку Cursor.

Claude Code (CLI)#

claude mcp add --transport http mergado https://mcp.mergado.com \
  --header "Authorization: Bearer mergado_pat_..."

Перевірка, що сервер підключено:

claude mcp list

Claude Desktop#

Claude Desktop наразі не підтримує підключення до віддалених MCP-серверів безпосередньо через HTTP – він взаємодіє лише через локальні процеси. Тому потрібно використати посередника mcp-remote, який працює як локальний «перетворювач» між Claude Desktop і віддаленим сервером mcp.mergado.com.

1. Встановіть Node.js#

mcp-remote запускається через Node.js, який має бути встановлений на вашому комп’ютері.

Що таке Node.js? Середовище, у якому на вашому комп’ютері працюють програми, написані на JavaScript. Деякі інструменти, як-от mcp-remote, поширюються саме як пакети Node.js, і без Node.js їх не можна запустити.

Завантажте інсталятор із nodejs.org/en/download/current і виберіть правильний варіант відповідно до:

• операційної системи (Windows / macOS / Linux),
• архітектури процесора – для macOS потрібно вибрати ARM64 для процесорів Apple Silicon (M1 і новіші) або x64 для старіших Mac із процесорами Intel.

Після встановлення перевірте в терміналі (командний рядок / Термінал):

node --version

Якщо виведеться версія (наприклад, v22.x.x), встановлення пройшло успішно.

2. Змініть конфігураційний файл Claude Desktop#

Відкрийте (або створіть) файл:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

І вставте в нього таку конфігурацію:

{
  "mcpServers": {
    "mergado": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mergado.com",
        "--header",
        "Authorization: Bearer mergado_pat_..."
      ]
    }
  }
}

Замість mergado_pat_... вставте весь свій PAT.

3. Перезапустіть Claude Desktop#

Після перезапуску в інтерфейсі Claude Desktop має з’явитися сервер Mergado MCP як доступний інструмент. Перший запуск може тривати на кілька секунд довше – npx під час першого запуску завантажить пакет mcp-remote.

Порада для платних планів Claude (Pro, Max, Team, Enterprise): у Claude Desktop є також функція Custom Connectors (Settings → Connectors → Add custom connector), яка підтримує віддалені MCP-сервери нативно без Node.js і mcp-remote. Якщо у вас платний план, це простіший шлях.

Власний скрипт / застосунок#

Якщо ви пишете власного MCP-клієнта або користуєтеся SDK (TypeScript, Python), підключіться до https://mcp.mergado.com із заголовком Authorization: Bearer <PAT>. Подробиці протоколу MCP знайдете в офіційній специфікації MCP.

Шлях Б: офіційний Mergado MCP App#

Сервер Mergado MCP підтримує OAuth із динамічною реєстрацією клієнта – вам не потрібно генерувати жодного токена чи керувати ним. Досить ввести адресу https://mcp.mergado.com у свій MCP-клієнт і підтвердити екран входу Mergado.

Ми також готуємо офіційні конектори Mergado, які будуть доступні безпосередньо в меню конекторів ChatGPT і Claude. Щойно вони стануть доступні, ми додамо сюди інструкцію з їх підключення.

Порівняно зі Шляхом А вам не потрібно буде:

• генерувати персональний токен доступу (PAT) чи керувати ним,
• встановлювати Node.js чи будь-які інші допоміжні інструменти,
• вручну змінювати конфігураційні файли.

Авторизація відбувається стандартним потоком OAuth – так само, як коли ви входите у вебсервіс «через Google» або «через Facebook». Mergado попросить у вас згоду на конкретні права доступу, і ви можете будь-коли їх відкликати в розділі API and Access. На екрані входу тепер бачите огляд конкретних прав доступу (scopes), які запитує застосунок, — тож точно знаєте, що це підключення зможе робити в Mergado, ще до того, як підтвердите згоду.

ChatGPT#

Докладна інструкція, як підключити Mergado MCP до настільного застосунку ChatGPT.

Claude (Connectors Directory)#

Офіційний конектор для Claude ще готується. Щойно він стане доступний, ми додамо сюди інструкцію.

Безпека#

ШІ-агент, підключений до Mergado, виконує дії від вашого імені. Коли ви йому скажете «видали старі правила», він справді видаляє правила. Кілька принципів, як тримати це під контролем:

Принцип найменших привілеїв#

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

Анотації безпеки інструментів#

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

Шлях А і Шлях Б з погляду безпеки#

• Шлях А (PAT): токен фізично збережено в конфігурації клієнта. Якщо конфігураційний файл потрапить у чужі руки (Git, спільний знімок екрана, вкрадений ноутбук), токен потрібно анулювати.
• Шлях Б (OAuth): доступ прив’язаний до конкретного сервісу (обліковий запис ChatGPT/Claude), і ви не використовуєте жодного токена, який можна скопіювати. З погляду безпеки зручніше.

Регулярно переглядайте доступи#

• Для Шляху А відкрийте в Mergado API and Access і анулюйте токени, якими вже не користуєтеся.
• Для Шляху Б на тій самій сторінці побачите список підключених застосунків і зможете їх від’єднати.

Обережно з ін’єкціями промптів#

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

• Доступ на запис надавайте ощадливо і лише там, де він справді потрібен.
• Для чутливих дій (видалення, масові зміни) просіть ШІ підтвердити намір перед виконанням.
• Після роботи ШІ перевірте результат у Mergado – що зробив ШІ, ви зазвичай бачите в проєкті/правилах.

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

Токен у Cursor / Claude Code не працює, отримую 401. Що робити?#

• Перевірте, що заголовок точно Authorization: Bearer mergado_pat_... (слово Bearer з пробілом).
• Токен у Mergado не повинен бути анульований і не повинен мати простроченого терміну дії – див. список токенів на API and Access.
• У Cursor/Claude Code перезапустіть застосунок після зміни конфігурації.

ШІ не має доступу до того, що мені потрібно. Що робити?#

Токен не має потрібного права доступу. Створіть новий токен із розширеними правами доступу (наявний токен розширити не можна) і оновіть його в MCP-клієнті.

Чи можна використовувати один PAT у кількох ШІ-інструментах одночасно?#

Технічно так, але радимо створити окремий токен для кожного інструмента. Коли потім захочете відкликати доступ з одного інструмента, досить анулювати один токен, інші залишаться робочими.

Чи можна підключитися через OAuth, навіть якщо офіційні конектори для ChatGPT і Claude ще не готові?#

Так. OAuth працює в клієнтах, які підтримують динамічну реєстрацію, наприклад n8n або Claude Desktop із платним планом. Досить ввести URL https://mcp.mergado.com, генерувати токен не потрібно. Офіційні конектори безпосередньо в ChatGPT і Claude ще готуються.

Чи буде Mergado MCP App безкоштовним?#

Так. Офіційний Mergado MCP App буде доступний безкоштовно для всіх користувачів Mergado. Використання власних MCP-клієнтів (Шлях А) також безкоштовне – платите лише за ШІ-інструмент, яким користуєтеся (ChatGPT Plus, Claude Pro тощо).

Які моделі ШІ це підтримують?#

Будь-який MCP-сумісний клієнт. Наразі це передусім: ChatGPT (Apps), Claude (Claude Desktop, Claude Code, Connectors), Cursor і власні реалізації через MCP SDK.

Пов’язані посилання#

• Персональний токен доступу (PAT) – що це таке і як ним користуватися
• API and Access – керування PAT і підключеними застосунками
• Довідник Mergado API: api-docs.mergado.com
• Специфікація MCP: modelcontextprotocol.io
• Mergado Skills – Context7 – повна документація правил і можливостей Mergado для ШІ-асистентів
• Mergado Skills – GitHub
• mcp.mergado.com — огляд та інструкції з підключення (OAuth і PAT, ChatGPT, Claude, Cursor, VS Code та інші) чеською, англійською, словацькою та угорською