bitrix24-custom-mcp: каталог товаров и CRM Битрикс24 для Claude
bitrix24-custom-mcp
Удаленный MCP-сервер на FastMCP читает каталог товаров и CRM Битрикс24 через вебхук, запись по умолчанию выключена
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Вебхук Битрикс24 открывает данные клиентов, сделок и остатков, поэтому права выдают минимальные
- При включенной записи сервер создает и меняет элементы CRM, хотя и через предпросмотр и белый список
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/bitrix24-custom-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Вебхук Битрикс24 открывает данные клиентов, сделок и остатков, поэтому права выдают минимальные
- При включенной записи сервер создает и меняет элементы CRM, хотя и через предпросмотр и белый список
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Python отдает Claude 24 инструмента: 9 для каталога товаров (разделы, товары, цены, остатки по складам) и 12 для чтения CRM (лиды, сделки, контакты, компании, смарт-процессы, воронки, история стадий). Обращения идут в REST API Битрикс24 по входящему вебхуку. Еще 4 инструмента записи появляются только при `ENABLE_WRITES=true`: комментарий в таймлайн, дело, создание и обновление элемента. Для записи нужен отдельный вебхук, создание и обновление сначала показывают предпросмотр и выполняются при `confirm=true`. Методы `*.delete`, массовые правки и смена воронок закрыты белым списком.
Для кого. Менеджерам по продажам и владельцам магазинов на Битрикс24, которым нужны ответы по остаткам, ценам и сделкам прямо в чате с Claude.
Подходит, если
- Остатки по складам и цены надо сверить с карточкой сделки, не открывая портал
- Руководитель просит сводку воронки: число и сумма сделок по стадиям
- После звонка в таймлайн сделки добавляют комментарий с подтверждением
- Перед созданием контакта хочется проверить дубли по телефону и почте
Не подходит, если
- Требуется удаление, импорт или перенос сделок между стадиями: такие методы закрыты
- Облачный тариф Битрикс24 без REST API: вебхуки там недоступны
- Удаленный сервер лишний, а запускать хочется локально
Пример запроса к агенту
Покажи остатки кофемашины по складам и сделки, где она есть в товарных позицияхMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
BITRIX_WEBHOOK_URLобязательная, секрет- Вебхук Битрикс24 для чтения, адрес заканчивается на /
MCP_SECRET_PATHобязательная, секрет- Секретная часть пути /mcp/<секрет>
BITRIX_WRITE_WEBHOOK_URLсекрет- Отдельный вебхук для записи, нужен при ENABLE_WRITES=true
Ограничения
Лицензию автор не указал. Сервер разворачивают самостоятельно: в репозитории есть Dockerfile и `render.yaml`, а адрес защищает только секретный путь `MCP_SECRET_PATH`. Вебхуки Битрикс24 несут права портала, поэтому их выдают минимальными. Документация по развертыванию короткая, тесты покрывают только каталог. Чтение работает без записи, а вебхук для чтения и вебхук для записи хранятся раздельно. Один автор, последний коммит в октябре 2026 года, звезд нет.
Как отключить. Удалите сервер из коннекторов Claude, остановите процесс или контейнер и отзовите оба вебхука в разделе разработчика портала Битрикс24.
Частые вопросы
Как включить запись в CRM?
Задайте `ENABLE_WRITES=true` и отдельный `BITRIX_WRITE_WEBHOOK_URL`. Без второго параметра сервер при старте остановится.
Что будет при создании элемента?
Сначала приходит предпросмотр с проверкой полей и дублей. Элемент создается при повторном вызове с `confirm=true`.
Можно ли удалить сделку через сервер?
Нет. Все методы `*.delete` отклоняются с `PermissionError`.
Как проверить, что сервер работает?
Запрос на `/health` возвращает статус сервиса и признак включенной записи.
Куда попадают секреты вебхуков в логах?
Токены вебхуков в логах скрываются, а запись фиксирует имя инструмента, тип сущности, ID и названия измененных полей без значений.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыPython-сервер для агентов с доступом к порталу Битрикс24 через вебхук: смотрит сделки и контакты, а запись включается отдельной настройкой
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API
Коротко о README
Описаны архитектура с секретным путем, список из 24 инструментов с методами Битрикс24, защита записи, переменные окружения и запуск командой `python server.py`.