Bitrix24 MCP Server
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
Установка
export BITRIX_WEBHOOK_URL="https://your-domain.bitrix24.ru/rest/1/yoursecretcode/"
uvx bitrix24-mcpВ конфигурации клиента укажите команду uvx с аргументом bitrix24-mcp и ту же переменную в env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к облачному или коробочному Битрикс24 по входящему вебхуку и дает агенту работу с CRM. Агент может найти контакт по имени, телефону или email, получить контакт или сделку по ID, выбрать сделки по контакту, компании или признаку активности. Единственная пишущая операция меняет стадию сделки. Кроме инструментов сервер отдает MCP-ресурсы с карточками контактов, сделок и списком активных сделок в читаемом виде.
Для кого. Для отделов продаж и интеграторов Битрикс24, которым нужен быстрый доступ агента к контактам и сделкам.
Подходит, если
- Нужно найти клиента в CRM по телефону или email прямо из диалога с агентом
- Нужно получить список активных сделок по компании
- Нужно перевести сделку на другую стадию без захода в интерфейс
Не подходит, если
- Нужны лиды, задачи, смарт-процессы или пользователи: инструментов для них нет
- Нельзя давать агенту вебхук с правами на изменение CRM
Пример запроса к агенту
Найди в Битрикс24 контакт с телефоном +7 916 000-00-00 и покажи его активные сделкиОграничения
Покрыты только контакты и сделки. Нужен входящий вебхук Битрикс24 с правами crm, адрес вебхука содержит секретный код и дает доступ к CRM. Последние изменения в репозитории больше года назад.
Как отключить. Удалите сервер из конфигурации MCP клиента и удалите или отключите входящий вебхук в настройках Битрикс24.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX_WEBHOOK_URL обязательная, секрет | Адрес входящего вебхука Битрикс24 с секретным кодом |
Проверка безопасности
- Меняет стадии сделок в рабочей CRM
- Адрес вебхука с секретом дает доступ к персональным данным клиентов
Коротко о README
README на русском описывает требования: Python 3.12+ и входящий вебхук с правами crm. Сервер запускается через uvx после задания BITRIX_WEBHOOK_URL. Перечислены инструменты для контактов и сделок, MCP-ресурсы и порядок участия в разработке. Лицензия MIT.
Частые вопросы
Работает ли с коробочной версией?
Да, по README поддерживаются облачный и коробочный Битрикс24, нужен только входящий вебхук.
Что сервер может изменить в CRM?
Только стадию сделки через инструмент update_deal_stage, остальные инструменты читают данные.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
E-Commerce Skills
E-Commerce Skills by Nexscope
Большой набор текстовых скиллов для продавцов Amazon, Shopify, eBay, Etsy, TikTok Shop и Walmart: цены, листинги, реклама, рост
153 скилла для кросс-бордер e-commerce через API LinkFox: Amazon, Ozon, TikTok Shop, 1688, ключевые слова, реклама и патенты
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров