Как подключить ИИ-агента к учётной системе по MCP

ИИ-агент и ИИ-ассистент для бизнеса: в чём разница

Слова «ИИ-ассистент» и «ИИ-агент» часто используют как одно, хотя разница практическая. Ассистент отвечает на вопрос: спросили — рассказал. Агент выполняет задачу из нескольких шагов: сам решает, куда сходить за данными, сверяет их между собой и возвращает готовый ответ, а не подсказку.

Для компании это означает вот что. Ассистенту нужно объяснять, где искать. Агенту достаточно задачи: «собери по этому клиенту всё — заказы, отгрузки, оплаты, долг, открытые задачи», — и он пройдёт по разделам сам.

Разница между «ИИ-агентом вообще» и агентом, который приносит пользу, ровно одна: есть ли у него доступ к вашим данным. Агент без доступа пересказывает интернет. Агент с доступом отвечает цифрой из вашего учёта. Всё, что описано ниже, — про то, как этот доступ выдаётся и чем он ограничен.

Что такое MCP и зачем он учётной системе

MCP — открытый протокол, по которому ИИ-помощник обращается к внешней системе: спрашивает данные и выполняет действия. Для учётной системы это значит, что помощник перестаёт быть собеседником в отдельном окне и начинает работать с вашими настоящими остатками, оплатами и задачами.

Обычный путь к такому результату — писать интеграцию под каждого помощника, держать выгрузки и следить, чтобы копия данных не разошлась с оригиналом. MCP убирает этот слой: система один раз объявляет свои инструменты, а любой совместимый клиент их видит.

Что агент делает в Akeda

Инструменты повторяют разделы системы. Ниже — основные модули на октябрь 2026 года; всего сервер открывает более 1 700 операций, включая служебные операции владельца платформы.

Список не выдуман под витрину: он собирается из исходников вместе со сборкой, и карта кода проверяет, что за каждым инструментом стоит живой маршрут API.

Компактный режим: семь инструментов вместо тысячи

Полный перечень из более чем 1 700 операций занял бы у модели около мегабайта контекста ещё до первого вопроса. Поэтому по умолчанию сервер показывает клиенту семь инструментов: правила работы для агента, список и выбор кабинета, каталог, поиск операций, вызов операции и короткий код для чтения.

Агент ищет операцию словами — «выставить счёт покупателю», «просроченные задачи» — и вызывает её через akeda_go_call. Чтобы собрать данные из нескольких разделов сразу, он пишет короткую функцию для akeda_go_execute: она читает, сводит и возвращает только итог. Изменения кодом не проходят: каждое идёт отдельным вызовом, а если нужно подтверждение, агент показывает человеку сводку и ждёт явного согласия.

Каждый такой вызов проверяется так же, как прямой: права сотрудника, включённые модули, подтверждение. Клиенту, которому нужен весь список сразу, подойдёт адрес https://erp.akeda.ru/mcp?toolset=full.

Как подключить за три шага

1. В своём клиенте добавьте MCP-сервер по адресу https://erp.akeda.ru/mcp. Регистрация клиента проходит автоматически, вводить идентификатор приложения не нужно.
2. Войдите в Akeda своим логином. Пароль принимает только страница входа Akeda, клиент его не видит.
3. Выберите кабинет. Если кабинетов несколько, сессия стартует без умолчания и кабинет выбирается явно — так агент не начнёт работать не в той компании.

После этого агент видит инструменты и может, например, собрать отчёт по остаткам, найти документ, создать задачу или продиктовать поступление.

Права: агент не может больше сотрудника

Отдельной таблицы прав для агентов нет — и это принципиально. Агент действует под ролью вошедшего сотрудника: закрытый для него раздел закрыт и для агента, а выключенный в кабинете модуль не отдаёт свои инструменты вовсе.

Токен доступа живёт час и обновляется; подключение отзывается там же, где выдано. Каждый вызов проходит проверку прав на стороне API, а не на стороне клиента.

Машинный доступ по API-ключу

Если работает не человек с помощником, а ваш скрипт или сервис, подключение идёт по API-ключу. Ключ привязан к одному кабинету, по умолчанию даёт только чтение, показывается один раз при создании и хранится в базе только хэшем. Ключ отзывается, имеет срок и попадает в аудит.

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

Чем это отличается от «ИИ внутри программы»

Встроенный помощник умеет то, что заложил разработчик. Агент по MCP приносит свою голову: вы выбираете модель и клиента, а система даёт ей инструменты и границы. Поменяли помощника — интеграцию переписывать не нужно.

Обратная сторона честная: качество ответа зависит от выбранной модели, а не от Akeda. Система отвечает за то, чтобы данные были верными, а действия — разрешёнными.