Подключение BestrankMCP к Bitrix24 за несколько шагов

Ожидают проект на квартал, тендер интеграторов и «цифровую экосистему». На деле - четыре шага в административном разделе BestrankMCP: подключение, токен, возможности, клиент. Через час агент уже может найти просроченную задачу или открыть карточку сделки - если вебхук согласован.

У нас типичная картина: внедренец настроил CRM, отдел продаж живёт в сделках, руководитель услышал про MCP и хочет «попробовать на одном человеке». Общая картина сервера и токена - в BestrankMCP: что это и как устроен доступ по токену. Здесь - только Bitrix24 и конкретные клики.

Что понадобится до начала

• Доступ администратора в административный раздел BestrankMCP.
• Портал Bitrix24 (облако или коробка с доступом по REST).
• Способ авторизации на портале: входящий вебхук или OAuth-токен приложения.
• AI-клиент с поддержкой MCP (Cursor, Claude Desktop и др.).

Вебхук проще для первого раза: создали в портале, скопировали URL, разложили по полям формы. OAuth удобнее, когда политика безопасности не любит долгоживущие вебхуки от имени живого пользователя.

Права вебхука или приложения должны покрывать то, что вы потом включите в возможностях токена. Если дали только «задачи», агент не сможет читать CRM - и это нормально, так и задумано.

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

Откройте административный раздел BestrankMCP. В шапке выберите Подключения → Создать.

1. Укажите продукт Bitrix24.
2. Заполните адрес портала - домен без лишних путей, например company.bitrix24.ru.
3. Укажите способ входа.

Вариант А: входящий вебхук

В портале Bitrix24: Разработчикам → Другое → Входящий вебхук. Создайте вебхук от пользователя с нужными правами (CRM, задачи, диск - по вашему сценарию).

URL вебхука выглядит так:

https://company.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/

Из него в форму подключения идут:

• адрес портала - company.bitrix24.ru;
• ID пользователя - число после /rest/ (в примере 1);
• ключ вебхука - последний сегмент пути.

Вариант Б: OAuth

Если используете приложение Bitrix24, укажите токен доступа в том же подключении. Проверка работает так же - кнопка Проверить на форме.

1. Нажмите Проверить. Сервер должен подтвердить, что до портала достучался.
2. Сохраните подключение с понятным именем: «Основной портал», «Прод Bitrix24» и т.п.

Одно подключение потом можно привязать к нескольким токенам - например, разным отделам с разным набором возможностей.

Шаг 2. Создание MCP-токена

Перейдите в Токены → Создать токен.

Вкладка «Основное»:

• имя токена - чтобы через полгода было ясно, кому вы его выдали;
• срок действия - по политике компании;
• продукт Bitrix24 - выбирается при создании и не меняется.

Вкладка «Подключение»:

• выберите сохранённое подключение к порталу.

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

Сохраните черновик или сразу переходите к возможностям.

Шаг 3. Возможности: что включить агенту

На вкладке Возможности отметьте инструменты, ресурсы и промпты.

Не включайте всё подряд «на всякий случай». Лучше начать с узкого набора:

• чтение задач и CRM;
• пара ресурсов со справочниками портала;
• один-два промпта под ваш сценарий.

Развёрнутый разбор - в статье Возможности токена: что включать агенту и зачем ограничивать список. Там же про принцип минимально необходимого доступа.

Данные портала (отдельная вкладка для Bitrix24):

• словари полей CRM;
• статьи базы знаний;
• шаблоны бизнес-процессов.

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

Логи: включите запись вызовов, если хотите аудит первых недель пилота.

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

Шаг 4. AI-клиент

В Cursor, Claude Desktop или другом клиенте добавьте MCP-сервер Bestrank:

• адрес сервера - канонический endpoint BestrankMCP;
• ключ - скопированный токен.

Детали по каждому клиенту - в Cursor, Claude и другие клиенты: как подключить MCP-сервер. Полный гайд с troubleshooting - в Подключение MCP.

Проверка: попросите агента «покажи мои открытые задачи на этой неделе» или «найди сделку по названию X». Если ответ пустой или ошибка - смотрите логи токена в админке и права вебхука на портале.

Кейс 1: пилот в отделе продаж

Компания, 25 менеджеров, один портал. Руководитель выдаёт MCP одному старшему менеджеру.

Настройка:

1. Вебхук от технического пользователя с правами CRM и задач.
2. Токен «Пилот продажи» - инструменты сделок и задач, ресурс со стадиями воронки, промпт «разбор входящей заявки».
3. Без права удалять сущности и без массовых изменений на первом этапе.

Через две недели по логам видно: агент чаще всего ищет сделки и добавляет комментарии. Расширяют возможности точечно, а не «включить всё CRM».

Кейс 2: поддержка и база знаний

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

1. Подключение с правами на задачи и базу знаний.
2. На Данных портала - одобренные разделы БЗ.
3. В возможностях - чтение задач, создание комментариев, ресурсы с инструкциями.

Агент сначала читает ресурс с регламентом, потом смотрит карточку задачи - и предлагает черновик ответа. Человек правит и отправляет.

Типичные ошибки

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

Токен есть, а агент «не видит» CRM. В возможностях не отмечены инструменты CRM или у вебхука нет прав на CRM.

Данные портала пустые. Не выбрано рабочее подключение или не одобрены справочники на вкладке Данные портала.

Клиент подключается, но инструментов нет. Неверный ключ, истёк срок токена, или в клиенте указан не тот адрес сервера. Сверьтесь с Подключение MCP.

Что дальше после первого успешного запроса

• Добавьте ресурсы под ваши процессы.
• Разберите инструменты: что только читает, что меняет данные.
• Посмотрите каталог Инструменты MCP - там описания по группам: задачи, CRM, календарь.

Куда дальше

Подключение Bitrix24 - это старт, не финал. После первого успешного запроса имеет смысл:

• добавить ресурсы под ваши процессы - воронка, поля, регламенты;
• разобрать инструменты: что только читает, что меняет данные;
• включить один промпт-сценарий под повторяющуюся задачу;
• посмотреть каталог Инструменты MCP - описания по группам: задачи, CRM, календарь.

Полная инструкция с troubleshooting - Подключение MCP. Архитектура токена - BestrankMCP: доступ по токену. Застряли на конкретном портале - напишите нам.