MCP-сервер lia-agents
Это MCP-сервер — его может подключить любой MCP-совместимый клиент к своему проекту в Лия Agents. Инструкция ниже дана для Claude (Code или Desktop) как для самого частого случая. В отличие от встроенных MCP-серверов, которые агенты платформы используют как инструменты для работы с внешними сервисами, этот сервер устроен наоборот: не агент платформы вызывает внешний сервис, а подключённый клиент настраивает проект — создаёт и правит агентов, воркфлоу и функции по командам на естественном языке. Настроить проект извне, без доступа к внутренней сети Лия Agents, можно только через подключённый MCP-клиент. Прямой REST здесь не подходит — см. «Схема данных настройки».
- Покрытие: 29 инструментов — проект, агенты, воркфлоу, функции, запуски и трейсы, голосовые сессии
- Авторизация: токен проекта или токен профиля со scope
mcp.access. Ниже примеры даны для токена проекта — токен профиля даёт те же инструменты, но видит всё, что видит ваш аккаунт, а не один проект - Адрес:
https://agents.lia.chat/api/mcp/ - Транспорт: HTTPS
Подключение
Адрес сервера один и тот же для обоих токенов: https://agents.lia.chat/api/mcp/. Разница только в том, какой токен вы в него подставите.
- Заведите токен:
- токен проекта — в Настройки проекта → API ключи, с уровнем MCP: чтение или MCP: редактирование;
- токен профиля — в Профиль → Персональные MCP-подключения, с доступом Чтение или Редактирование. По умолчанию бессрочный (До отзыва); можно ограничить срок действия.
- Добавьте MCP-сервер в свой MCP-клиент тем же конфигом. Страница Персональные MCP-подключения собирает его автоматически, кнопкой Скопировать настройки; для токена проекта соберите его вручную по этому же образцу:
Вставьте этот блок в файл настроек MCP вашего клиента (у Claude Code это
{
"mcpServers": {
"lia": {
"url": "https://agents.lia.chat/api/mcp/",
"headers": {
"Authorization": "Bearer <TOKEN>"
}
}
}
}.mcp.json), заменив<TOKEN>на скопированный токен. Для Claude Code то же самое можно сделать через CLI:claude mcp add --transport http \
--header "Authorization: Bearer lia_live_..." \
lia https://agents.lia.chat/api/mcp/ - Проверьте подключение: вызовите инструмент
whoami.
Токен профиля видит всё, к чему у вас уже есть доступ (подробнее про разницу — в обзоре). Токен проекта ограничен одним проектом. Если нужен доступ к нескольким конкретным проектам, но не ко всему сразу — заведите несколько MCP-серверов в своём клиенте, по одному на проект, каждый со своим токеном (например lia, lia-project2, lia-project3 — имя сервера произвольное, значение имеет только токен).
Проект
| Инструмент | Параметры | Назначение |
|---|---|---|
whoami | — | Идентичность ключа. У токена проекта: subject (api_key:pak_...), api_key_id, project_id, organization_id, scopes. У токена профиля поля другие: subject (user:usr_...), user_id, token_id, без project_id, так как токен профиля не привязан к одному проекту. Первый вызов для проверки, что доступ работает |
list_organizations | limit (до 100, по умолчанию 20), offset | Список организаций. Токену проекта доступна только своя организация; токену профиля — все, которые видит аккаунт |
list_projects | organization_id (необязательно) | У токена проекта — единственный проект, на который он выдан. У токена профиля — все проекты, доступные аккаунту |
get_project | project_id | Настройки проекта, доступного этому ключу |
Агенты
| Инструмент | Параметры | Назначение |
|---|---|---|
list_agents | project_id, agent_type (необязательно), limit (до 100), offset | Активные агенты проекта, с пагинацией |
get_agent | agent_id | Конфигурация, промпты, id подключённых инструментов и текущая version — получить перед правкой |
create_agent | project_id, organization_id, name, instructions, model, description, agent_type (text/voice), role (standalone/orchestrator/specialist), temperature, function_ids, workflow_ids, mcp_server_ids, sub_agent_ids, configuration | Создаёт агента. instructions — системный промпт, обязателен. Полный configuration перекрывает model/temperature. Все id в списках инструментов обязаны принадлежать этому же проекту |
update_agent | agent_id, version (обязателен), остальные поля как у create_agent, все опциональные, плюс is_active | Меняет только переданные поля по текущей version — устаревшая версия отклоняется, нужно заново вызвать get_agent. Списки инструментов — полная замена, [] отвязывает все |
delete_agent | agent_id | Удаляет агента и очищает его правила телефонии — агент пропадает из списков, но запись не стирается физически (мягкое удаление) |
duplicate_agent | agent_id | Копия агента с конфигурацией и привязками в рамках того же проекта |
ensure_agent_workflow | agent_id | Возвращает или создаёт обёрточный воркфлоу агента (черновик). Не публикует и не запускает |
Воркфлоу
| Инструмент | Параметры | Назначение |
|---|---|---|
list_workflows | project_id, limit (до 100), offset | Воркфлоу проекта, с пагинацией |
get_workflow | workflow_id | Граф nodes/edges целиком и текущая version — получить перед правкой |
create_workflow | project_id, name, nodes, edges, description | Создаёт неопубликованный черновик. nodes/edges — формат нод и связей, см. skill для сборки воркфлоу |
update_workflow | workflow_id, version (обязателен), name, nodes, edges, description | Меняет только переданные поля по текущей version; переданные nodes/edges полностью заменяют хранившийся граф |
delete_workflow | workflow_id | Удаляет черновик воркфлоу |
Создание и правка здесь касаются черновика. Чтобы изменения стали видны в продакшне, проект нужно отдельно опубликовать. Правила самого графа нод и связей см. skill для сборки воркфлоу.
Функции
| Инструмент | Параметры | Назначение |
|---|---|---|
list_functions | project_id, limit (до 100), offset | Активные функции проекта, с пагинацией |
get_function | function_id | Код, схема параметров и таймаут функции |
create_function | project_id, name, code, description, timeout (1–60 секунд, по умолчанию 10) | Создаёт JS-функцию, не выполняя её. code — тело функции, без обёртки async function execute(){...} |
update_function | function_id, name, code, description, timeout | Меняет только переданные поля, не выполняя функцию |
delete_function | function_id | Удаляет функцию — запись не стирается физически (мягкое удаление), как у агента |
Запуски и трейсы (только чтение)
| Инструмент | Параметры | Назначение |
|---|---|---|
list_executions | project_id, workflow_id (необязательно), status (необязательно), limit (до 100, по умолчанию 50), offset | Список запусков со счётчиком шагов |
get_execution | execution_id | Статус, вход, выход и ошибка запуска |
get_execution_trace | thread_id, status_filter (необязательно), limit (до 500, по умолчанию 100), ascending (необязательно, по умолчанию true), offset | Пошаговая лента сессии. Результат ограничен проектом ключа даже если такой же thread_id встречается в чужом проекте |
get_step_detail | step_id | Полные данные шага и его родительского запуска |
Разбор ошибки запуска: get_execution(id) — увидеть error → get_execution_trace(thread_id) — найти упавший шаг → get_step_detail(step_id) — увидеть детали.
Голосовые сессии (только чтение)
| Инструмент | Параметры | Назначение |
|---|---|---|
list_voice_sessions | project_id, agent_id (необязательно), channel (необязательно), status (необязательно), date_from/date_to (необязательно), search (необязательно, поиск по id сессии), limit (до 100, по умолчанию 50), offset | Голосовые сессии проекта, новые сначала |
get_voice_session | session_id | Статус, метрики и доступность трейса сессии |
get_voice_session_events | session_id, limit (до 500, по умолчанию 100), offset | Хронологическая лента событий разговора с урезанными превью транскрипта и границами сессии |
get_voice_session_transcript | session_id, limit (до 500, по умолчанию 100), offset | Полный сохранённый текст транскрипта, без урезания. Аудиозапись этим инструментом не возвращается |