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

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/. Разница только в том, какой токен вы в него подставите.

  1. Заведите токен:
    • токен проекта — в Настройки проекта → API ключи, с уровнем MCP: чтение или MCP: редактирование;
    • токен профиля — в Профиль → Персональные MCP-подключения, с доступом Чтение или Редактирование. По умолчанию бессрочный (До отзыва); можно ограничить срок действия.
  2. Добавьте MCP-сервер в свой MCP-клиент тем же конфигом. Страница Персональные MCP-подключения собирает его автоматически, кнопкой Скопировать настройки; для токена проекта соберите его вручную по этому же образцу:
    {
    "mcpServers": {
    "lia": {
    "url": "https://agents.lia.chat/api/mcp/",
    "headers": {
    "Authorization": "Bearer <TOKEN>"
    }
    }
    }
    }
    Вставьте этот блок в файл настроек MCP вашего клиента (у Claude Code это .mcp.json), заменив <TOKEN> на скопированный токен. Для Claude Code то же самое можно сделать через CLI:
    claude mcp add --transport http \
    --header "Authorization: Bearer lia_live_..." \
    lia https://agents.lia.chat/api/mcp/
  3. Проверьте подключение: вызовите инструмент 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_organizationslimit (до 100, по умолчанию 20), offsetСписок организаций. Токену проекта доступна только своя организация; токену профиля — все, которые видит аккаунт
list_projectsorganization_id (необязательно)У токена проекта — единственный проект, на который он выдан. У токена профиля — все проекты, доступные аккаунту
get_projectproject_idНастройки проекта, доступного этому ключу

Агенты​

ИнструментПараметрыНазначение
list_agentsproject_id, agent_type (необязательно), limit (до 100), offsetАктивные агенты проекта, с пагинацией
get_agentagent_idКонфигурация, промпты, id подключённых инструментов и текущая version — получить перед правкой
create_agentproject_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_agentagent_id, version (обязателен), остальные поля как у create_agent, все опциональные, плюс is_activeМеняет только переданные поля по текущей version — устаревшая версия отклоняется, нужно заново вызвать get_agent. Списки инструментов — полная замена, [] отвязывает все
delete_agentagent_idУдаляет агента и очищает его правила телефонии — агент пропадает из списков, но запись не стирается физически (мягкое удаление)
duplicate_agentagent_idКопия агента с конфигурацией и привязками в рамках того же проекта
ensure_agent_workflowagent_idВозвращает или создаёт обёрточный воркфлоу агента (черновик). Не публикует и не запускает

Воркфлоу​

ИнструментПараметрыНазначение
list_workflowsproject_id, limit (до 100), offsetВоркфлоу проекта, с пагинацией
get_workflowworkflow_idГраф nodes/edges целиком и текущая version — получить перед правкой
create_workflowproject_id, name, nodes, edges, descriptionСоздаёт неопубликованный черновик. nodes/edges — формат нод и связей, см. skill для сборки воркфлоу
update_workflowworkflow_id, version (обязателен), name, nodes, edges, descriptionМеняет только переданные поля по текущей version; переданные nodes/edges полностью заменяют хранившийся граф
delete_workflowworkflow_idУдаляет черновик воркфлоу

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

Функции​

ИнструментПараметрыНазначение
list_functionsproject_id, limit (до 100), offsetАктивные функции проекта, с пагинацией
get_functionfunction_idКод, схема параметров и таймаут функции
create_functionproject_id, name, code, description, timeout (1–60 секунд, по умолчанию 10)Создаёт JS-функцию, не выполняя её. code — тело функции, без обёртки async function execute(){...}
update_functionfunction_id, name, code, description, timeoutМеняет только переданные поля, не выполняя функцию
delete_functionfunction_idУдаляет функцию — запись не стирается физически (мягкое удаление), как у агента

Запуски и трейсы (только чтение)​

ИнструментПараметрыНазначение
list_executionsproject_id, workflow_id (необязательно), status (необязательно), limit (до 100, по умолчанию 50), offsetСписок запусков со счётчиком шагов
get_executionexecution_idСтатус, вход, выход и ошибка запуска
get_execution_tracethread_id, status_filter (необязательно), limit (до 500, по умолчанию 100), ascending (необязательно, по умолчанию true), offsetПошаговая лента сессии. Результат ограничен проектом ключа даже если такой же thread_id встречается в чужом проекте
get_step_detailstep_idПолные данные шага и его родительского запуска

Разбор ошибки запуска: get_execution(id) — увидеть error → get_execution_trace(thread_id) — найти упавший шаг → get_step_detail(step_id) — увидеть детали.

Голосовые сессии (только чтение)​

ИнструментПараметрыНазначение
list_voice_sessionsproject_id, agent_id (необязательно), channel (необязательно), status (необязательно), date_from/date_to (необязательно), search (необязательно, поиск по id сессии), limit (до 100, по умолчанию 50), offsetГолосовые сессии проекта, новые сначала
get_voice_sessionsession_idСтатус, метрики и доступность трейса сессии
get_voice_session_eventssession_id, limit (до 500, по умолчанию 100), offsetХронологическая лента событий разговора с урезанными превью транскрипта и границами сессии
get_voice_session_transcriptsession_id, limit (до 500, по умолчанию 100), offsetПолный сохранённый текст транскрипта, без урезания. Аудиозапись этим инструментом не возвращается