1. Руководство пользователя › 1.1 Начало › AI-помощник

AI-помощник — это отдельная программа-агент: вы ставите задачу словами, она сама читает нужное, сама делает и отчитывается о сделанном. С магазином её связывает посредник — MCP-сервер, который идёт в поставке Melbis Shop и разговаривает с движком тем же протоколом, что и сама программа.

Приложение подойдёт любое, лишь бы оно умело MCP. Основные интеграции — Claude Code, OpenAI Codex и OpenCode: для них программа готовит настройки сама. Melbis Shop не привязан ни к одному из них: приложение называет себя само при первом соединении и там же получает все указания — в магазине для него ничего не заводится заранее.

Чтобы это работало, нужны три вещи:

Приложение-агент установлено на том же компьютере Windows, где стоит программа Melbis Shop. Это не веб-сервис и не расширение браузера: помощник запускает локальный процесс, а из браузера так сделать нельзя.
Оплата программы-агента — отдельно от лицензии Melbis, у каждого сотрудника своя; сколько и за что платить, зависит от выбранной программы, а OpenCode может работать и бесплатно.
Права из ветки «AI-помощник», выданные вашему пользователю магазина. Отдельной учётной записи для помощника не нужно и не бывает — см. «Права».

Не путайте его с AI-справкой — она встроена в редактор среды разработки, видит только показанный ей текст и ничего не меняет (руководство разработчика, «AI-справка»). Правило простое: помещается в один файл — справка, требует самого магазина — помощник.

Что он умеет

Он видит магазин целиком:

Область	Что делает
Файлы проекта	читает и правит модули, шаблоны, статику, картинки; ведёт историю версий, сбрасывает кеш
Данные	читает и меняет таблицы пулом шагов в одном соединении, с блокировками и пометкой кеша
Деревья	каталог, справочники и любые другие: создаёт, переносит, удаляет узлы с пересчётом индексов
Файлы элементов	прикрепляет фото товаров и вложения, забирает их обратно
Копия магазина	забирает к себе весь код магазина, профили или дамп базы — как программа кнопкой «Копировать магазин»; `config.json` в копию не входит
Витрина	открывает страницы магазина как посетитель и читает отчёт отладчика
Документация	читает руководства и описания таблиц прямо из дистрибутива — поэтому отвечает про Melbis предметно, а не вообще

Настройка

«Система → Подключение → AI-помощник» — и настраивать там нечего. На закладке лежит готовая конфигурация MCP-сервера и кнопка «Копировать»: скопируйте её и вставьте в настройки своего приложения-агента, туда, где оно спрашивает про MCP-серверы. Больше от вас ничего не нужно — какой магазин открыт, помощник выясняет сам.

Такую же конфигурацию, но привязанную к одному магазину, программа кладёт в саму папку магазина — для приложений, которые открывают папку как проект: .mcp.json и .claude\settings.json читает Claude Code, .codex\config.toml и AGENTS.md — Codex, opencode.json и тот же AGENTS.md — OpenCode. Запущенный по ним помощник работает только с этим магазином, что бы ни было открыто в программе: открыли папку магазина — и переписка по разным магазинам не сваливается в одну кучу. Когда приложение один раз спросит, доверяете ли вы этой папке, и вы подтвердите, помощник будет вызывать свои инструменты, не спрашивая разрешения на каждый вызов: пределы ему задают ваши права в магазине. Файлы переписываются при каждом запуске программы, дописывать в них своё бесполезно; берутся они из папки Engine\MCP\Setup\ дистрибутива.

Логина и пароля здесь нет: помощник входит в магазин под вами — той парой, которой вы вошли в программу на закладке «Параметры подключения».

Пару он берёт сам и двумя путями. Программа запущена — отвечает ему прямо из своей памяти. Программа закрыта — из реестра Windows, где пароль лежит зашифрованным, но только если стоит галочка «хранить пароли». Третьего пути нет: назвать пароль в переписке нельзя — помощник его не примет, и он там никогда не появляется.

Кнопка «Проверить подключение» проходит весь путь по-настоящему — лицензия, пароль, права — и объясняет словами, что не так, ещё до первой сессии.

Права

AI-помощник работает в вашем магазине вашими руками, поэтому вопрос «что ему дозволено» решается там же, где и для людей: в правах пользователя.

Отдельной учётной записи у него нет. Есть отдельная ветка в реестре операций — «AI-помощник», и это не формальность: право Загрузить для человека и право AI-помощник → Прямой доступ → Разработка → Чтение данных для его помощника — разные строки. Поэтому вы можете держать свои руки полными, а помощнику оставить чтение, — и наоборот, у кого ветка не выдана вовсе, у того помощника просто нет.

Отсюда три следствия, которые стоит держать в голове:

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

Помощник не обходит запреты: получив отказ, он называет недостающее право — и называет его путём по дереву прав, а не внутренним именем команды, потому что в программе вы видите именно путь.

Исключение из всего сказанного — только что установленный магазин: пока в его корне лежит файл admin.here, движок не проверяет ни лицензию, ни пароль, и помощник работает сразу. Он сам об этом предупредит: в таком магазине администратором становится любой, кто знает адрес, поэтому завершите установку до запуска в работу.

Как с ним работать

Ставьте задачу целью, а не последовательностью действий: «на главной нужен блок хитов продаж» вместо «открой такой-то файл и добавь такую-то строку». Дальше он сам разберётся в устройстве и изложит план до того, как что-то менять — о правке файлов и об изменении данных он предупреждает отдельно и ждёт согласия.

Первая задача в незнакомом магазине идёт медленно: помощник осматривается — читает карту проекта, документацию, модули. Это подготовительный этап, дальше заметно быстрее: понятое он предлагает сохранить в самом магазине, и в следующий раз начинает не с нуля — см. «Что помощник помнит».

При подключении помощник сообщает, сколько незакрытых задач ждёт вас в «Планировщике», по состояниям, — если у вас есть право на планировщик. Как часто заглядывать в него дальше, он спросит один раз и предложит запомнить ответ.

Помощник — не замена разработчику. Он быстро делает то, что вы понимаете сами, и его правки стоит читать как правки коллеги: перед выкладкой на живую витрину смотрите глазами.

Что помощник помнит

Переписка остаётся в приложении-агенте на вашем компьютере. Всё, что должно пережить разговор, помощник держит в самом магазине, в его базе: так это доступно с любого компьютера и из любого приложения и переезжает вместе с магазином.

Куда что положить, решает один вопрос: нужно ли это в каждой сессии, позже или другим сотрудникам — или только в этом разговоре.

Где	Что там	Кто пишет
Устав магазина	сложившиеся правила бизнеса: процессы, обязанности сотрудников, порядок работы с заказами, поставщиками, складом и товарами	сотрудники, по правам на разделы устава
Память	важное и постоянное для работы помощника: ваши распоряжения, как с вами работать, принятые решения и их причины; читается в начале каждой сессии	помощник — свои заметки, с вашего согласия; администратор — заметки для групп и для всех
Репозиторий	рабочие данные, которые читают по делу: незаконченная работа, промежуточные результаты, разобранные сайты, готовые скрипты	помощник, когда его туда послали; разделы и права заводит администратор
Папка `mcp` рядом с магазином	расходное этого разговора: скачанные страницы, картинки, черновые записи; только на этом компьютере, стирается без сожаления	помощник

Устав. Новый магазин получает устав-образец сразу, и помощник идёт в него с первой сессии; в магазине без устава он предложит его завести. Кому устав читать, а кому править, решают права на разделы в «Каталоге». Сложившимся правилам место в уставе, а не в памяти: в памяти остаётся повседневное.

Память. Понятое помощник предлагает записать: называет правило, имя, категорию и тип заметки и записывает, только если вы согласны. Его заметки принадлежат логину, под которым сделаны, — у другого сотрудника память своя. Заметки для группы или для всех пишет администратор: они старше заметок помощника, и сам он их не меняет. Заметки типа «Критическое» — общие, групповые и свои — помощник читает в начале каждой сессии: пока он их не загрузил, MCP-сервер не выполняет других его команд.

Заметки копятся быстро, поэтому помощник время от времени предлагает их пересмотреть и удаляет лишнее только с вашего согласия. Вся память видна в окне «AI-компоненты», и тому, кто может его открыть, видны заметки всех сотрудников. Пока окно открыто, новые заметки помощник не запишет — он предложит положить их в «Планировщик», если ему выдан инструмент планировщика.

Репозиторий. Разделы заводит администратор: личный — для одного сотрудника, общие — для всех; кто что видит в разделе, решают его права. Помощник пишет туда, когда вы его послали или когда так сказано в заметке памяти — там же может быть указано, какой раздел ваш личный. В остальных случаях он только предлагает: «это стоит сохранить в вашем личном разделе» — и записывает, если вы согласны. Записав, он называет раздел и тему, чтобы было понятно, где искать.

Запись в репозитории не меняется: каждая новая добавляется к теме, поэтому видна вся история работы. Ваш личный раздел не видят помощники других сотрудников — кроме администратора: тому, кто может сохранять окно «AI-компоненты», открыты все разделы. Если личного раздела у вас нет, помощник посоветует попросить его у администратора.

Как администратор ведёт память и репозиторий — «AI-компоненты», вкладки «AI-память» и «AI-репозиторий».

Что он умеет сверх общего

Всё описанное выше одинаково в любом магазине Melbis. Сверх этого у помощника есть AI-инструменты — готовые команды, написанные под ваш магазин: завести товар так, как заведено у вас, закрыть заказ по вашим правилам. Их заводит владелец, и раздаются они по одной команде каждому сотруднику — см. «AI-инструменты».