Как настроить ИИ-агента в Битрикс24: MCP, CRM и сценарии
Включите MCP, подключите внешнего AI и соберите сценарии по лидам, сделкам и задачам — без путаницы Hub/Server и без админского токена «на всё»
ИИ в Битрикс24 уже не «чатик с советами». Можно собрать агента, который читает CRM, готовит сводку по сделке, создаёт задачу менеджеру и — только после вашего подтверждения — пишет в портал. Ниже — практический гайд: какие контуры MCP бывают, как включить MCP Server, что платное, какие три сценария запустить первыми и как не отдать агенту админский доступ «на всякий случай».
Коротко. В Битрикс24 есть агент внутри портала (BitrixGPT / Марта), внешний AI через MCP Server, внешние сервисы через MCP Hub и отдельно Dev MCP только для документации. Для RU-портала endpoint сервера: https://mcp.bitrix24.tech/mcp/. Внешние MCP-интеграции — по подписке BitrixGPT + Маркетплейс от ~800 ₽/мес.
# read → draft → write + approval
→ лид · сделка · задача · MCP OK
Кому нужен ИИ-агент в Битрикс24, а кому хватит чата
Если вам нужно иногда переформулировать письмо или спросить «что ответить клиенту» — хватит обычного чата с нейросетью. ИИ-агент в Битрикс24 имеет смысл, когда повторяются одни и те же действия в CRM и задачах: найти сделку, собрать контекст, набросать задачу, проверить контрагента, не потерять лид в чате.
Типичный читатель этого гайда — владелец малого бизнеса, маркетолог или руководитель отдела продаж в России. У вас уже есть Битрикс24. Нет отдельного отдела разработки. Нужна автоматизация CRM нейросетью без «ещё одного фреймворка ради фреймворка».
Чем агент отличается от копилота и обычных подсказок
Копилот и подсказки помогают писать текст. Агент ещё и действует в системе: создаёт задачу, ищет сделку, двигает стадию — в рамках прав сотрудника и часто с кнопкой «подтвердить».
BitrixGPT и Марта — внутренний контур: сотрудник остаётся в интерфейсе Битрикс24. Внешний клиент (Cursor, ChatGPT, Yandex AI Studio, n8n) управляет порталом через MCP Server. Это два разных пути, а не «одна кнопка с двумя названиями».
Какие боли закрывает связка CRM + задачи + лиды
- Лид пришёл, а менеджер утонул в переписке — нужна короткая сводка по сделке.
- План созвона есть в чате AI, а задач в Битрикс24 ещё нет.
- Перед звонком надо быстро проверить контрагента, не раздавая всем доступы к сторонним сервисам.
- Однотипные follow-up и черновики задач съедают час каждый день.
Итог раздела: агент нужен там, где есть повторяемые действия в CRM. Чат — там, где нужна только формулировка.
Четыре контура MCP — и почему их путают в справках
Самая частая ошибка новичков — смешать четыре разных «MCP» в один. Из-за этого подключают не тот URL, ждут живую CRM от Dev MCP или платят за Hub, думая, что «включили сервер».
| Контур | Куда направлен | Что делает | Типичный клиент |
|---|---|---|---|
| Агент внутри портала | Внутри Битрикс24 | Управляет задачами, CRM, календарём из чата BitrixGPT/Марты | Сотрудник в B24 |
| MCP Server | Снаружи → в портал | Внешний AI читает/пишет в Битрикс24 | Cursor, ChatGPT, Yandex AI Studio, n8n |
| MCP Hub | Снаружи → в чат агента | Подключает 1С, Контур.Фокус и др. к чату внутри B24 | BitrixGPT / агент в портале |
| Dev MCP | Только документация | Отдаёт актуальные docs REST API для IDE | Cursor/VS Code при разработке |
Агент внутри портала (BitrixGPT / Марта)
Это сценарий «живу в Битрикс24». Сотрудник пишет агенту в чате портала: «найди сделку X», «создай задачу», «что по этой встрече». Внешний Cursor не нужен. Базовый лимит чата на тарифах есть; для активной работы без жёсткого лимита смотрите подписку BitrixGPT + Маркетплейс.
MCP Server: внешний AI управляет порталом
Здесь наоборот: вы уже работаете в ChatGPT, Cursor или n8n и хотите, чтобы этот AI трогал живой портал. Админ включает разрешение для внешних AI. Подключение — через OAuth или токен. Для RU-справки рабочий URL:
https://mcp.bitrix24.tech/mcp/
Действия выполняются по правам того пользователя, который авторизовал подключение. Часто перед записью система просит подтверждение.
MCP Hub: внешние сервисы в чате агента
Hub нужен, когда агенту внутри Битрикс24 не хватает своих модулей: нужна проверка контрагента, данные из 1С, сервис с Маркетплейса. Подключение идёт в чате агента через «Подключения», с выбором, кому доступно: только вам или отделу. Для Hub нужна подписка BitrixGPT + Маркетплейс. На маркетинговом лендинге блок Hub иногда ещё помечен «скоро», хотя в RU-зоне сервис уже доступен по справке — ориентируйтесь на настройки в портале, а не на баннер.
Dev MCP — только документация, не живая CRM
Dev MCP (mcp-dev…) отдаёт актуальные описания REST API для кодогенерации в IDE. Он не создаёт сделки и не двигает воронку. Если подключили Dev MCP и удивляетесь, что CRM «не слушается» — вы не на том контуре.
Итог раздела: перед настройкой скажите вслух, какой контур нужен. Одна фраза экономит день отладки.
Четыре MCP — четыре направления
Пока пакеты бегут по схеме, запомните: Server открывает дверь внутрь портала, Hub — наружу к сервисам, Dev — только docs. Путаница URL = день отладки.
- Агент в портале — BitrixGPT / Марта внутри Битрикс24.
- MCP Server — Cursor / ChatGPT / n8n → живая CRM.
- MCP Hub — 1С, Контур.Фокус → чат агента.
- Dev MCP — документация REST, не сделки.
Дальше — чеклист админа: тумблер MCP, OAuth или токен и безопасный тест только на чтение.
Редакционная схема, не скриншот портала: направления потоков и ошибка «Dev пишет в CRM» показаны упрощённо.
Как включить MCP Server и не сломать права админа
Ниже — пошаговый блок, который можно повторить без разработчика. Цель: внешний AI видит портал, но не получает «ключи от квартиры».
Чеклист админа: тумблер, OAuth или токен
Шаг 1. Войдите в Битрикс24 под администратором. Откройте Настройки → MCP. Включите пункт вроде «Разрешить внешним AI-системам выполнять действия в Битрикс24» (по умолчанию выключен).
Шаг 2. Решите способ входа:
- OAuth — удобно для ChatGPT (Developer mode → Create connector → URL
https://mcp.bitrix24.tech/mcp/→ Authorization OAuth → вход в портал). - Токен — удобно для Yandex AI Studio и ручных клиентов: Приложения → MCP-подключения → Получить токен подключения.
Шаг 3. Во внешнем AI укажите транспорт Streamable HTTP и URL https://mcp.bitrix24.tech/mcp/. Для токена добавьте header Authorization = ваш токен (или готовый коннектор «Битрикс24», если клиент его предлагает).
Шаг 4. В чате AI выберите интеграцию Bitrix24. Сделайте безопасный тест: «Найди сделки на стадии …» или «Покажи мои задачи на сегодня» — только чтение.
Шаг 5. Когда понадобится запись (создать задачу, сделку), подтверждайте действие вручную. Не отключайте confirmation «чтобы быстрее».
Шаг 6. Чтобы отозвать доступ: Приложения → MCP-подключения → Мои токены → Закрыть доступ (через Битрикс24 Паспорт).
Признак успеха. Внешний AI отвечает данными из вашего портала (названия сделок/задач совпадают с CRM). При попытке записи появляется запрос подтверждения. В списке MCP-подключений видно активный токен/сессию именно того сотрудника, которого вы планировали.
Подключение Cursor / ChatGPT / n8n одной схемой
Схема одна и та же: админский тумблер → OAuth или токен → URL .tech → тест на чтение → write только с approval. Разница только в интерфейсе клиента:
- ChatGPT — коннектор + OAuth.
- Cursor — MCP-подключение с URL и токеном/OAuth по документации клиента.
- n8n — как поддерживаемый внешний клиент MCP Server (отдельный лонгрид по n8n здесь не нужен: достаточно того же endpoint).
Выбирайте клиент по привычке команды. Не ставьте три клиента «на всякий случай» — размножите токены и хаос прав.
Типичные ошибки URL и «пустой» ответ агента
- 1. Подключили Dev MCP вместо Server. Симптом: агент рассуждает про API, но CRM не меняется. Решение: URL
https://mcp.bitrix24.tech/mcp/, неmcp-dev. - 2. Тумблер внешних AI выключен. Симптом: ошибка доступа или пустой ответ. Решение: Настройки → MCP → разрешить внешние системы.
- 3. Токен сотрудника без прав на CRM. Симптом: «не вижу сделки». Решение: выдать права на нужные сущности тому пользователю, чей токен/OAuth, а не «дать админа агенту».
- 4. Перепутали
.comи.tech. Для RU-гайда ориентир — mcp.bitrix24.tech. - 5. Ждут Hub-сервисы через Server. Hub подключается в чате агента внутри B24, это другой контур.
BitrixGPT и подписка Маркетплейс — что реально платное
Запрос «bitrixgpt» в поиске огромный, поэтому важно не смешать «бесплатный базовый чат» и «платные внешние MCP».
Базовый лимит чата vs внешние MCP-интеграции
Работа агента BitrixGPT с внутренними инструментами портала идёт в рамках базового лимита на тарифах — без отдельной подписки на старте. Но активная работа «без упора в лимит» и внешние MCP-интеграции (MCP Server + MCP Hub) завязаны на подписку BitrixGPT + Маркетплейс.
Ориентир цены в зоне ru: от ~800 ₽ в месяц, зависит от тарифа портала. На платных тарифах в подписку заявляют безлимитные запросы к внешним MCP — сверяйте актуальный прайс в разделе подписки портала.
Как включить и проверить, что подписка активна
- 1. Откройте раздел приложений / подписки BitrixGPT + Маркетплейс в портале.
- 2. Оформите подписку на нужный тариф (облако; для коробки подписка тоже доступна через соответствующие модули).
- 3. Проверьте: в чате агента доступны «Подключения» для Hub; внешний клиент по MCP Server отвечает без ошибки тарифа/лимита.
- 4. Сделайте один read-запрос и один draft (черновик задачи без обязательной записи в CRM).
Признак успеха. В интерфейсе подписка отображается как активная; внешний MCP не отвечает ошибкой лимита/тарифа; в чате агента видны подключения Hub (если планировали Hub).
Лимиты, follow-up и «BitrixGPT отключен»
Если BitrixGPT «пропал» или пишет про лимиты:
- проверьте, не закончился ли базовый лимит без подписки;
- проверьте, не отключили ли ИИ в настройках портала/для сотрудника;
- для follow-up и агентных сценариев убедитесь, что нужный контур (внутри / Server / Hub) реально включён, а не только «галочка в голове».
Не лечите «отключен» выдачей админ-токена — сначала тариф и права пользователя.
Марта и агент внутри портала — когда остаётесь в Битрикс24
Марта и агент BitrixGPT — путь для команд, которые почти не выходят из портала. Менеджер пишет в чат Битрикс24, получает сводку, создаёт задачу, смотрит календарь — без Cursor.
Что агент умеет в задачах и CRM без внешнего клиента
По заявленному scope внутренних инструментов и MCP-сервера агент может (в рамках прав):
- Задачи: создать/найти, сроки, чек-листы, исполнитель, важность.
- CRM: найти сделку и стадии, создать сделку, работать с полями и воронкой, перемещать сделки.
- Календарь, диск, чаты — по мере доступности в вашем тарифе и релизе.
Список расширяется. Не обещайте команде «полный REST = полный MCP»: это разные уровни доступа.
Когда внутренний агент быстрее внешнего MCP
Оставайтесь внутри портала, если:
- сотрудники боятся IDE и внешних чатов;
- сценарий простой: сводка + задача + напоминание;
- не нужны 1С/Контур в том же диалоге (или Hub ещё не подключали).
Идите во внешний MCP Server, если команда уже живёт в Cursor/ChatGPT, пишет планы там же и хочет «один чат — и CRM, и код/контент».
Три рабочих сценария: лид, сделка, задача
Ниже три пилота без отдельного n8n-лонгрида. В каждом соблюдайте цепочку read → draft → write после approval.
Сводка по сделке и черновик задачи менеджеру
- 1. Read: «Найди сделку [название/ID]. Кратко: стадия, сумма, последний комментарий, открытые задачи».
- 2. Draft: «Сформулируй задачу менеджеру: что сделать до завтра, без записи в портал».
- 3. Approval + write: только после проверки текста — «Создай задачу в Битрикс24 с этим текстом, исполнитель — …».
Запрет на старте пилота: не просите двигать стадию и не шлите письма клиенту от лица агента.
Создание задач из плана во внешнем чате AI
Подходит, если план созвона родился в ChatGPT/Cursor.
- 1. Вставьте план в чат с подключённым MCP Server.
- 2. Read: уточните, нет ли уже похожих задач у исполнителя.
- 3. Draft: список задач с сроками (ещё не создавать).
- 4. Write по одной: создавайте задачи по очереди с confirmation — так проще откатить ошибку.
Проверка контрагента через Hub без хаоса доступов
- 1. Включите Hub (нужна подписка BitrixGPT + Маркетплейс).
- 2. В чате агента → Подключения → сервис проверки (например, Контур.Фокус) → доступ «только себе» на пилоте.
- 3. Один активный внешний сервис на запрос в чате BitrixGPT — не смешивайте пять подключений в одном сообщении.
- 4. Спросите проверку → сохраните вывод в комментарий к сделке только после ручной проверки цифр.
Итог раздела: три сценария закрывают 80% «хотелок» на старте. Всё остальное — после двух недель без инцидентов с правами.
Сводка по сделке
Read → draft задачичи → write после approval.
Задачи из плана AI
Создавайте по одной с confirmation — проще откат.
Контрагент через Hub
Один сервис на пилоте, доступ «только себе».
No-code: AI-узел и MCP-инструменты в бизнес-процессе
Если нужна не разовая команда в чате, а повторяемый процесс, смотрите бизнес-процессы Битрикс24 с AI-узлом. По сути AI-агент здесь — шаблон процесса, где рядом с обычными шагами стоит нейросеть, а инструменты объявляются MCP-узлами на графе.
Allowlist инструментов на шаге графа
На каждом шаге явно укажите: читать CRM — да; создавать задачу — да; менять стадию — нет (пока). Пресеты вроде базы знаний, тестирования сотрудников, управления проектами удобны как старт, но всё равно сузьте инструменты под ваш отдел.
Где Skill Pack дополняет MCP, а не заменяет
MCP хорошо «находит» методы и поля. Skill Pack (подход Битрикс24 к runtime-навыкам) сильнее в продакшене: план до действия, allowlist, аудит, ограничение частоты. Это не конкуренты: MCP — разъём и discovery, Skill — дисциплина выполнения. Для пилота достаточно MCP + confirmation; для потока лидов добавьте жёсткий allowlist и аудит.
Безопасный пилот: read → draft → write после approval
Рынок ИИ-агентов для бизнеса растёт: команды ждут, что агент снимет рутину. Но в CRM цена ошибки — испорченная воронка и письмо «не тому клиенту». Правило пилота одно.
Почему нельзя выдавать админ-токен «на всякий случай»
Доступ внешнего AI = права пользователя, выдавшего OAuth/токен. Админ-токен = админские риски: агент теоретически достаёт до настроек, пользователей, лишнего. Для пилота создайте (или используйте) учётку менеджера с минимальными правами на нужные воронки и задачи.
Чеклист владельца CRM:
- отдельный сотрудник/роль под агента, не «Главный админ»;
- confirmation на write включено;
- запрет смены стадии и писем клиенту на первые 2 недели;
- список MCP-подключений проверяете раз в неделю;
- любой подозрительный токен — «Закрыть доступ» сразу.
Непроверенные MCP и риск скрытых инструкций
Официальный FAQ Битрикс24 прямо предупреждает: безопасность зависит от конкретного MCP-сервера; непроверенный сервер может нести риски. Подключайте официальный endpoint портала и проверенные сервисы Hub. Сторонние webhook-«прокси» с советом «отметить все права» — антипаттерн.
Итог раздела: сначала дисциплина прав, потом красота сценариев.
FAQ по настройке ИИ-агента и MCP в Битрикс24
Чем MCP Server отличается от MCP Hub
MCP Server — внешний AI управляет вашим Битрикс24. MCP Hub — внешние сервисы подключаются к чату агента внутри Битрикс24. Dev MCP — вообще про документацию API, не про живую CRM.
Нужна ли подписка BitrixGPT + Маркетплейс
Для знакомства с внутренним чатом агента часто хватает базового лимита. Для стабильной работы без упора в лимит и для внешних MCP (Server и Hub) — да, ориентир от ~800 ₽/мес в зоне ru, уточняйте в портале.
Можно ли подключить Cursor без разработки
Да: админ включает MCP, вы берёте токен или OAuth, указываете https://mcp.bitrix24.tech/mcp/, тестируете чтением. Код писать не обязательно. Dev MCP для REST docs нужен только если вы как раз разрабатываете интеграцию.
Почему агент видит CRM, но не двигает стадии сам
Так и должно быть на безопасном пилоте. Либо нет права на изменение стадии у пользователя токена, либо write ждёт confirmation, либо вы сами запретили стадии в правилах пилота. Сначала научите агента готовить черновик «перевести на …», и только потом разрешите write.
От пилота в CRM к агентной автоматизации контента
Когда пилот в CRM стабилен, тот же принцип агентов переносится на контент и лиды с сайта.
Лид → карточка → задача → сводка как конвейер
- 1. Лид приходит с сайта / онлайн-чата в CRM.
- 2. Агент (внутри или через MCP Server) читает карточку и готовит сводку.
- 3. Создаётся задача менеджеру с чек-листом первого касания.
- 4. После сделки агент помогает собрать короткую внутреннюю сводку для маркетинга: что сработало в аргументах.
Так вы получаете не «игрушку в чате», а конвейер: лид → карточка → задача → смысл для следующего касания.
Куда смотреть дальше: MCP, вайбкодинг, контент-завод
Следующий уровень — связать CRM-агента с контент-контуром: черновики постов, ответы в Telegram, публикации в блог. Тот же навык «права + MCP + approval» пригодится в Cursor и в no-code связках. Если цель — система производства контента и агентной автоматизации, а не разовая настройка одной кнопки, логичный путь — углублять MCP-практику и собирать контент-завод вокруг уже работающего CRM-контура.
Если цель — не разовая кнопка в Битрикс24, а система агентной автоматизации и контент-контура, логичный следующий шаг — обучение по автоматизации и вайбкодингу на kv-ai.ru: Make, сценарии и связка инструментов под реальные задачи.
Что проверяли по источникам
- Официальный лендинг MCP Битрикс24 и RU-справка по внешнему MCP Server (URL
.tech, OAuth/токен, confirmation). - Справка по MCP Hub и тарифу BitrixGPT + Маркетплейс (ориентир от ~800 ₽/мес).
- Материалы Битрикс24 про no-code AI-узел в бизнес-процессах и отличие Skill Pack от MCP.
- Практики безопасного пилота: read → draft → write после approval, без админ-токена.
Практический чек-лист на сегодня
- Выбрать контур: внутри / Server / Hub (не Dev).
- Включить тумблер внешних AI, если нужен Server.
- Подключить клиента по
https://mcp.bitrix24.tech/mcp/. - Прогнать сценарий «сводка + черновик задачи» без смены стадий.
- Через неделю — решить по подписке BitrixGPT + Маркетплейс и Hub.
