Что сможет агент
- Найдёт в официальной документации Битрикс24 нужный метод по задаче, описанной словами: «привязать контакт к сделке», «поставить задачу сотруднику».
- Покажет у метода права, параметры, обязательные поля, возможные ошибки и примеры кода на curl, JavaScript и Python.
- Предупредит, что метод устарел, и назовёт замену: про crm.lead.add сервер прямо пишет, что вместо него нужен crm.item.add.
- Расскажет, что приходит в обработчик события, например при создании сделки, и какие права нужны вебхуку для каждого метода.
- Кто сделал
- Битрикс24
- Проверено
- 28.09.2026, Claude Code
- Код
- закрыт, сервер удалённый
- Документация
- apidocs.bitrix24.ru/ai-tools/mcp.html
Подключить
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Подключи MCP-сервер «Битрикс24: документация REST API». Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог code.tarasovweb.ru, проверено 28.09.2026):
- имя в конфиге: b24-dev-mcp
- официальный источник: https://apidocs.bitrix24.ru/ai-tools/mcp.html
- удалённый адрес: https://mcp-dev.bitrix24.tech/mcp, вход: без входа
Правила:
1. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
2. Перед правкой конфига сделай его резервную копию.
Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь, нет ли уже сервера с таким именем: `claude mcp get b24-dev-mcp` (в Codex: `codex mcp list`).
2. Подключи сервер:
Claude Code: claude mcp add --scope user --transport http b24-dev-mcp https://mcp-dev.bitrix24.tech/mcp
Codex: codex mcp add b24-dev-mcp --url https://mcp-dev.bitrix24.tech/mcp
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
3. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера около 5 инструментов, перечисли их. Сделай пробный запрос: «Используй MCP-сервер Битрикс24 и покажи параметры метода crm.item.add». Покажи результат.
4. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove b24-dev-mcp --scope user` (в Codex: `codex mcp remove b24-dev-mcp`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://code.tarasovweb.ru/mcp/bitrix24-docs#problemy- Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Ничего: сервер удалённый.
Ключ: не нужен.
Ключ и вход не нужны: сервер отдаёт только документацию и в твой Битрикс24 не заходит. Чтобы заработал код, который напишет агент, в Битрикс24 нужен доступ к REST API: подписка «BitrixGPT + Маркетплейс» на платном тарифе или её пробный режим. В английской документации Битрикс24 указан адрес mcp-dev.bitrix24.com: это тот же сервер, но с документацией на английском и в облаке в США.
Проверь, что работает
Используй MCP-сервер Битрикс24 и покажи параметры метода crm.item.add
Что должно получиться: Агент назовёт обязательные параметры entityTypeId и fields и номера типов: лид 1, сделка 2. Общие слова о CRM без имён параметров значат, что агент отвечает по памяти и к серверу не обращался.
Что можно сделать
5 сценариевЗаявка с сайта попадает в Битрикс24
Агент найдёт в документации действующий метод и сделает так, что заявка с формы на сайте становится лидом в CRM: имя, телефон, почта, комментарий и метки рекламы. Адрес вебхука остаётся на сервере.
- bitrix-search по словам «создать лид из формы на сайте» первым выдаёт crm.lead.add с пометкой «Развитие метода остановлено. Используйте crm.item.add».
- bitrix-method-details по crm.item.add: обязательны entityTypeId и fields, у лида entityTypeId 1, среди полей имя, комментарий, источник и метки utmSource, utmMedium, utmCampaign.
- Агент пишет обработчик формы на сервере: адрес вебхука берёт из переменной окружения, в код страницы он не попадает.
Сделай так, чтобы заявки с формы на моём сайте попадали в Битрикс24 лидом. Перед кодом найди метод через MCP-сервер Битрикс24: сначала bitrix-search, потом bitrix-method-details. Методы по памяти не пиши: crm.lead.add устарел.
Что нужно:
1. Форма отправляет имя, телефон, почту и комментарий на мой сервер, а сервер создаёт лид в Битрикс24.
2. Метки рекламы из адреса страницы (utm_source, utm_medium, utm_campaign) сохраняются в лиде.
3. Если Битрикс24 ответил ошибкой, заявка не теряется: сервер записывает её в журнал, а посетитель всё равно видит «Спасибо».
Формат телефона и почты (массив fm) сверь со страницей метода crm.item.add на apidocs.bitrix24.ru. Адрес входящего вебхука бери только из переменной окружения BITRIX24_WEBHOOK_URL на сервере. Не проси меня прислать его в чат, не пиши его в код и не отдавай в браузер. В конце скажи, какие права (scope) отметить у вебхука.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Телефон и почта у crm.item.add передаются массивом fm, а его формат сервер не расписывает: пусть агент сверит формат со страницей метода на сайте Битрикс24.
- Совет. Для этой задачи вебхуку хватит прав CRM (crm): так написано в описании метода.
- Совет. Ответ «REST API is available only on commercial plans» значит, что в твоём Битрикс24 не включён доступ к REST API: нужна подписка «BitrixGPT + Маркетплейс» или её пробный режим.
Telegram-бот создаёт сделку
Бот спрашивает у клиента имя и телефон, а сервер бота заводит в Битрикс24 контакт и сделку, привязанную к нему, в нужной воронке.
- bitrix-search «привязать контакт к сделке» находит crm.deal.contact.add.
- bitrix-method-details по crm.item.add: у сделки есть categoryId (воронка), stageId, comments и contactIds, поэтому контакт привязывается сразу при создании сделки.
- crm.category.list по описанию сервера отдаёт список воронок: в сделку передаётся номер воронки.
В моём Telegram-боте добавь запись клиента в Битрикс24. Методы и поля бери через MCP-сервер Битрикс24 (bitrix-search и bitrix-method-details), не по памяти.
Как должно работать:
1. Бот спрашивает имя и телефон и просит подтвердить.
2. Сервер бота создаёт в Битрикс24 контакт и сделку, привязанную к этому контакту, в воронке «[название воронки]».
3. В комментарий сделки идёт ник клиента в Telegram и то, что он пришёл из бота.
4. Бот отвечает клиенту, что заявка принята.
Используй crm.item.add: контакт - entityTypeId 3, сделка - entityTypeId 2. Номер воронки найди методом crm.category.list. Поля контакта и формат телефона сверь со страницей crm.item.add на apidocs.bitrix24.ru: сервер показывает поля только лида и сделки. Адрес вебхука бери только из переменной окружения BITRIX24_WEBHOOK_URL. Не проси прислать его в чат и не пиши его в код.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Номера типов в CRM Битрикс24: лид 1, сделка 2, контакт 3, компания 4.
- Совет. Код бота с вебхуком держи на сервере: в самом боте и в репозитории адреса вебхука быть не должно.
Уведомление в Telegram о новой сделке
Битрикс24 сам сообщает твоему серверу о каждой новой сделке, сервер проверяет, что сообщение настоящее, запрашивает сделку и пишет в Telegram её название и сумму.
- bitrix-search по событиям находит onCrmDealAdd, bitrix-event-details показывает: обработчик получает только номер сделки и служебный блок auth с application_token.
- Статья «События: обзор методов и событий» с того же сервера: исходящий вебхук подписывают на событие в интерфейсе Битрикс24, адрес обработчика должен открываться из интернета.
- bitrix-method-details по crm.item.get: обязательны entityTypeId и id, по ним обработчик забирает сделку целиком.
Сделай уведомления в мой Telegram о каждой новой сделке в Битрикс24. Как это устроено, выясни через MCP-сервер Битрикс24: событие onCrmDealAdd (bitrix-event-details) и метод crm.item.get (bitrix-method-details).
Что нужно:
1. Обработчик на моём сервере принимает событие исходящего вебхука Битрикс24 о новой сделке.
2. Проверяет, что запрос пришёл от моего Битрикс24: сравнивает auth[application_token] с токеном из настроек исходящего вебхука.
3. Берёт номер сделки из события, запрашивает сделку через crm.item.get (entityTypeId 2) и присылает в Telegram название и сумму.
4. Повторное событие по той же сделке не шлёт второе сообщение.
Токен исходящего вебхука, адрес входящего вебхука и ключ Telegram-бота бери только из переменных окружения. Не проси прислать их в чат и не пиши в код. В конце скажи, какой адрес обработчика вписать в настройках исходящего вебхука.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Адрес обработчика с localhost или из домашней сети Битрикс24 не достанет: нужен сервер с адресом в интернете.
- Совет. По документации Битрикс24 исходящий вебхук присылает данные формой (application/x-www-form-urlencoded), а пример на странице события записан как JSON: пусть обработчик принимает оба вида.
Проверить код на выдуманные методы
Агент соберёт все вызовы Битрикс24 из кода проекта и сверит каждый с документацией: есть ли такой метод, не устарел ли он, все ли обязательные параметры на месте и какие права нужны вебхуку.
- На несуществующий метод сервер отвечает «Method 'crm.lead.create' not found» и советует начать с bitrix-search.
- У устаревших методов в описании пометка DEPRECATED и замена: у crm.lead.add это crm.item.add, у task.comment.add - tasks.task.chat.message.send.
- В начале описания метода указаны права: у crm.item.add и crm.deal.contact.add это crm.
Проверь код этого проекта, который работает с Битрикс24. Ничего не меняй, пока не покажешь отчёт.
1. Найди в коде все вызовы методов REST API Битрикс24.
2. Каждый метод проверь через MCP-сервер Битрикс24 (bitrix-method-details). Если сервер ответил «not found», найди правильное имя через bitrix-search.
3. Для каждого метода напиши: существует ли он, не устарел ли и чем его заменить, все ли обязательные параметры передаются, какие права (scope) ему нужны.
4. В конце дай общий список прав для вебхука и таблицу правок.
Если в коде или в файлах окружения лежит адрес вебхука, не выводи его в ответ: только отметь, в каком файле он лежит открытым текстом.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Пометка DEPRECATED значит, что Битрикс24 остановил развитие метода: для нового кода бери замену, которую называет описание.
Задача менеджеру перезвонить клиенту
На каждую новую заявку ответственный менеджер получает в Битрикс24 задачу «Перезвонить» со сроком и привязкой к лиду.
- bitrix-search «поставить задачу сотруднику» первым выдаёт tasks.task.add.
- bitrix-method-details по tasks.task.add: поля из REST 3.0 (title, creatorId, responsibleId), а примеры из старой версии (TITLE, RESPONSIBLE_ID, привязка UF_CRM_TASK со значением вида L_4).
- На сайте это две разные страницы: у REST 3.0 вызов идёт по адресу с /rest/api/, у старой версии - по адресу с /rest/.
Когда с сайта приходит заявка и в Битрикс24 создаётся лид, ставь задачу ответственному менеджеру: «Перезвонить: [имя клиента]», срок - через 2 часа, задача привязана к лиду.
Метод найди через MCP-сервер Битрикс24: tasks.task.add. Он есть в двух версиях API Битрикс24, старой и REST 3.0, а сервер может смешать их в одном ответе. Выбери одну версию и держись её: адрес вызова и имена полей должны быть из одной страницы документации. Сверь со страницей метода на apidocs.bitrix24.ru.
Адрес входящего вебхука бери только из переменной окружения BITRIX24_WEBHOOK_URL на сервере. Не проси меня прислать его в чат, не пиши его в код и не отдавай в браузер.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Привязка задачи к лиду в старой версии - UF_CRM_TASK со значением L_<номер лида>, в REST 3.0 - поле crmItemIds.
Пример работы
редакция, прогон при проверке 28.09.2026- Задача
- До первой строки кода узнать, каким методом отправлять заявки с сайта в CRM
- Промпт
- Найди в документации Битрикс24, как создать лид из заявки с сайта, и покажи обязательные поля
- Что сделал агент
- bitrix-search («создать лид из формы на сайте»): первым crm.lead.add с пометкой «Развитие метода остановлено. Используйте crm.item.add».
- bitrix-method-details (crm.item.add): права crm, обязательные entityTypeId и fields, у лида entityTypeId 1, у сделки 2, среди полей источник, комментарий и метки utmSource, utmMedium, utmCampaign.
- bitrix-method-details с несуществующим crm.lead.create: сервер ответил «not found» и предложил начать с поиска.
- Сверка с сайтом apidocs.bitrix24.ru: страницы crm.item.add и crm.lead.add говорят то же самое.
- Результат
- Поиск занял 1,4 секунды, описание метода - 0,2-0,4 секунды. Устаревший crm.lead.add виден сразу, код пишется на crm.item.add.
Инструменты
5 · описания около 0,9 тыс. токеновЖёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если нужно, чтобы агент сам работал с данными твоего Битрикс24 (искал сделки, ставил задачи), это другое подключение: у Битрикс24 для этого отдельный MCP-сервер. Если заявкам с сайта хватит готовой CRM-формы Битрикс24, писать код не нужно: форма вставляется на сайт готовым фрагментом из её настроек, и данные сами попадают в CRM. Если делаешь приложение в Битрикс24 Вайбкод, сервер тоже не нужен: там агент получает документацию сам.
Частые проблемы
5В ответе про tasks.task.add поля записаны по-разному (title и TITLE), а ссылка на страницу метода не открывается
Метод есть в двух версиях API Битрикс24, старой и REST 3.0. Сервер собрал ответ из обеих и дал ссылку на страницу, которой нет. Попроси агента выбрать одну версию: REST 3.0 вызывается по адресу с /rest/api/ и принимает title, responsibleId, старая версия - адрес с /rest/ и поля TITLE, RESPONSIBLE_ID. Сверь со страницей метода на apidocs.bitrix24.ru: у новой версии вверху написано «Метод относится к REST 3.0».
Агент не знает поля контакта или формат телефона для crm.item.add
Сервер отдаёт у crm.item.add поля только лида и сделки, а формат поля fm, где лежат телефон и почта, не расписывает. На странице метода на сайте есть и то, и другое. Попроси агента открыть страницу crm.item.add на apidocs.bitrix24.ru и взять поля оттуда.
Codex после добавления пишет «MCP server may or may not require login»
Codex заранее не знает, нужен ли серверу вход, и предлагает codex mcp login. Вход не нужен: сервер отвечает без ключа и аккаунта, команду codex mcp login запускать не нужно.
По заголовку из поиска приходит другая статья
Инструменты статей подбирают материал по похожему заголовку и иногда берут соседний: на проверке вместо «Как выполнить свой первый запрос к API» пришла «Как вызывать методы REST API». Сверь заголовок и адрес в ответе с тем, что просил. Если статья не та, попроси агента открыть нужную страницу на apidocs.bitrix24.ru напрямую.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.
Безопасность и данные
- Кто сделал
- Битрикс24 (официальный). Исходный код закрыт: сервер удалённый, его держит автор. Поэтому проверяли поведение.
- Что видит агент
- Только то, что агент пишет в запрос: слова поиска, имена методов и заголовки статей. Твой код, файлы и данные Битрикс24 сервер не видит. Битрикс24 просит не передавать серверу вебхуки, токены и пароли: инструментам они не нужны.
- Куда уходят данные
- Данные уходят: Битрикс24, Россия.
- Что может изменить
- Ничего: все пять инструментов только читают документацию. Методы Битрикс24 сервер не вызывает, сделки, контакты и задачи не трогает.
- Наша проверка
- Сервер держит Битрикс24: адрес mcp-dev.bitrix24.tech указан в официальной документации apidocs.bitrix24.ru, на неё ведёт страница mcp.bitrix24.ru компании «1С-Битрикс». Домен зарегистрирован на Bitrix Ltd. в Калининграде, сервер стоит в российском облаке VK Cloud. Исходного кода в открытом доступе нет. Пометок «только чтение» автор не ставил: уровни проставлены по живым вызовам всех пяти инструментов 28.09.2026, версия сервера 0.2.0. Инструкция сервера и описания инструментов прочитаны целиком, скрытых указаний агенту нет, снимок под разными именами клиента одинаковый. Ответы по crm.item.add и crm.lead.add совпали со страницами документации на сайте.
- Версия
- Сервер удалённый, версию держит владелец сервиса. Изменения ловим сверкой отпечатка.
- Проверить самому
- агент прочитает код подключения как недоверенный
Полезные материалы
- ИнструкцияMCP-сервер для работы с REST API Битрикс24Официальная страница сервера: адрес, пять инструментов, подключение в Codex, Cursor, Claude и других клиентах, контрольный запрос.
- ИнструкцияКак получить доступ к REST APIБез этого код, который напишет агент, не заработает: подписка «BitrixGPT + Маркетплейс» или пробный режим.
- ИнструкцияВходящие и исходящие вебхукиКак создать вебхук, выбрать права, проверить подлинность события и что получает обработчик.
- ИнструкцияСоздать новый элемент CRM crm.item.addГлавный метод для новых записей в CRM: поля лида, сделки, контакта и формат телефона и почты.
- ИнструкцияДоступные скоупы Битрикс24Таблица прав: что отметить у вебхука, чтобы методы работали.
- ИнструкцияОбзор REST 3.0Чем новая версия API отличается от старой: адрес с /rest/api/, поля и формат ответа.
Журнал проверок
- 28.09.2026·удалённый·Claude Code, macOS·работает30654713ad52cc11
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Похожие подключения
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
