СмыслоКод

Битрикс24: документация REST API

Официальный

Битрикс24

Заявки с сайта и из бота в Битрикс24: агент пишет код по официальной документации

Удалённый сервис: Битрикс24Без ключаРаботает из РоссииТолько читаетБесплатноДанные уходят: Битрикс24, Россия

✓ Проверено 28.09.2026 в Claude Code (macOS) · 5 инструментов

Подключить ↓Что можно сделать ↓

Что сможет агент

  • Найдёт в официальной документации Битрикс24 нужный метод по задаче, описанной словами: «привязать контакт к сделке», «поставить задачу сотруднику».
  • Покажет у метода права, параметры, обязательные поля, возможные ошибки и примеры кода на curl, JavaScript и Python.
  • Предупредит, что метод устарел, и назовёт замену: про crm.lead.add сервер прямо пишет, что вместо него нужен crm.item.add.
  • Расскажет, что приходит в обработчик события, например при создании сделки, и какие права нужны вебхуку для каждого метода.

Паспорт

Кто сделал
Битрикс24
Статус
Официальный
Проверено
28.09.2026
Где работает
Удалённый сервис: Битрикс24
Доступ
Без ключа
Россия
Работает из России
Данные
Данные уходят: Битрикс24, Россия
Цена
Бесплатно
Проверено в
Claude Code
Исходный код
закрыт, сервер удалённый
Документация
apidocs.bitrix24.ru/ai-tools/mcp.html

Подключить

Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.

Промпт для агента
Подключи MCP-сервер «Битрикс24: документация REST API». Работай по шагам и после каждого коротко говори, что сделал.

Данные сервера (каталог smyslokod.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://smyslokod.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: имя, телефон, почта, комментарий и метки рекламы. Адрес вебхука остаётся на сервере.

  1. bitrix-search по словам «создать лид из формы на сайте» первым выдаёт crm.lead.add с пометкой «Развитие метода остановлено. Используйте crm.item.add».
  2. bitrix-method-details по crm.item.add: обязательны entityTypeId и fields, у лида entityTypeId 1, среди полей имя, комментарий, источник и метки utmSource, utmMedium, utmCampaign.
  3. Агент пишет обработчик формы на сервере: адрес вебхука берёт из переменной окружения, в код страницы он не попадает.
Промпт
Сделай так, чтобы заявки с формы на моём сайте попадали в Битрикс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 контакт и сделку, привязанную к нему, в нужной воронке.

  1. bitrix-search «привязать контакт к сделке» находит crm.deal.contact.add.
  2. bitrix-method-details по crm.item.add: у сделки есть categoryId (воронка), stageId, comments и contactIds, поэтому контакт привязывается сразу при создании сделки.
  3. 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 её название и сумму.

  1. bitrix-search по событиям находит onCrmDealAdd, bitrix-event-details показывает: обработчик получает только номер сделки и служебный блок auth с application_token.
  2. Статья «События: обзор методов и событий» с того же сервера: исходящий вебхук подписывают на событие в интерфейсе Битрикс24, адрес обработчика должен открываться из интернета.
  3. 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 из кода проекта и сверит каждый с документацией: есть ли такой метод, не устарел ли он, все ли обязательные параметры на месте и какие права нужны вебхуку.

  1. На несуществующий метод сервер отвечает «Method 'crm.lead.create' not found» и советует начать с bitrix-search.
  2. У устаревших методов в описании пометка DEPRECATED и замена: у crm.lead.add это crm.item.add, у task.comment.add - tasks.task.chat.message.send.
  3. В начале описания метода указаны права: у 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 задачу «Перезвонить» со сроком и привязкой к лиду.

  1. bitrix-search «поставить задачу сотруднику» первым выдаёт tasks.task.add.
  2. bitrix-method-details по tasks.task.add: поля из REST 3.0 (title, creatorId, responsibleId), а примеры из старой версии (TITLE, RESPONSIBLE_ID, привязка UF_CRM_TASK со значением вида L_4).
  3. На сайте это две разные страницы: у 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.

Пример работы

Задача

До первой строки кода узнать, каким методом отправлять заявки с сайта в CRM

Промпт

Найди в документации Битрикс24, как создать лид из заявки с сайта, и покажи обязательные поля

Что сделал агент

  1. bitrix-search («создать лид из формы на сайте»): первым crm.lead.add с пометкой «Развитие метода остановлено. Используйте crm.item.add».
  2. bitrix-method-details (crm.item.add): права crm, обязательные entityTypeId и fields, у лида entityTypeId 1, у сделки 2, среди полей источник, комментарий и метки utmSource, utmMedium, utmCampaign.
  3. bitrix-method-details с несуществующим crm.lead.create: сервер ответил «not found» и предложил начать с поиска.
  4. Сверка с сайтом apidocs.bitrix24.ru: страницы crm.item.add и crm.lead.add говорят то же самое.

Результат

Поиск занял 1,4 секунды, описание метода - 0,2-0,4 секунды. Устаревший crm.lead.add виден сразу, код пишется на crm.item.add.

Редакция, 28.09.2026 · прогон при проверке

Инструменты сервера

5

5 инструментов, описания около 0,9 тыс. токенов. В Claude Code это почти не мешает: инструменты грузятся по запросу. Если в настройках Claude Code задан свой адрес подключения (ANTHROPIC_BASE_URL), в части других клиентов и на старых моделях описания грузятся целиком и занимают место в памяти агента на каждом сообщении.

Нажми на строку, чтобы увидеть оригинальное описание: ровно его читает агент.

Когда не нужен

Если нужно, чтобы агент сам работал с данными твоего Битрикс24 (искал сделки, ставил задачи), это другое подключение: у Битрикс24 для этого отдельный MCP-сервер. Если заявкам с сайта хватит готовой CRM-формы Битрикс24, писать код не нужно: форма вставляется на сайт готовым фрагментом из её настроек, и данные сами попадают в CRM. Если делаешь приложение в Битрикс24 Вайбкод, сервер тоже не нужен: там агент получает документацию сам.

Частые проблемы

В ответе про 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 совпали со страницами документации на сайте.
Версия
Сервер удалённый, версию держит владелец сервиса. Изменения мы ловим сверкой отпечатка.

Проверить самому

Промпт Артемия: агент прочитает код подключения как недоверенный и покажет строки, где читаются секреты, уходят данные или меняются твои настройки.

Полезные материалы

Журнал проверок

ДатаВерсияГдеИтогОтпечаток
28.09.2026удалённыйClaude Code, macOSработает30654713ad52cc11

Отпечаток - контрольная сумма того, что сервер отдаёт агенту: инструкций, инструментов, подсказок и ресурсов. Поменялся при той же версии - поменялось поведение.

Похожие подключения

Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.