Інтеграції · AI-агенти

Підключення AI-агентів (MCP)

Як підключити магазин до Claude, ChatGPT, Claude Code, Codex і Cursor через MCP: без терміналу, з дозволами й відкликанням.

MCP (Model Context Protocol) — стандартний спосіб дати AI-агенту доступ до вашого магазину. Агент читає каталог, сторінки, налаштування й змінює їх — одразу або чернетками на ваше схвалення, як оберете під час підключення. Що агент може, а що ні — у статті «Що AI-агент може робити через MCP».

Адреса сервера однакова для всіх магазинів — магазин ви обираєте під час входу:

https://app.storeforma.com/api/agent/v1/mcp

Claude.ai

Відкрийте Налаштування → Конектори і натисніть Додати власний конектор.
Назва — будь-яка, наприклад «Storeforma». Вставте адресу сервера й натисніть Підключити.
Відкриється вхід Storeforma: увійдіть своїм акаунтом.
Оберіть магазин і що Claude може публікувати сам (можна нічого — тоді лише чернетки). Натисніть Дозволити.
У чаті увімкніть конектор у меню інструментів і напишіть, наприклад: «Знайди 10 товарів без опису й підготуй описи».

ChatGPT

Налаштування → Застосунки й конектори → Розширені налаштування: увімкніть режим розробника (доступний не на всіх планах).
Застосунки й конектори → Створити: адреса сервера, автентифікація OAuth.
Увійдіть у Storeforma, оберіть магазин і дозволи.
У чаті оберіть конектор у меню «+».

Claude Code

claude mcp add --transport http storeforma https://app.storeforma.com/api/agent/v1/mcp

Далі в Claude Code введіть /mcp, оберіть storeforma → Authenticate і підтвердіть доступ у браузері.

Codex

codex mcp add storeforma --url https://app.storeforma.com/api/agent/v1/mcp
codex mcp login storeforma

Cursor

Settings → MCP → Add new MCP server, тип HTTP, адреса сервера. Cursor сам відкриє вхід Storeforma. Або файл ~/.cursor/mcp.json:

{
  "mcpServers": {
    "storeforma": {
      "url": "https://app.storeforma.com/api/agent/v1/mcp"
    }
  }
}

Дозволи

Повна довіра (типово): агент керує темою, розширеннями, каталогом, цінами, вмістом і налаштуваннями й застосовує зміни одразу.
Лише чернетки: кожну зміну ви схвалюєте в асистенті адмінки.
Або відмітьте області окремо. «Читати замовлення й клієнтів» — персональні дані покупців, вмикайте свідомо.
Кожна дія записується в журнал; ядро платформи недоступне в жодному режимі.

Відкликання й термін дії

Усі підключення видно в адмінці: Інтеграції → MCP і термінал → «Підключені клієнти». Кнопка «Відкликати» вимикає доступ одразу. Доступ діє 30 днів, потім агент попросить увійти знову.

Якщо не працює

Що бачите	Що зробити
Агент пише, що доступ недійсний	Минули 30 днів або доступ відкликано — підключіть конектор ще раз.
Агент не може опублікувати	Ця область не дозволена: зміна чекає в асистенті як чернетка. Схваліть її або підключіть агента заново з потрібним дозволом.
На сторінці дозволу немає магазину	Ваш акаунт не має доступу до адмінки цього магазину — попросіть власника додати вас.