Addshop MCP: управление интернет-магазином с помощью ИИ

Addshop MCP — это безопасный способ подключить искусственный интеллект к панели управления интернет-магазином Addshop. Владелец магазина может формулировать задачу обычными словами: «проверь карточки без фотографий», «подними цены на выбранную группу на 7%», «создай 50 скрытых товаров», «найди повторяющиеся артикулы» или «подготовь SEO-описания». MCP-сервер переводит запрос в проверяемые действия внутри Addshop, сначала показывает план и только после подтверждения применяет изменения.

Вы можете создать интернет магазин за 1 вечер. Просто выберите готовый шаблон интернет магазина и установите его. Останется только наполнить его своими товарами.

Для обычного пользователя это означает меньше ручной работы с таблицами и формами. Для разработчика — единый протокол, через который ИИ получает строго ограниченный набор инструментов вместо полного доступа к серверу и исходному коду магазина.

Что такое MCP простыми словами

MCP, или Model Context Protocol, — открытый протокол взаимодействия ИИ с внешними сервисами. Сам по себе ИИ не знает пароль от магазина и не нажимает случайные кнопки в админке. Он видит только те функции, которые предоставил MCP-сервер: например, прочитать товар, построить предварительный план изменения цены, проверить ревизию карточки и сохранить результат.

В Addshop MCP реализован принцип «сначала посмотреть — потом изменить». Большинство операций поддерживают два режима:

Preview — MCP читает актуальные данные, рассчитывает изменения и показывает точный список затрагиваемых объектов.
Apply — изменение выполняется только после передачи актуальной ревизии или хеша плана и явного подтверждения пользователя.

Если карточку успели изменить вручную после preview, операция останавливается. Это защищает от перезаписи свежих данных.

Какие задачи можно поручить ИИ

Товары и каталог

читать карточки товаров, категории, производителей, размеры и цвета;
создавать новые товары сначала в скрытом состоянии;
массово менять названия, описания, категории, SEO-поля и витринные признаки;
изменять цены в процентах, на фиксированную сумму или до заданного значения;
контролировать минимальную и максимальную цену и правила округления;
проверять дубли названий, URL, штрихкодов и артикулов;
публиковать или скрывать только точный подтверждённый список ID;
экспортировать и импортировать изменения через CSV с защитой от устаревших данных.

Варианты, цены и остатки

читать и редактировать варианты товара;
менять артикул, цену, остаток, размер, цвет и признак бесконечного остатка;
создавать несколько вариантов по подготовленной матрице;
не допускать одинаковых артикулов и повторяющихся комбинаций размера и цвета;
строить отчёт по товарам с нулевым или низким остатком;
рассчитывать рекомендуемое пополнение склада.

Фотографии и характеристики

проверять наличие изображений у товаров;
загружать JPEG, PNG и WebP из разрешённой локальной папки;
проверять размер, MIME-тип и SHA-256 файла до загрузки;
связывать фотографии с цветами;
читать и массово обновлять существующие характеристики;
работать с видео, тегами и связанными товарами.

SEO и качество каталога

находить товары без SEO title и description;
выявлять слишком короткие описания, пустые цены и отсутствующие фотографии;
предлагать уникальный человекопонятный URL;
проверять готовность товара к публикации по карточке, вариантам, изображениям и свойствам;
сравнивать две карточки и создавать безопасный blueprint для клонирования.

Заказы, контент и настройки

MCP умеет читать заказы и расшифровывать статусы, способы оплаты и доставки. Персональные данные покупателей по умолчанию скрываются. Также поддерживаются страницы, статьи, новости, слайдеры, справочники и основные настройки магазина. Для интеграций доступен отдельный безопасный контур: секреты передаются через переменные окружения и не возвращаются в ответы ИИ.

Примеры запросов обычного владельца магазина

«Найди все скрытые товары категории “Обувь”, у которых нет фотографий или SEO-описания. Ничего не меняй — сначала покажи отчёт».

«Подготовь увеличение цен на 7% для товаров производителя N, округли до десятков и покажи итоговые цены. Применяй только после моего подтверждения».

«Создай 20 карточек товаров по этому списку. Заполни название, описание, цену, артикул и характеристики. Оставь все карточки скрытыми».

«Проверь, нет ли повторяющихся артикулов, пустых остатков и одинаковых URL. Составь план исправления».

Чем точнее сформулирован фильтр и ожидаемый результат, тем лучше. Для массовой операции полезно отдельно сказать: какие товары выбирать, какие поля менять, нужно ли публиковать и что считать успешной проверкой.

Как обеспечивается безопасность

Addshop MCP создавался для работы без доступа к исходникам и серверу Addshop. Он использует авторизованную сессию владельца и штатные страницы редактора. При этом сервер добавляет дополнительные уровни защиты:

Ревизии. Каждое изменение связано с точным состоянием объекта. Устаревшая команда блокируется.
Plan hash. Массовый план нельзя незаметно изменить между просмотром и применением.
Read-after-write. После записи MCP перечитывает объект и проверяет результат.
Журналы восстановления. До изменения сохраняются данные, необходимые для диагностики и отката.
Защита публикации. Создание товаров выполняется в скрытом состоянии, публикация — отдельным последним действием.
Роли. Можно включить режим только для чтения или разрешить только контентные и торговые операции.
Аварийный выключатель. Переменная ADDSHOP_WRITES_ENABLED=0 мгновенно запрещает любые записи.
Ограничение частоты. Локальный circuit breaker защищает от слишком большого числа команд.
Аудит. Действия записываются в цепочку SHA-256 без cookies, паролей и значений секретных полей.
DPAPI-сессия. На Windows cookies можно хранить в зашифрованном виде, привязанном к пользователю ОС.

Пошаговая установка Addshop MCP

Исходный код опубликован в открытом репозитории github.com/Tobiz21/addshop-mcp. Для установки нужен Python 3.12, Git и доступ владельца к панели Addshop.

Шаг 1. Скачайте проект

git clone https://github.com/Tobiz21/addshop-mcp.git
cd addshop-mcp

Шаг 2. Создайте виртуальное окружение

python -m venv .venv
.venv/Scripts/python -m pip install -r requirements.txt

Шаг 3. Подготовьте отдельные папки

Создайте локальные каталоги для зашифрованной сессии, рабочих журналов и загружаемых изображений. Не размещайте их в публичном Git-репозитории или общей сетевой папке.

Шаг 4. Выполните безопасный вход

.venv/Scripts/python session_login_cli.py --base-url https://ВАШ-МАГАЗИН.myaddshop.ru --session-file C:/secure/addshop-mcp/session.dpapi.json

Логин и пароль вводятся локально. Пароль не сохраняется в проекте и не должен передаваться в чат с ИИ.

Шаг 5. Настройте окружение

ADDSHOP_BASE_URL=https://ВАШ-МАГАЗИН.myaddshop.ru
ADDSHOP_SESSION_FILE=C:/secure/addshop-mcp/session.dpapi.json
ADDSHOP_STATE_DIR=C:/secure/addshop-mcp/state
ADDSHOP_UPLOAD_ROOT=C:/secure/addshop-mcp/uploads
ADDSHOP_ROLE=reader
ADDSHOP_WRITES_ENABLED=0
ADDSHOP_MAX_WRITES_PER_MINUTE=20
ADDSHOP_ACTOR=owner

Начинать рекомендуется с роли reader и полностью отключённой записью.

Шаг 6. Проверьте установку

python quality_gate.py
python smoke_mcp.py

Quality gate запускает автотесты, компиляцию и настоящий MCP-handshake без обращения к живому магазину.

Шаг 7. Подключите сервер к MCP-клиенту

Команда запуска сервера:

.venv/Scripts/python server.py

Транспорт — stdio. В настройках Codex, Claude Desktop или другого MCP-клиента нужно указать эту команду, рабочую папку проекта и перечисленные переменные окружения. Пароль и cookies в конфигурацию клиента не вставляются: используется путь к DPAPI-файлу сессии.

Шаг 8. Проведите read-only проверку

После подключения попросите ИИ выполнить:

локальную диагностику;
проверку контрактов Addshop;
чтение списка товаров и категорий;
аудит качества нескольких карточек;
создание локального snapshot перед будущими массовыми операциями.

Шаг 9. Разрешите запись только после проверки

Когда чтение работает, установите подходящую роль content или admin и переключите ADDSHOP_WRITES_ENABLED=1. Первое изменение выполняйте только на отдельном скрытом тестовом товаре. Сначала получите preview, затем примените изменение и верните исходное значение.

Что MCP намеренно не делает автоматически

Некоторые действия остаются ограниченными: удаление вариантов и изображений, финансовые операции, создание отправлений и фактический запуск внешних импортов. Причина не в технической невозможности, а в отсутствии гарантированного серверного отката. Такие операции должны иметь отдельный контракт, явное подтверждение и проверяемое восстановление.

MCP также не заменяет ответственность владельца магазина. Перед массовой публикацией необходимо проверить тексты, цены, юридическую информацию, фотографии и условия продажи.

Кому будет полезен Addshop MCP

владельцам магазинов с большим каталогом;
контент-менеджерам и SEO-специалистам;
агентствам, которые сопровождают несколько магазинов;
разработчикам, которым нужна автоматизация без доступа к исходному коду Addshop;
командам, которые хотят соединить ИИ с каталогом, но сохранить контроль над каждой записью.

Итог

Addshop MCP превращает работу с интернет-магазином в управляемый диалог с ИИ. Вместо десятков однотипных действий пользователь описывает результат, проверяет план и подтверждает точную операцию. Система умеет работать с товарами, вариантами, ценами, остатками, изображениями, характеристиками, SEO, контентом, заказами и интеграциями, сохраняя ревизии, журналы и защиту от случайной публикации.

Начните с режима чтения, проверьте магазин, создайте snapshot и протестируйте одну скрытую карточку. После этого Addshop MCP можно использовать как ежедневного помощника для каталога и как основу для более глубокой автоматизации интернет-магазина.

Проект и инструкция: https://github.com/Tobiz21/addshop-mcp

Создайте интернет-магазин на Addshop за один вечер: готовые шаблоны, приём оплаты и выгрузка на маркетплейсы.

Создать магазин бесплатно Тарифы