MCP24: как подключить Claude, ChatGPT и другие ИИ к Битрикс24

Коротко

MCP24 — наше приложение в Маркете Битрикс24. Оно подключает внешних ИИ-агентов к облачному порталу по протоколу MCP. Claude, ChatGPT, Cursor, n8n и ещё больше десятка клиентов получают доступ к CRM, задачам, звонкам, диску и другим разделам. Каждому агенту выдаётся своё подключение с отдельным токеном. В нём выбираются разделы и срок действия, а режим по умолчанию — «только чтение». Любое подключение можно отозвать в один клик, а каждый вызов записывается в журнал. Приложение входит в подписку «Битрикс24 Маркетплейс», а ИИ-клиент вы оплачиваете отдельно, по его условиям.

Ролик на 40 секунд: MCP24 — ваш ИИ теперь в Битрикс24 на Rutube.

Зачем это нужно

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

• «Где теряем деньги в воронке?»
• «Какие сделки висят без дел больше недели?»
• «Собери просроченные задачи по ответственным и покажи последние комментарии».
• «Что обещали клиенту на последнем звонке?»
• «Создай задачу по итогам встречи и добавь комментарий в сделку».

Агент сам решает, какие данные запросить, получает их из Битрикс24, считает и отвечает. Если изменения разрешены, он может и действовать: ставить задачи, обновлять поля сделки, писать комментарии.

Чем MCP24 отличается от входящего вебхука

Самый простой способ дать ИИ доступ к порталу — входящий вебхук. Но вебхук открывает агенту всё, на что у него есть права, и сразу навсегда. Отследить, что агент делал, и ограничить его одним разделом нельзя.

В MCP24 доступ устроен иначе:

• Отдельное подключение каждому агенту. У Claude в отделе продаж и у сценария в n8n разные токены, разделы и права. Отозвать можно одного, не задев остальных.
• «Только чтение» по умолчанию. В новом подключении переключатель «Разрешить изменения» выключен. В этом режиме агенту доступен 51 инструмент, а любая попытка записи отклоняется. С разрешением на изменения инструментов 71.
• Только нужные разделы. CRM, задачи, сотрудники и структура, календарь, чаты, открытые линии, телефония, диск, группы, живая лента, списки, бизнес-процессы, учёт времени, каталог товаров и другие включаются галочками.
• Срок жизни токена. 7, 30 или 90 дней, год, своя дата или бессрочно.
• Журнал каждого вызова. В нём видно подключение, время, инструмент, методы REST, результат и длительность, а также все отказы.

Каждый запрос проходит пять проверок

1. Токен действует, не отозван и не истёк.
2. Раздел: инструмент входит во включённые разделы подключения.
3. Чтение или запись: изменения проходят, только если они разрешены. Режим проверяется при каждом вызове, в том числе для универсального REST-инструмента. Незнакомый метод считается записью.
4. Лимиты: если Битрикс24 отвечает ограничением запросов, MCP24 ждёт сброса до 45 секунд и повторяет запрос сам.
5. Журнал: записывается и успешный вызов, и отказ.

Если подходящего инструмента нет, агент находит нужный метод в документации Битрикс24 и вызывает его, но только в разрешённых разделах и в разрешённом режиме.

Какие ИИ-клиенты подходят

В приложении есть пошаговые инструкции с уже подставленным токеном для 16 профилей:

• Чат-ассистенты: Claude (claude.ai и Claude Desktop), ChatGPT в режиме разработчика, Mistral Le Chat.
• Редакторы кода и агенты разработчика: Claude Code, Cursor, VS Code с GitHub Copilot, Windsurf, Zed, Cline, Gemini CLI, OpenAI Codex CLI.
• Автоматизация: n8n, Make, Dify.
• Локальные модели: LM Studio с моделью, которая умеет вызывать инструменты.
• Любой другой MCP-клиент: по адресу сервера и Bearer-токену или через mcp-remote.

Внешние MCP-серверы поддерживаются не во всех версиях и тарифах клиентов. Например, в ChatGPT это зависит от тарифа, так что проверьте свой заранее.

Как подключить агента

1. Администратор портала устанавливает MCP24 из Маркета Битрикс24 и подтверждает права приложения.
2. Открывает MCP24 в разделе «Приложения» и нажимает «Создать первое подключение».
3. Указывает имя, выбирает ИИ-клиент, разделы и срок токена. «Разрешить изменения» пока оставляет выключенным.
4. Нажимает «Создать и получить токен» и сохраняет токен: полностью он показывается только один раз.
5. Добавляет адрес MCP-сервера и токен в настройки клиента по инструкции из приложения.
6. Задаёт агенту вопрос по разрешённому разделу и проверяет вызов на вкладках «Журнал» и «Аналитика».

На всё уходит пара минут. Запись лучше включать позже, когда вы убедитесь, что агент правильно понимает ваши данные.

Журнал и аналитика

На вкладке «Аналитика» видно число обращений за период, долю успешных, ошибки и отклонённые действия, а также график по дням и активность каждого агента. В журнале по каждому вызову открываются инструмент, методы REST, аргументы без секретов и текст ошибки. Подробный журнал хранится в хранилище данных приложения на вашем портале, и видят его только администраторы. Записи могут появляться с небольшой задержкой.

Безопасность и данные

• Токены не хранятся в открытом виде. На сервере MCP24 лежат только хеш SHA-256 и последние четыре символа. Отозванный токен перестаёт работать сразу, перебор неизвестных токенов блокируется.
• Права сотрудника. Подключение работает от имени администратора, который его создал. Агент видит не больше, чем видит этот сотрудник.
• Удаление приложения отзывает все подключения портала.
• Куда уходят данные. Ответы на запросы агента проходят через сервер MCP24 и передаются в выбранный ИИ-клиент. Дальше данные обрабатываются по условиям этого сервиса. Claude, ChatGPT и другие зарубежные сервисы обрабатывают их за рубежом, а это трансграничная передача персональных данных. Если агент будет работать с ФИО, телефонами и перепиской клиентов, оцените это заранее. Безопаснее всего включать только те разделы, которые действительно нужны, а для чувствительных данных использовать локальную модель.

Что нужно для работы

• Облачный Битрикс24. Коробочная версия не поддерживается.
• Права администратора портала: подключения создаёт и меняет администратор.
• ИИ-клиент с поддержкой внешнего MCP-сервера по HTTP или совместимым способом.

Набор доступных разделов и методов зависит от тарифа и настроек портала. Телефония, открытые линии и бизнес-процессы работают, только если они настроены у вас.

MCP24 и Марта AI

В Битрикс24 есть и обратное направление: встроенный Агент Марта AI сам подключается к внешним системам по MCP, например к 1С. Как это настроить, мы разбирали в статье «1С в Битрикс24 через MCP». MCP24 решает другую задачу. Он нужен, когда вы уже работаете в Claude, ChatGPT, Cursor или n8n и хотите, чтобы эти инструменты видели ваш портал. Подходы можно сочетать: Марта отвечает сотрудникам внутри Битрикс24, а внешний агент через MCP24 строит отчёты, разбирает воронку или работает в автоматизациях n8n.

Поможем внедрить

Установить приложение и создать первое подключение можно самостоятельно, за несколько минут. Если хочется большего — продумать, какие разделы и кому открыть, собрать сценарии в n8n или научить агента вашим воронкам и отчётам, — напишите нам. Подробности о приложении на странице MCP24, о работах с ИИ — на страницах услуг «ИИ в Битрикс24» и «Разработка AI-агентов».