Решение

Открыть доступ агентам

Проектируем безопасные API, CLI и MCP.

Создаём контролируемый путь от решения агента до действия во внутренней системе: с понятными командами, ограниченными правами и журналом операций.

Обсудить задачу

Агенту нужны действия, а не ещё одно окно

Человек может открыть административную панель, найти нужный раздел и понять ошибку по контексту. Агенту нужны явные команды, предсказуемые данные и правила, определяющие, что ему разрешено делать.

Автоматизация через интерфейс может подойти для прототипа. В постоянной работе она зависит от вёрстки, получает слишком широкий доступ и плохо объясняет, что произошло при ошибке.

Как проходит действие

От намерения до результата в системе

Агент
Описание инструмента
Проверка прав
API, CLI или MCP
Внутренняя система
Результат и журнал

Интерфейс выбираем под существующую архитектуру. Если у системы уже есть подходящий API, новый слой может не понадобиться. Иногда достаточно ограничить доступ, описать команды и привести ответы к форме, понятной агенту.

MCP используем там, где он упрощает подключение агентов. Сам по себе протокол задачу не решает.

Доступ начинается с границ

До реализации определяем:

какие данные агент может читать;
какие действия ему доступны;
от чьего имени выполняется операция;
где требуется подтверждение человека;
какие ограничения действуют на параметры и частоту вызовов;
что записывается в журнал.

Опасные или необратимые действия получают отдельные проверки. Агент не должен расширять свои полномочия через произвольные параметры или прямой доступ к внутренней системе.

Что строим

Интерфейс для конкретного рабочего сценария

Начинаем с действия, которое уже выполняет человек или существующая автоматизация. Например: получить состояние объекта, подготовить изменение, запустить внутреннюю операцию или собрать результат из нескольких систем.

Для этого сценария можем разработать:

API или адаптер к существующему API;
CLI для предсказуемых инженерных операций;
MCP-сервер с ограниченным набором инструментов;
схемы входных и выходных данных;
авторизацию и проверку разрешений;
обработку ошибок и журнал вызовов;
тесты полного пути от агента до системы.

Состав зависит от сценария. Мы не открываем агенту всю систему ради одной операции.

Альтернативы

Быстрый способ должен соответствовать риску

Управление через браузер

Подходит для проверки идеи или редкой операции. Для постоянной работы интерфейс может оказаться слишком хрупким.

Прямые учётные данные системы

Упрощают первый эксперимент, но затрудняют ограничение прав и разбор совершённых действий.

MCP поверх всей системы

Создаёт много инструментов раньше, чем понятны нужные агенту сценарии. Начинать лучше с небольшого набора разрешённых действий.

Существующий API

Если он уже даёт нужные операции и модель доступа, используем его. Новый интерфейс имеет смысл только там, где старого недостаточно.

Результат

Агент выполняет согласованные действия

После работы остаётся интерфейс, через который агент может выполнить выбранный сценарий и получить понятный результат.

Вызовы проходят проверку прав и входных данных, ошибки возвращаются в предсказуемой форме, а совершённые операции можно восстановить по журналу. Код, тесты и описание инструментов остаются у вашей команды.

Абсолютной безопасности не существует. Наша задача — сделать полномочия агента ограниченными, наблюдаемыми и соответствующими риску операции.