TOBIZ MCP

MCP-сервер для конструктора сайтов TOBIZ: даёт агенту (Hermes, Codex, OpenCode и любому MCP-клиенту) читать и менять сайты — проекты, страницы, блоки, изображения.

Репозиторий: https://github.com/Tobiz21/tobiz-mcp

Docker-образ: ghcr.io/tobiz21/tobiz-mcp:0.9.0-beta.2

Короткая инструкция для ИИ

Установи TOBIZ MCP с https://github.com/Tobiz21/tobiz-mcp. Запусти безопасный мастер настройки и попроси меня ввести данные TOBIZ в скрытом запросе, не в чате. Затем уточни, с каким сайтом и что нужно сделать, и используй только штатные функции TOBIZ.

Выбор дизайна

• tobiz_design_library возвращает паспорта девяти установленных штатных шаблонов и семнадцати визуальных референсов: исходные страницы, сильные стороны, плотность, зависимость от фото и долю Flex.
• tobiz_select_design ранжирует установленные шаблоны по брифу до копирования страницы и объясняет выбор, риски и подходящие визуальные референсы.
• tobiz_editor_roundtrip_check без сохранения собирает штатный payload редактора и заранее выявляет блоки, из-за которых ручное пересохранение может изменить или сломать страницу.
• tobiz_build_quality_page выбирает проверенный шаблон по брифу, соблюдает лимит Flex 30%, выдает компактный рецепт и медиаплан, сохраняет копию один раз и завершает desktop/mobile и editor-safe проверками. Полный технический паспорт возвращается только при details=true.

Быстрый старт

Поддерживаемый способ установки публичной бета-версии - Docker. Python wheel сам по себе не содержит Node-рендерер TOBIZ и не является полноценной установкой сервера.

git clone https://github.com/Tobiz21/tobiz-mcp.git && cd tobiz-mcp
docker build -t tobiz-mcp .
docker run --rm -it --entrypoint tobiz-mcp-configure \
  -v "$PWD:/config" tobiz-mcp --projects 123456,123457 --output /config/.env

После публикации образа локальную сборку можно заменить на:

docker pull ghcr.io/tobiz21/tobiz-mcp:0.9.0-beta.2
docker tag ghcr.io/tobiz21/tobiz-mcp:0.9.0-beta.2 tobiz-mcp

Мастер скрыто запросит пароль, включит строгую изоляцию и разрешит MCP работать только с перечисленными проектами. Если .env уже существует, рядом останется резервная копия. Для автоматической установки передайте логин и пароль через окружение и добавьте --non-interactive; пароль не передавайте аргументом командной строки.

Проверка, что сервер видит конструктор (логин/сессия и рендерер):

docker run --rm --entrypoint tobiz-mcp-selftest --env-file .env \
  -v tobiz-session:/data/session -v tobiz-assets:/data/assets \
  tobiz-mcp --health

Ожидаемый ответ — JSON, где session.present: true и renderer_available: true. Если логин по паролю аккаунт не пропускает (встречается капча), положите свою сессию в том — см. «Полезно знать» ниже.

Дальше достаточно подключить сервер к своему агенту — он запускает образ сам, как stdio-сервер.

Подключение к агенту

Подставьте свой абсолютный путь к .env. Образ запускается с -i (stdio) — больше ничего не нужно.

Hermes

hermes mcp add tobiz --command docker --args run -i --rm \
  --env-file /путь/до/tobiz-mcp2/.env \
  -v tobiz-session:/data/session -v tobiz-assets:/data/assets \
  tobiz-mcp
hermes mcp test tobiz

Codex (~/.codex/config.toml)

[mcp_servers.tobiz]
command = "docker"
args = ["run", "-i", "--rm", "--env-file", "/путь/до/tobiz-mcp2/.env",
        "-v", "tobiz-session:/data/session", "-v", "tobiz-assets:/data/assets", "tobiz-mcp"]
startup_timeout_sec = 30
tool_timeout_sec = 180

OpenCode (opencode.json)

{"mcp": {"servers": {"tobiz": {"type": "local",
  "command": ["docker", "run", "-i", "--rm", "--env-file", "/путь/до/tobiz-mcp2/.env",
              "-v", "tobiz-session:/data/session", "-v", "tobiz-assets:/data/assets", "tobiz-mcp"]}}}}

Инструменты появятся с префиксом сервера — например mcp__tobiz__tobiz_list_projects.

Загрузка картинок работает через файлы: положите изображение в локальный каталог и смонтируйте его как /data/inbox, тогда путь к файлу передаётся в tobiz_upload_image (либо сразу content_base64, без монтирования).

Два режима работы

MCP — это JSON-RPC, а не REST, и клиент подключается к серверу одним из двух способов:

Контейнер запускается не на каждую команду: он один на сессию, а вызовы инструментов идут в него потоком JSON-RPC (в stdio — через stdin/stdout). Черновик правок и кеш библиотеки блоков живут в процессе, cookie-сессия — на томе, поэтому переживает перезапуск контейнера.

Постоянный HTTP-сервис:

docker run -d --name tobiz-mcp --restart unless-stopped -p 8765:8765 \
  -e MCP_TRANSPORT=http -e MCP_HTTP_TOKEN=секрет --env-file .env \
  -v tobiz-session:/data/session -v tobiz-assets:/data/assets tobiz-mcp
# endpoint: http://<хост>:8765/mcp, заголовок Authorization: Bearer секрет

Цена общего сервиса: черновик один на процесс — несколько агентов на одной странице будут мешать друг другу. Для параллельной работы удобнее stdio: у каждого агента свой контейнер и свой черновик.

Инструкции для агента (скил)

Инструменты — половина дела: агенту нужно знать порядок работы, грабли вендора и как проверять результат. Это лежит в скиле skills/tobiz-mcp/SKILL.md.

Hermes — скил лежит в репозитории, вместе со справочниками (каталог блоков, движок, компоненты, эндпоинты). Копируй папку целиком:

git clone https://github.com/Tobiz21/tobiz-mcp.git /tmp/tobiz-mcp
cp -r /tmp/tobiz-mcp/skills/tobiz-mcp ~/.hermes/skills/

Установка по прямой ссылке (hermes skills install <raw-URL на SKILL.md>) тоже работает, но приносит только SKILL.md — без справочников и рецептов.

Codex / OpenCode читают AGENTS.md из корня репозитория автоматически; если работаете не из репозитория — скопируйте файл в свой конфиг (~/.codex/AGENTS.md и аналоги).

В скиле: что пишется сразу, а что только по tobiz_save_page; 15 проверенных грабель (радиус кнопок в em и вендорский CSS 2px, автоконтраст текста в формах, обязательный block_id при загрузке картинок, отстающий window.tobiz, ?v= = id страницы) и короткие рецепты под типовые задачи.

Инструменты

Ответ инструмента: {"ok": true, "data": {...}} либо {"ok": false, "error": {"code": "...", "message": "...", "hint": "..."}}.

Как это устроено (коротко)

Редактор TOBIZ хранит не «значения полей», а готовый HTML блока, поэтому сервер рендерит этот HTML сам — Node с шаблонами и хелперами вендора внутри образа. Правки блоков копятся в черновике в памяти сервера и уходят на сайт только по явному tobiz_save_page.

Параметры самой страницы (название, URL, SEO, картинка для соцсетей) живут не в черновике, а в панели конструктора: tobiz_update_page читает форму страницы, подменяет указанные поля и отправляет её целиком — такое изменение видно на сайте сразу. Копирование и удаление страницы (tobiz_copy_page, tobiz_delete_page) тоже применяются немедленно.

Статьи и товары также редактируются отдельными штатными модулями TOBIZ и применяются сразу, без tobiz_save_page. Текст статьи принимает HTML CKEditor: изображения загружаются в ее галерею, а видео вставляется штатным iframe. В товаре доступны три поля видео (video1-video3) и штатные варианты (offers). Глобальные стили страницы хранятся в page_config: их правки попадают в черновик и применяются через tobiz_save_page, как обычные блоки.

Полезно знать

• Блоки не меняются без tobiz_save_page; tobiz_update_page, tobiz_copy_page и tobiz_delete_page пишут на сайт сразу — проверяйте project_id/page_id перед вызовом.

• tobiz_update_page отправляет всю форму страницы (как редактор), поэтому не переданные поля сохраняются как были — SEO можно править, не затирая название и slug.

• tobiz_delete_page требует confirm=true: без него вернётся отказ с названием страницы.

• Для экспериментов заведите отдельный сайт и TOBIZ_READ_ONLY=1.

• Если аккаунт требует капчу при входе, сервис вернёт AUTH_CAPTCHA. Тогда положите свою сессию в том — хватит двух cookie session и email:

  bashCopy

  # cookies.json = {"session": "...", "email": "..."}
  docker run --rm -u 0 --entrypoint sh -v tobiz-session:/data -v "$PWD:/seed:ro" \
    tobiz-mcp -c 'cp /seed/cookies.json /data/session/ && chown -R 10001:10001 /data/session'
  

  После этого TOBIZ_EMAIL/TOBIZ_PASSWORD в .env можно оставить пустыми.

• tobiz_upload_image требует block_id реального блока страницы (без него конструктор отвечает «Изображение не загружено! #2»).

• Секреты не логируются: в журнал попадают только имена cookie.

Переменные окружения

После подключения запустите tobiz_onboarding_check. Для личной тестовой установки достаточно ready=true; перед передачей другим пользователям требуется distribution_ready=true. Если передать project_id и page_id, инструмент также проверит безопасное пересохранение страницы в редакторе, не изменяя сайт.

Финальная приемка перед выдачей установки пользователю:

docker run --rm --entrypoint tobiz-mcp-selftest --env-file .env \
  -v tobiz-session:/data/session -v tobiz-assets:/data/assets -v tobiz-audit:/data/audit \
  tobiz-mcp --release PAGE_ID --project PROJECT_ID

Команда возвращает код 0 только при release_ready=true; отчет печатается в JSON и подходит для CI. | TOBIZ_LOG_LEVEL | INFO по умолчанию, WARNING — тише |