TOBIZ MCP

io.github.Tobiz21v0.9.0-beta.2Updated Oct 9, 2026

Create, edit and audit TOBIZ websites, pages, blocks, articles and products.

VerifiedSTDIODesktop onlyBusiness & CommerceMedia & DesignProductivity & Workflow

Overview

AI-generated overview

Lets an assistant read and edit TOBIZ website builder projects: pages, blocks, articles, products, images and styles.

What it does
Connects an assistant to the TOBIZ site builder so it can list projects and pages, inspect blocks and their fields, search the block library, and read page settings such as title, URL, SEO and og:image. It can add, update, move and delete blocks in a draft, then write them to the site with a save call, and it can copy or delete pages, edit page parameters, upload images, and manage articles, products and product offers. It also offers audits, screenshots, computed styles, interaction diagnostics and a template-based page build pipeline.
When to use it
Use it when a site is built on TOBIZ and you want an assistant to inspect, audit or edit its pages, articles and products rather than doing it by hand in the builder panel. It suits design selection, template-based page creation, SEO and layout checks, and bulk content work.
Requirements
Runs locally as a stdio process, distributed as a Docker image; the README says the Python wheel alone is not a complete install because the Node renderer is missing. Needs TOBIZ account credentials (TOBIZ_EMAIL, TOBIZ_PASSWORD) or a seeded session, plus TOBIZ_ALLOWED_PROJECT_IDS and TOBIZ_REQUIRE_PROJECT_ALLOWLIST. Optional settings include TOBIZ_READ_ONLY, TOBIZ_MAX_UPLOAD_MB, TOBIZ_LOG_LEVEL, and MCP_TRANSPORT with MCP_HTTP_PORT and MCP_HTTP_TOKEN for HTTP mode. Network access to TOBIZ is…
Before you install
The server holds TOBIZ_EMAIL and TOBIZ_PASSWORD, so enter them through a secret prompt, not in chat, and keep the generated .env file safe. Many operations write immediately: page parameter updates, page copy and delete, and article and product edits apply without a separate save, and page deletion requires confirm=true. Block edits stay in a draft until an explicit save. Use TOBIZ_READ_ONLY and a project allowlist for experiments, and note that an HTTP transport exposes a shared draft and…

Installation

In SourceWeft

  1. Open TOBIZ MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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 и не является полноценной установкой сервера.

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

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

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

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

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

bash
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

bash
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-mcphermes mcp test tobiz

Codex (~/.codex/config.toml)

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 = 30tool_timeout_sec = 180

OpenCode (opencode.json)

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, и клиент подключается к серверу одним из двух способов:

stdio (по умолчанию)HTTP (streamable HTTP)
Кто запускает контейнерклиент-агент сам: docker run -i --rm …вы, один раз: docker run -d …
Сколько контейнероводин на сессию агента, живёт до её концаодин постоянный, обслуживает всех
Кому подходитHermes / Codex / OpenCode на этой машинеклиенты по сети, несколько агентов, отладка через curl
Черновик правоксвой у каждого агентаобщий на всех клиентов

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

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

bash
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 — скил лежит в репозитории, вместе со справочниками (каталог блоков, движок, компоненты, эндпоинты). Копируй папку целиком:

bash
git clone https://github.com/Tobiz21/tobiz-mcp.git /tmp/tobiz-mcpcp -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 страницы) и короткие рецепты под типовые задачи.

Инструменты

ИнструментЧто делает
tobiz_login, tobiz_session_status, tobiz_healthвход, состояние сессии, диагностика
tobiz_onboarding_check, tobiz_diagnosticsготовность установки и локальный обезличенный отчет поддержки
tobiz_list_projectsпроекты (сайты) аккаунта
tobiz_list_pagesстраницы проекта
tobiz_page_summaryкомпактная карта страницы: порядок блоков, короткий текст, SEO-подсказка
tobiz_list_blocks, tobiz_get_blockблоки страницы и значения полей блока
tobiz_page_infoпараметры страницы как в панели: название, URL, SEO, og:image, доступ
tobiz_search_blocks, tobiz_describe_blockпоиск по библиотеке блоков, схема полей типа
tobiz_block_controlsреестр галочек и списков каждого типа: подписи, поля, дефолты, зависимости и варианты
tobiz_audit_catalogаудит всех типов, галочек, списков, серверных значений и flex-вариантов
tobiz_get_site_styles, tobiz_update_site_stylesштатные глобальные шрифты, размеры, насыщенность и цвета кнопок через page_config
tobiz_get_computed_styles, tobiz_screenshot_pageреальные стили и полностраничные desktop/mobile PNG-снимки
tobiz_diagnose_interactions, tobiz_audit_page, tobiz_audit_summaryформы, попапы, кнопки, ссылки, контраст, геометрия, остатки исходной тематики, JS-ошибки и изображения
tobiz_add_block, tobiz_update_block, tobiz_delete_block, tobiz_move_blockправки черновика
tobiz_save_pageзапись блоков на сайт: рендер HTML, SaveBlocks, проверка вёрстки
tobiz_update_pageправка параметров страницы (SEO, название, slug, og:image) — пишет сразу
tobiz_copy_pageкопия страницы вместе с блоками в тот же или другой проект
tobiz_build_from_templateодин конвейер: проверка рецепта, копирование, заполнение, одно сохранение, SEO и desktop/mobile-аудит
tobiz_delete_pageудаление страницы (требует confirm=true)
tobiz_discard_changes, tobiz_verify_pageоткат черновика, проверка публичной вёрстки
tobiz_upload_image, tobiz_set_block_imageзагрузка изображения и подстановка в поле
tobiz_refresh_assetsперекачать библиотеку блоков проекта
tobiz_list_articles, tobiz_get_article, tobiz_create_article, tobiz_update_article, tobiz_delete_articleштатный редактор статей: тексты, URL, SEO, публикация, категории
tobiz_upload_article_image, tobiz_sort_article_images, tobiz_list_article_categoriesизображения, их порядок и категории статей
tobiz_list_products, tobiz_get_product, tobiz_create_product, tobiz_update_product, tobiz_delete_productуправление товарами: цены, остатки, метки, размеры, SEO и видео
tobiz_upload_product_image, tobiz_sort_product_images, tobiz_list_product_categoriesгалерея, порядок фото и категории товаров
tobiz_list_product_offers, tobiz_get_product_offer, tobiz_create_product_offer, tobiz_update_product_offer, tobiz_delete_product_offerварианты товара: название, артикул, цена, остаток и фото

Ответ инструмента: {"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:

    bash
    # 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_EMAIL, TOBIZ_PASSWORDвход в конструктор (не нужны, если положена сессия)
TOBIZ_READ_ONLY1 — только чтение, инструменты правки не регистрируются
TOBIZ_ALLOWED_PROJECT_IDSCSV со списком разрешённых project_id; пусто - все проекты аккаунта, если строгий режим выключен
TOBIZ_REQUIRE_PROJECT_ALLOWLISTtrue запрещает работу с проектами, пока не заполнен TOBIZ_ALLOWED_PROJECT_IDS; рекомендуется для общей и клиентской установки
TOBIZ_MAX_UPLOAD_MBлимит файла изображения (по умолчанию 10)
MCP_TRANSPORTstdio (по умолчанию) или http
MCP_HTTP_PORT, MCP_HTTP_TOKENпорт и токен для HTTP-транспорта

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

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

bash
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 — тише |

Source: README.md at commit 028ee5a

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.9.0-beta.2LatestOct 9, 2026