Как подключить ИИ к Битрикс24: выбрать сценарий и подготовить MCP
Разбираем задачи для MCP TrueTell: найти сделку, понять её стадию, проверить просроченные задачи и оценить границы сводки продаж. Показываем, как сверять ответы ИИ с CRM.
«Подключить ИИ к Битрикс24» может означать помощь менеджеру с текстом, бота в клиентском чате или ответ по CRM в привычной нейросети. Для третьего варианта важно получить реальные данные из портала и понять границы результата. Именно на эту задачу мы ориентируем MCP TrueTell.
Начните с рабочей задачи
Сформулируйте, что сотрудник должен узнать или сделать. Например: «Найти согласованную тестовую сделку и показать её стадию». Такую задачу можно проверить по карточке. Просьба «проанализируй всё» не задаёт ни состав данных, ни критерий готового ответа.
| Задача | С чего начать | Что учесть |
|---|---|---|
| Помочь сотруднику с текстом или разговором внутри портала | Сначала проверить возможности встроенного помощника в своей версии Битрикс24. | Внешнее подключение может не потребоваться. |
| Отвечать клиентам в канале общения | Нужен бот с правилами диалога, передачей оператору и согласованными источниками. | Наличие MCP само по себе не создаёт клиентский сервис. |
| Задать вопрос о CRM в привычном AI-клиенте | Нужно подключение к данным портала. Для такого сценария мы разрабатываем MCP TrueTell. | Проверить конкретный клиент, пользователя, инструмент и результат чтения. |
Где нужен MCP TrueTell
Сотрудник задаёт вопрос в AI-клиенте. Клиент запрашивает доступный инструмент MCP TrueTell, сервер получает результат из Битрикс24, а модель использует его в ответе. Для пользователя важны три вещи: найден ли нужный объект, совпадают ли поля с CRM и сохранены ли ограничения выборки.
Например, чтобы ответить «кто отвечает за эту сделку», нужны сама сделка и достоверная расшифровка ответственного. Описание метода API не заменяет найденную карточку. Если поле не вернулось, модель должна сообщить об этом, а не дополнить ответ правдоподобным именем.
Как работает MCP-сервер для Битрикс24
MCP — протокол обмена между AI-приложением и сервером, который предоставляет инструменты и контекст. Сам протокол не определяет, какие сведения доступны: это зависит от сервера, авторизации и конкретного инструмента. Поэтому запрос «MCP Битрикс24» может приводить к решениям с разным назначением.
| Решение | Направление работы | Какой результат ожидать |
|---|---|---|
| MCP TrueTell | Внешний AI-клиент обращается к доступным инструментам нашего сервера. | Ограниченный результат по данным портала; текущая проверка проведена в Codex. |
| Developer MCP Битрикс24 | AI получает справку о REST API для разработки. | Документация методов; доступа к карточкам портала у этого сервера нет. |
| MCP Hub Битрикс24 | AI-агент внутри Битрикс24 обращается к внешнему сервису. | Результат из выбранного сервиса; направление подключения отличается. |
Наш сценарий — работа из внешнего AI-клиента с данными CRM через MCP TrueTell. Подключение к серверу документации не даёт этот доступ. А подключение внешнего сервиса к агенту внутри Битрикс24 решает задачу с другой точкой входа.
Наличие MCP также не означает работу по расписанию или реакцию на смену стадии. Если требуется автоматическое действие без запроса сотрудника, отдельно определяют событие, условия запуска и допустимые последствия. Такой процесс не следует обещать по результатам проверки чтения.
Что проверено в нашем приложении
В проверке 27 октября 2026 года в Codex подтверждены персональная OAuth-авторизация и успешные вызовы 13 доступных инструментов чтения. Среди них — поиск и просмотр сделок, контактов и компаний, чтение воронок, стадий, пользователей и просроченных задач. Найденные сделка, контакт и компания дополнительно прочитаны по ID; результаты совпали.
Обновление MCP-доступа в рабочем Codex проверено без повторного входа после исправления. Продление OAuth-токена самого Битрикс24, полный выход и повторный вход Codex, а также разграничение прав на сделки двух пользователей ещё не приняты. Отзыв доступа отдельно проверяли на временном тестовом клиенте. Для ChatGPT и Claude путь от входа до ответа по CRM также не принят. Публичная установка и окончательные условия пока не заявлены.
Практические сценарии MCP TrueTell
Ниже — примеры постановки задач по направлениям проверенного чтения в Codex. Это шаблоны для обсуждения и будущей проверки, не расшифровки реальных диалогов и не обещание поддержки в ChatGPT или Claude. ID и условия заменяют на согласованные тестовые значения.
Найти известную сделку, контакт или компанию
Покажи сделку с ID [ID тестовой сделки]. Верни её ID, название и доступные поля. Ничего не изменяй; если поля нет в результате, не придумывай значение.
Начните с точного ID. Совпадение названия недостаточно: у разных записей оно может быть одинаковым. Отдельно можно проверить известный контакт или компанию по их собственному ID. В проверке Codex найденные записи каждого типа были прочитаны обратно; это подтверждает отдельные чтения, но не автоматическое определение связей между ними.
Такой сценарий помогает быстро получить доступные сведения о выбранном объекте. Он не подтверждает доступ ко всей истории общения, письмам, файлам или звонкам: эти источники в рассмотренную проверку не входили.
Понять, к какой воронке и стадии относится сделка
Покажи доступные воронки и стадии выбранной воронки [ID]. Сопоставь их с данными тестовой сделки [ID]. Если справочника или нужного поля нет, оставь код и объясни, чего не хватает для расшифровки.
Стадии проверяют в контексте нужной воронки. Достоверное название берут из её справочника, а не подбирают по похожему коду. Если справочник вернулся частично, это ограничение сохраняют в ответе. Смысл показателей и расчёт конверсии разбираем отдельно в статье о воронке продаж Битрикс24.
Проверить просроченные задачи
Покажи не больше пяти просроченных задач, доступных подключению. Сохрани возвращённые ID и доступные сроки. Укажи условия отбора и сообщи, ограничена ли выборка. Ничего не изменяй.
Сравните полученные ID и сроки с задачами в портале под тем же пользователем. Первые пять строк — удобная проверка чтения, но не доказательство полного списка просрочек. По такой части нельзя делать вывод о нагрузке всего отдела или назначать виновных.
Подготовить сводку продаж
Для запроса о продажах сначала согласуют период, дату отбора, валюту и состав сделок. Ответ должен объяснять, какие записи вошли в расчёт. В нашей проверке инструмент сводки был вызван успешно, но в выбранном диапазоне не было проанализированных сделок. Этот результат не подтверждает корректность сумм на непустой выборке.
Поэтому перед регулярным использованием нужен отдельный тест на согласованном наборе продаж с известными итогами. Формулы, возвраты и полноту данных проверяют по отчёту по продажам Битрикс24. Первый успешный поиск сделки не заменяет эту работу.
Если ответ содержит только часть данных
У результатов чтения MCP TrueTell может быть признак truncated=true: выборка ограничена. В таком случае нейросеть должна сообщить об ограничении. Нельзя назвать возвращённую часть всеми сделками, контактами или задачами и посчитать по ней общий итог.
Следующий шаг — сузить условия, которые поддерживает конкретный инструмент, или прочитать уже найденную запись по её ID. Не следует предполагать скрытый способ продолжения списка. Если данных всё равно недостаточно, запрос нужно уточнить или проверить результат другим согласованным способом.
Пустой ответ также требует проверки: доступна ли запись тому же пользователю в CRM, верен ли ID и подходят ли условия. Он сам по себе не доказывает ни отсутствие объекта во всём портале, ни ошибку подключения.
Что подготовить для обсуждения подключения
AI-клиент и пользователь
Где сотрудник хочет работать и кто будет проверять результат в CRM.
Одна задача
Какой вопрос нужно закрыть: найти запись, показать доступные воронки или проверить небольшой список.
Минимальные данные
Какие сущности и поля нужны. Для первого обращения достаточно описания, без содержимого клиентских карточек.
Критерий результата
С какой карточкой или отчётом сравнить ответ и кто подтвердит совпадение.
При проверке отдельно согласуют права пользователя и доступные инструменты. Фраза в чате «ничего не меняй» не меняет технические разрешения. Проверку чтения проводят инструментом чтения; сценарии записи требуют отдельной оценки и приёмки.
Если проблема начинается с непонятных или повторяющихся полей, сначала полезен аудит полей CRM. Он помогает понять, где хранятся нужные сведения, прежде чем просить модель интерпретировать их.
Следующий шаг — сценарий для MCP TrueTell
Напишите, какой ответ вы хотите получать из Битрикс24 и как сегодня проверяете его вручную. Мы сопоставим задачу с текущим состоянием нашего приложения и назовём, что ещё нужно проверить. Не требуется заранее выбирать сервер из чужой инструкции или предоставлять доступ к порталу, чтобы начать обсуждение.
Вопросы о подключении ИИ к CRM
Можно ли просто попросить нейросеть прочитать мой Битрикс24?
Обычный текстовый запрос не предоставляет доступ к CRM. Нужны подключение к порталу, авторизация и инструмент, который действительно читает нужные данные. Для этого сценария мы разрабатываем MCP TrueTell.
Для чего нужен MCP TrueTell?
Цель нашего приложения — дать внешнему AI-клиенту доступ к согласованным инструментам Битрикс24. При подготовке подключения сначала определяют задачу, минимальные данные и проверяемый результат. Конкретные возможности зависят от принятого клиента и инструментов.
MCP TrueTell уже работает с ChatGPT и Claude?
На 30 октября 2026 года подключение общего MCP TrueTell в ChatGPT и Claude ещё не принято. В проверке Codex 27 октября 13 доступных инструментов чтения ответили без ошибки. Это не доказывает готовность других клиентов или публичной установки.
MCP заменит чат-бота для клиентов?
Сам по себе MCP описывает взаимодействие AI-клиента с инструментами. Бот для клиентов дополнительно требует канала общения, правил диалога, источников ответов и передачи оператору. Такой сценарий нужно проектировать отдельно.
Чем сервер для документации отличается от подключения CRM?
Developer MCP Битрикс24 помогает получать REST-документацию. Он не читает карточки вашего портала. Ответ с описанием метода API и ответ по реальной сделке решают разные задачи.
Можно ли начинать с отчёта по всем продажам?
Лучше сначала проверить известную запись. Для полного отчёта дополнительно нужны период, правила отбора, состав полей, обработка ограничений выборки и сверка итогов. Первое успешное чтение не подтверждает корректность всего отчёта.
Почему короткий список нельзя считать всеми сделками?
Инструмент может вернуть ограниченную выборку. Если результат помечен truncated=true, нужно сузить поддерживаемые условия или открыть уже найденную запись по ID. Нельзя предполагать скрытое продолжение списка и считать по этой части общий итог.
Может ли ИИ сам менять стадии и запускать роботов?
Рассмотренные здесь проверки относятся к чтению. Из них нельзя вывести готовность изменения записей, роботов или работы по расписанию. Такие действия требуют отдельных инструментов, прав и приёмки; MCP сам по себе не задаёт сценарий автоматизации.
Как обсудить подключение MCP TrueTell?
Используйте форму на этой странице. Укажите AI-клиент, одну рабочую задачу и способ проверки ответа. Это обсуждение сценария будущего подключения; открытая установка, цена и срок запуска здесь не обещаются.
Материал обновлён 30 октября 2026 года по отчётам разработки и проверке Codex от 27 октября. Клиентский портал при подготовке статьи не подключали. Документация ниже поясняет общие принципы и отдельные решения; она не подтверждает готовность нашего приложения для каждого клиента.