Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

Агенты для программирования (MCP)

Агент для программирования — например, Claude Code — или любой другой клиент протокола MCP (Model Context Protocol) может работать с вашими проектами Шагомата напрямую: читать и менять схемы, собирать, запускать, отлаживать и публиковать. Это альтернатива встроенному ИИ-агенту, которая работает по вашей подписке на агента и в вашем терминале, а не с баланса Шагомата. Каждое изменение проверяется так же, как в редакторе: некорректная схема отклоняется с указанием места ошибки, и ничего не сохраняется.

  1. В Шагомате откройте меню пользователя → Токены доступа → «+ Новый токен». Дайте название (например, «Claude Code на ноутбуке»), при желании ограничьте токен одним проектом и сроком действия. Сразу скопируйте токен — он начинается с flg_pat_ и показывается один раз (см. Токены доступа).

  2. Подключите сервер к агенту. Для Claude Code:

    Окно терминала
    claude mcp add --transport http shagomat https://api.shagomat.ru/mcp \
    --header "Authorization: Bearer flg_pat_…"
  3. Опишите агенту, что нужно построить или изменить.

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

Токен, ограниченный одним проектом, не видит других проектов и не может создавать новые.

Документ, который меняет агент, блокируется: в браузере он закрыт надписью «Заблокировано агентом до …», а ваша правка, сделанная в это время, помечается как несохранённая. Блокировка снимается, когда агент закончил, или сама через пять минут после его последнего обращения.

Папка plugins/falang в репозитории открытого движка Falang — плагин для Claude Code с навыками, которые объясняют агенту устройство схем и цикл сборки, запуска и публикации, плюс готовое подключение MCP-сервера. Он не обязателен, но заметно повышает точность работы агента. Из клона репозитория:

Окно терминала
claude plugin marketplace add ./plugins
claude plugin install falang@falang

С плагином сервер настраивается двумя переменными окружения вместо claude mcp add:

Окно терминала
export FALANG_MCP_URL="https://api.shagomat.ru/mcp"
export FALANG_TOKEN="flg_pat_…"