API для разработчиков
Доступ к Лия Agents определяется двумя независимыми параметрами: способом и уровнем доступа. Способы:
| Способ | Кто пользуется | Назначение |
|---|---|---|
MCP-сервер lia-agents | Ваш MCP-клиент (например, Claude Code или Claude Desktop) | Создаёт и правит агентов, воркфлоу, функции; читает запуски, трейсы и голосовые сессии — по командам на естественном языке |
| Публичный API | Ваш код напрямую, без MCP-клиента | Запускает уже опубликованный рабочий процесс |
Прямые HTTP-вызовы к путям настройки снаружи отклоняются обоими типами токенов — см. «Схема данных настройки». Без доступа к внутренней сети Лия Agents настраивать проект можно только через подключённый MCP-клиент, например Claude Code.
Токены проекта и профиля
MCP можно подключить двумя разными токенами, и они различаются не функциями, а областью видимости.
| Токен | Где завести | Что видно |
|---|---|---|
| Проект | Настройки проекта → API ключи | Только один проект |
| Профиль | Профиль → Персональные MCP-подключения | То же, что видит ваш аккаунт |
Токен профиля заводится на странице Персональные MCP-подключения: название подключения, уровень доступа (Чтение / Редактирование), необязательный срок действия (по умолчанию бессрочный, До отзыва). Подсказка ? рядом с заголовком страницы поясняет область видимости такого подключения прямо в интерфейсе: «Одно подключение для всего, к чему у вас уже есть доступ. Каждое действие проверяется по вашим текущим правам. Проектные токены ограничены одним проектом». Вкладка История показывает журнал использования и позволяет отозвать подключение.
Та же страница автоматически собирает готовый конфиг для вашего подключения (блок Пример настройки клиента, кнопка Скопировать настройки) с адресом сервера https://agents.lia.chat/api/mcp/. Формат подключения для токена проекта и токена профиля один и тот же — см. MCP-сервер.
Ключ проекта проще для разового подключения одного MCP-клиента к одному проекту. Токен профиля подключается тем же способом, только область видимости у него шире.
Ключ проекта
Ключ заводится в Настройки проекта → API ключи → Создать ключ и привязан к одному проекту — он даёт доступ и к MCP, и к публичному API. При создании ключа выбирается уровень доступа:
| Уровень | Что открывает |
|---|---|
| Только чтение | Просмотр опубликованных воркфлоу и запусков — для публичного API |
| Выполнение | То же плюс запуск опубликованных воркфлоу — для публичного API |
| MCP: чтение | Просмотр агентов, воркфлоу, функций, запусков — для MCP |
| MCP: редактирование | То же плюс создание, правка и удаление агентов, воркфлоу, функций — для MCP |
| Полный доступ | Все права сразу |
| Настроить вручную | Отдельные права, часть из которых показаны ниже |
Фактические права ключа — не пресет, а набор отдельных scope. Для стороны MCP их видно в ответе whoami. Список ниже — пример с одного конкретного ключа, не исчерпывающий каталог: он не включает scope для категорий инструментов, к которым у этого ключа нет доступа, например для голосовых сессий:
agents.read, agents.write,
workflows.read, workflows.write,
functions.read, functions.write,
executions.read,
projects.read,
mcp.access
mcp.access отдельно разрешает подключение по протоколу MCP; без него подключить ключ к MCP-клиенту не получится, хотя сам ключ остаётся рабочим для публичного API. Scope для стороны публичного API — отдельные, whoami их не показывает; полный список — в разделе «Уровни доступа (scopes)» публичного API.
MCP меняет черновик проекта: агента, воркфлоу или функцию. Чтобы изменения стали видны в продакшне, проект нужно отдельно опубликовать.