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

Агент для программирования, например

Claude Code

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

Десктопные проекты

При создании или открытии проекта десктопное приложение кладёт в его папку два файла, если их там ещё нет: .mcp.json, который подключает собственный MCP-сервер проекта falang, и CLAUDE.md — короткое описание проекта для агента. Существующие файлы никогда не перезаписываются.

Откройте терминал в папке проекта (или в любой папке внутри неё) и запустите агента, например claude.
Разрешите MCP-сервер проекта, когда агент спросит об этом в первый раз.
Опишите, что нужно построить или изменить.

Сервер — небольшая программа на Node.js, которая поставляется с приложением, поэтому нужен установленный Node.js, доступный как node. У каждой папки проекта свой сервер; само приложение при этом может быть не запущено.

Агент получает такие инструменты:

get_project, list_documents, get_document — чтение проекта, его дерева и схемы;
get_node_kinds — какие иконки может содержать схема, их поля и что куда можно вставлять;
set_document — замена схемы новой, проверенной версией (расположение оставшихся иконок сохраняется);
create_document, rename_document, move_document, delete_document , create_folder — работа с документами и папками;
lock_document, unlock_document — блокировка правки, о которой ниже.

Имена функций подчиняются тому же правилу, что и в редакторе: латиница в camelCase, например myFunctionName. В проекте Arduino агент может править setup, loop и другие схемы, включая иконки выводов и драйверов, но не может переименовывать, перемещать и удалять закреплённые документы, читать и заменять таблицы Devices (get_devices/set_devices), но не может компилировать или загружать скетч — для этого используйте Build & Upload в приложении. Агент также может писать, проверять и сохранять новые драйверы устройств (см. Собственные драйверы устройств).

Пока агент правит

Схема, которую меняет агент, заблокирована: если она открыта в приложении, её вкладка закрыта надписью «Locked by an agent until …», а ваши правки в ней не сохраняются, пока блокировка не снята. Блокировка действует пять минут после последнего обращения агента или заканчивается сразу, когда агент её снимает.
Открытое приложение само подхватывает изменения агента: схема без несохранённых правок перезагружается на месте, а дерево проекта отражает новые, переименованные и удалённые документы.
Если схема изменилась на диске, пока в ней есть ваши несохранённые правки, приложение спросит: Reload (discard my changes) (перезагрузить, отбросив правки) или Keep mine (оставить свои — тогда следующее сохранение перезапишет файл).

Workflow-конструктор

Backend Workflow-конструктора отдаёт MCP по HTTP по адресу /mcp на своём хосте — например, https://api.workflow.falang.ru/mcp или http://localhost:4100/mcp для локального стенда. Доступ — по персональному токену.

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

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

claude mcp add --transport http falang-workflow https://api.workflow.falang.ru/mcp \
--header "Authorization: Bearer flg_pat_…"

Агент получает те же инструменты для документов, что и в десктопе (с идентификатором проекта), и ещё инструменты, чтобы:

просматривать, создавать, импортировать и экспортировать проекты (экспорт никогда не содержит секретов);
искать интеграции по ключевым словам и смотреть учётные данные проекта (только названия, без секретов);
смотреть скомпилированный код, собирать и запускать функцию на тестовом стенде, следить за ходом и историей запуска;
отлаживать на тестовом стенде: точки останова, пауза, продолжение, шаг с обходом;
публиковать версию, смотреть список версий, активировать прежнюю или останавливать версию.

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

Плагин для Claude Code

Папка plugins/falang в

репозитории Falang

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

claude plugin marketplace add ./plugins
claude plugin install falang@falang

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

export FALANG_MCP_URL="https://api.workflow.falang.ru/mcp"
export FALANG_TOKEN="flg_pat_…"