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

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

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

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

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

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

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

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

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

Инструменты повторяют разделы системы. Ниже — основные модули; всего сервер публикует 591 инструмент, включая служебные и клиентские.

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

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

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

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

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

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

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

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

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

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

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

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

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