ocStore MCP: керування каталогом OpenCart і блогом через ШІ-асистента

ocstore-mcp — це MCP-сервер, який підключає магазин на OpenCart / ocStore 3.0.x до ШІ-асистентів: Claude Desktop, claude.ai, Claude Code, OpenCode та VS Code.

Після підключення каталогом можна керувати звичайними словами: «створи товар із цими фото», «знайди товари виробника X», «додай англійський опис до категорії» або «покажи статті блогу». Асистент виконує дозволені операції через адміністративний API магазину.

Можливості MCP

Товари

Список із фільтрами за категорією та підкатегоріями, виробником, пошуком, датою зміни, сортуванням і пагінацією.
Швидкий пошук за назвою, моделлю або SKU.
Перегляд картки товару та повного адміністративного запису всіма мовами.
Створення, часткове оновлення, увімкнення, вимкнення та видалення.
Ціна, залишок, знижки, акції, категорії, головна категорія, атрибути, фільтри, опції, SEO-URL, метадані та багатомовні описи.

Статті та категорії блогу

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

Категорії, виробники, атрибути, фільтри та опції

Повний цикл роботи з категоріями: дерево, описи, статус, верхнє меню, noindex, фільтри та SEO.
Виробники з описами, логотипом, прив'язкою до магазинів і SEO.
Групи атрибутів і атрибути, групи фільтрів і фільтри, опції select/radio/checkbox/image та їхні значення.
Захист від видалення об'єктів, які ще використовуються в каталозі.

Зображення

Для підтримуваних каталогових сутностей можна передавати локальний файл, URL http(s) або наявний шлях у магазині.
JPG, PNG і WebP; сервер перевіряє тип і розмір файлу до 5 МБ перед передаванням.

Масовий імпорт

Завантаження каталогу з JSON-маніфесту або YML-фіда; у hosted-режимі використовується публічний URL, якщо імпорт файлів окремо не дозволено.
Автоматичне створення виробників, категорій, груп атрибутів, атрибутів і товарів у правильному порядку.
Фонове виконання з прогресом, результатом по кожному запису та можливістю скасування.
Dry run, пропуск наявних записів, продовження після помилок і паралельна обробка.

Мультимовність

Під час підключення сервер зчитує фактичний список мов конкретного магазину та їхні ID.
Асистент використовує лише наявні мовні ID, тому описи не потрапляють у неіснуючі або orphan-мовні записи.
Вбудовані інструкції підказують правильний порядок дій: спочатку створити відсутній атрибут, фільтр чи опцію, а потім посилатися на нього в товарі.

Безпека та контроль доступу

API-ключі створюються в адмінці: Модулі → MCP API.
Для кожного ключа можна окремо дозволити читання й запис товарів, категорій, виробників, атрибутів, фільтрів, опцій і блог-контенту.
Асистент бачить лише дозволені інструменти; заборонені не реєструються в його контексті.
Є перевірка токена, rate limit, захист від SSRF і журналювання технічних помилок без запису ключів.

Способи підключення

Локально через stdio: для Claude Code, OpenCode, VS Code і Claude Desktop.
Hosted HTTP gateway: один Docker-сервер для кількох магазинів; ключі магазину передаються заголовками кожного запиту.
Самостійне підключення: власник магазину відкриває /connect, вводить ключ, отримує персональне посилання та додає його у custom connector.

Вимоги

OpenCart / ocStore 3.0.x, встановлений OCMOD-модуль «MCP API» і API-ключ із потрібними дозволами.