Обновлено 26 сентября 2026 г.

MCP для ИИ-агентов

MCP (Model Context Protocol) позволяет подключить ИИ-агента к вашей CRM solOS (версия 3). После настройки агент сможет получать данные из CRM, выполнять поиск и фильтрацию, а в пользовательском режиме — создавать, изменять и удалять записи в пределах прав подключённого пользователя.

API-ключи имеют такое же значение, как и личные пароли пользователей. Не вставляйте их в сообщения, промпты, репозитории и общедоступные настройки. Используйте отдельного пользователя с минимально необходимыми правами и подтверждайте все операции записи.

Что потребуется

ИИ-агент с поддержкой MCP;
URL-адрес вашей CRM solOS;
пользовательские API-ключи или сервисный токен.

Шаг 1. Получите ключи доступа

Выберите один из двух режимов авторизации.

Пользовательский режим — ключи из профиля пользователя, раздел Доступ к API. Доступны чтение и разрешённые операции создания, изменения и удаления.
Сервисный режим — ключи из раздела Настройки → Сервисные токены. Доступны проверка подключения и чтение данных. Такой режим подходит для витрин, виджетов и внешних сервисов.

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

Шаг 2. Укажите параметры подключения

Откройте настройки MCP в используемом ИИ-агенте и добавьте подключение solOS. Названия полей могут отличаться: это могут быть URL, Endpoint или Path. В поле адреса укажите URL вашей CRM вместо {{YOUR_CRM_URL}}, например https://crm.example.com.

Для пользовательского режима укажите следующую пару заголовков:

Solos-User-Token: {{YOUR_CRM_TOKEN}}
Solos-User-Secret: {{YOUR_CRM_SECRET}}

Для сервисного режима укажите только сервисную пару:

Solos-App-Token: {{YOUR_CRM_APP_TOKEN}}
Solos-App-Secret: {{YOUR_CRM_APP_SECRET}}

Одновременно используйте только одну пару ключей: пользовательскую или сервисную. Для внешних подключений используйте HTTPS. В адресе CRM не указывайте реальные ключи или другие секретные данные.

Шаг 3. Проверьте подключение

Сохраните параметры и перезапустите MCP-подключение или ИИ-агента, если это требуется вашим клиентом. После успешного подключения агент должен увидеть инструменты solOS.

Первым запросом попросите агента проверить соединение:

Проверь подключение к CRM solOS и не изменяй данные.

Инструменты MCP

crm_ping — проверяет доступность CRM и авторизацию без изменения данных.
crm_api_help — показывает описание операции и обезличенную форму примера из актуальной Postman-коллекции.
crm_read — читает разрешённые API-модули, поддерживает поиск, фильтры и постраничную выборку.
crm_create — создаёт записи; доступен только с пользовательским ключом.
crm_update — изменяет записи; доступен только с пользовательским ключом.
crm_delete — удаляет записи; доступен только с пользовательским ключом.

Сервисный ключ публикует только crm_ping, crm_api_help и crm_read. MCP не расширяет права API-ключа: окончательное решение о доступе принимает CRM.

Примеры запросов агенту

Покажи все активные проекты, где я являюсь ответственным. Для каждого выведи название, клиента, срок завершения и просроченные задачи.

Найди проекты, в которых нет назначенного ответственного или установленного срока. Покажи их идентификаторы и предложи, какие данные нужно заполнить.

Найди все открытые заявки Helpdesk с просроченным сроком выполнения. Отсортируй их по приоритету и покажи ответственного.

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

Покажи мои события календаря на ближайшие 7 дней. Отдельно отметь события, в которых нет описания или контакта.

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

Найди контакт клиента «Название компании» и покажи его телефон, email и последние связанные события.

Создай задачу в проекте с ID 125: «Подготовить договор», срок — 26 сентября 2026 года. Сначала проверь структуру запроса и покажи мне результат перед созданием.

Добавь комментарий к заявке Helpdesk с ID 48. Перед отправкой покажи полный текст комментария и дождись моего подтверждения.

Измени срок задачи с ID 321 на 26 сентября 2026 года. Не выполняй изменение, пока я его не подтвержу.

Закрой заявку Helpdesk с ID 48. Сначала покажи текущий статус, проверь доступные поля и запроси подтверждение.

Удали событие календаря с ID 77 только после моего подтверждения. Если событие входит в серию, сначала покажи доступные варианты удаления.

Перед выполнением сложной операции сначала используй crm_api_help, проверь контракт API и покажи мне план действий.

Ограничения чтения

Параметр module обязателен.
При адресном чтении id передаётся массивом положительных целых чисел, максимум — 500 идентификаторов.
count — от 0 до 500 записей за один запрос.
offset, order, query, having и filter используются для выборки и фильтрации.
Если запись отсутствует или недоступна пользователю, она не включается в ответ.

Перед созданием или изменением записи попросите агента сначала получить контракт через crm_api_help и показать план операции. Операции удаления календаря могут дополнительно требовать scope, version и series_version.

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

Если подключение не работает

Ошибка 401. Проверьте правильность пары ключей, её активность и срок действия.
Ошибка 403. У пользователя нет прав на выбранный раздел или действие.
Не появился список инструментов. Проверьте адрес CRM и перезапустите MCP-подключение или ИИ-агента.

Ответы API solOS возвращаются в формате JSON. Подробные методы, параметры и коды ответов доступны в документации API solOS v3.