crank/docs/ui.md

Веб-интерфейс

Веб-интерфейс нужен для настройки инструментов, агентов и доступа к MCP.

Операции

Операция описывает один REST endpoint как MCP-инструмент.

В операции задаются:

• имя инструмента;
• описание для AI-агента;
• входная схема;
• REST endpoint;
• правила преобразования входных параметров в REST-запрос;
• правила преобразования REST-ответа в результат инструмента;
• тестовый пример;
• статус публикации.

Черновик можно редактировать и тестировать. MCP-клиенты видят только опубликованные операции, которые привязаны к опубликованному агенту.

Агенты

Агент - это отдельный MCP endpoint с выбранным набором инструментов.

Рекомендуемый подход:

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

API ключи

API-ключ выдается на конкретного агента. Ключ позволяет MCP-клиенту:

• открыть MCP-сессию;
• получить список инструментов агента;
• вызвать опубликованный инструмент.

Полное значение ключа показывается только при создании.

Секреты

Секреты используются для авторизации на конечных REST API.

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

Логи и использование

Раздел Логи показывает вызовы операций, ошибки маппинга, ошибки REST API и успешные ответы.

Раздел Использование показывает количество вызовов, ошибки и задержки по операциям.