BuildNexus из вашей IDE: MCP, CLI и HTTP

Agent Gateway: один интерфейс, три транспорта

Проект — обычные файлы, так что шаблоны, стили, скрипты и модули можно править в любом редакторе. А для страниц, разделов, меню и настроек проекта есть Agent Gateway — локальный интерфейс к открытой Studio.

Он не привязан к конкретному клиенту и даёт три равноправных способа доступа:

MCP — конфиги для общего адаптера и для Cursor;
CLI — команда bnx-agent для POSIX, Git Bash и Windows;
HTTP/JSON — локальный адрес и токен из discovery-файла проекта.

MCP не обязателен: CLI и HTTP подойдут любому агенту, который умеет запустить команду или сделать локальный запрос.

Как подключиться

В Studio выберите «Открыть папку сайта в IDE». Studio сама определяет установленные редакторы и готовит конфиги подключения, не трогая ваши собственные MCP-серверы.

Два условия: Studio запущена и проект открыт. Адреса и токены действуют только для текущей сессии и обновляются при повторном открытии папки — после перезапуска Studio повторите команду.

Что может агент в вашей IDE

Через шлюз доступны те же доменные операции, что и в редакторе Studio:

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

Пример вызова через CLI:

.bnx/bin/bnx-agent health
.bnx/bin/bnx-agent tools
.bnx/bin/bnx-agent call page_read '{"name":"home"}'
.bnx/bin/bnx-agent call view_get_rendered_html '{"scope":"skin","page":"home"}'

В Windows удобнее передавать сложный JSON файлом или через stdin — это исключает ошибки экранирования между оболочками.

Почему не править JSON напрямую

Шлюз проверяет права, сверяет поля с контрактом модуля и ведёт ревизии — так две стороны (вы в редакторе и агент в IDE) не затирают работу друг друга. Прямая запись в pages.json, pages/*.json, project.json и menus/*.json эти проверки обходит.

Агенты внутри Studio

Встроенная панель агента работает через тот же шлюз и те же проверки. Подключить можно как облачных провайдеров по ключу, так и подписки вроде Claude Code и Codex, и локальные модели через Ollama или LM Studio.

Все шаги документации

Шаг 6 из 9 — IDE и MCP

← Шаг 5. Шаблоны и Vue · Шаг 7. Публикация и Core →

Работа из IDE: MCP, CLI и HTTP