Перейти к основному содержимому

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 меняет черновик проекта: агента, воркфлоу или функцию. Чтобы изменения стали видны в продакшне, проект нужно отдельно опубликовать.