Codex и Битрикс24 через MCP: как подготовить и проверить подключение

Какой результат нужен — и что здесь не обещано

Цель маркетолога не «подключить нейросеть», а получить проверяемую сводку: сколько обращений пришло из каждого источника, что с ними произошло и по каким записям можно перепроверить вывод. Если источник не заполнен или статусы ведутся неодинаково, агент не должен дорисовывать картину.

В этой схеме Codex выполняет задачу, MCP-сервер предоставляет ограниченный набор операций, а REST Битрикс24 отдаёт данные согласно правам портала. MCP сам по себе не создаёт доступ к CRM. Названия доступных операций определяет конкретный сервер, а не протокол.

1. Сначала повторите задачу без доступа к CRM

Создайте в отдельной учебной папке файл leads-demo.csv с вымышленными записями. Суммы здесь только часть упражнения, не продажи школы и не показатель настоящей компании.

id,source,status,amount_rub
SYN-101,site,won,10000
SYN-102,ads,new,0
SYN-103,ads,won,20000
SYN-104,site,lost,0
SYN-105,partner,won,15000

Работай только с leads-demo.csv в учебной папке. Это вымышленные данные. Не открывай CRM и сеть, не отправляй сообщения, не меняй исходный файл. Сначала назови число строк и столбцы. Затем посчитай по каждому source число лидов, число status=won и сумму amount_rub только для status=won. Покажи ID записей, на которых основана каждая строка отчёта. Не называй учебные суммы выручкой компании. Если поле отсутствует или значения противоречат правилам, остановись и укажи проблему. Результат сохрани в отдельный файл report.md и прочитай его обратно.

Контроль вручную: 5 лидов, из них 3 со статусом won; сумма учебных значений по ним — 45 000 ₽. По ads — 2 лида и 1 won, по site — 2 и 1, по partner — 1 и 1. Если агент получил другое число, сначала проверьте строки и правило расчёта, а не подключайте реальные данные.

2. Уточните доступность REST и пределы прав в Битрикс24

Администратор вашего портала должен проверить, доступны ли создание вебхуков или приложений и REST на действующих тарифе и подписке. На дату проверки официальная справка Битрикс24 указывает подписку BitrixGPT + Маркетплейс для создания вебхуков и приложений; настройки доступа дополнительно могут быть изменены администратором. Поэтому фраза «работает бесплатно на любом тарифе» здесь была бы неверной.

1. Назначьте отдельного пользователя для пилота и разрешите ему видеть только нужный тестовый набор CRM-записей. Не используйте учётную запись администратора.
2. Если выбранный адаптер работает через входящий вебхук, создавайте его только после проверки первых двух условий. Список методов и scope берите из документации адаптера и Битрикс24. crm — область методов, не переключатель «только чтение»; фактические права зависят также от создателя вебхука.
3. Сохраняйте секрет подключения в предусмотренном защищённом хранилище выбранного решения. Не вставляйте полный URL вебхука в публикацию, скриншот, общий чат, репозиторий или учебный файл. Подготовьте процедуру отзыва и перевыпуска доступа.

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

3. Выберите реальный MCP-адаптер, затем зарегистрируйте его в Codex

Не запускайте неидентифицированную команду вроде bitrix24-mcp-server: без конкретного проекта, версии и протокола теста это не инструкция. Сначала получите от разработчика или поставщика адаптера ссылку на репозиторий/документацию, номер версии, способ установки, поддерживаемый транспорт, список методов и способ передачи секрета. Проверьте владельца проекта, лицензию, обновления и направления сетевых обращений.

Codex поддерживает MCP в настольном приложении ChatGPT, CLI и IDE-расширении. Эти локальные клиенты используют конфигурацию ~/.codex/config.toml; команда codex mcp list показывает настроенные серверы в CLI, а /mcp — активные серверы в терминальном интерфейсе. Подставляйте только проверенную команду или URL из документации выбранного адаптера. Для веб-версии ChatGPT действуют другие, удалённые MCP-подключения: локальный config.toml она не читает.

Если адаптер нельзя однозначно назвать и проверить, остановитесь на CSV-упражнении. Полезный отчёт можно сделать и без интеграции; непроверенный мост к живой CRM не является обязательным этапом обучения.

4. Примите подключение шестью проверками

Рабочее подключение подтверждает не зелёный индикатор, а воспроизводимый ответ из тестового портала. Сохраните дату, версию Codex, версию адаптера, список доступных инструментов и очищенный журнал проверки. Полные ответы с телефонами, email и секретами в отчёт не копируйте.

Проверьте запрет отдельно. Ограниченный список MCP-инструментов в Codex — полезный второй слой, но не замена правам учётной записи в Битрикс24. Если запрещённая операция всё же проходит, пилот не принят, даже если чтение работает. Не проверяйте запись на живом клиенте.

5. Перенесите учебный отчёт на разрешённую выгрузку

Первое полезное применение — недельная сводка лидов по источникам и статусам. Для неё нужны период, правило «что такое лид», актуальные статусы и идентификаторы записей. Если хотите стоимость заявки и окупаемость, нужна ещё сверенная выгрузка расходов из рекламного кабинета и правило атрибуции: сама CRM этих цифр не доказывает.

Используй только разрешённые операции чтения тестовых записей. Не выводи имена, телефоны, email и комментарии клиентов. Покажи число обработанных записей, диапазон дат и доступные поля. Для каждой строки сводки укажи источник и ID записей-оснований. Отдельно перечисли пропущенные источники и неоднозначные статусы. Сначала покажи отчёт на экране; ничего не меняй в CRM, никому не отправляй и не называй суммы выручкой или ROI без проверенных данных о сделках и расходах.

После сравнения с отчётом CRM на контрольной выборке можно автоматизировать подготовку черновика. Рассылка, публикация, изменение статуса и запуск рекламы — отдельные сценарии с отдельными правами и приёмкой, а не продолжение права на чтение по умолчанию.

Частые вопросы

Обычный ChatGPT в браузере вообще умеет MCP?

У веб-версии есть поддерживаемые удалённые MCP-приложения и режим разработчика — доступность зависит от плана и рабочей области. Это не тот же способ подключения, что локальный файл конфигурации Codex. Проверяйте возможности своего аккаунта по текущей справке OpenAI.

Один сервер можно добавить одновременно в Codex и Claude?

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

Сколько стоит связка?

Зависит от тарифа и подписки Битрикс24, выбранного адаптера и его размещения, а также от доступа к ИИ. Не считайте наличие открытого кода доказательством нулевой стоимости работы.

С чего начать собственнику без технической команды?

Сделайте учебный отчёт из пяти строк, как в шаге 1. Затем сформулируйте, какие именно поля CRM нужны, кто проверит результат и какие действия агенту запрещены. Это уже готовый бриф для интегратора и основа для первого занятия.

Вводная встреча бесплатна. Подключение к рабочей CRM обсуждается после проверки прав и данных.