fast-bitrix24-mcp
MCP-сервер для аналитики CRM Битрикс24: сделки, лиды, контакты, задачи, активность менеджеров и сделки в риске
Установка
cp .env.example .env
uv add fast-bitrix24-mcp
uv run main.pymain.py создается вручную: импорт mcp из fast_bitrix24_mcp.main и вызов mcp.run(transport="http", host="0.0.0.0", port=8000). В .env нужны WEBHOOK и AUTH_TOKEN.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на базе библиотеки fast-bitrix24 дает агенту списки сделок, лидов, контактов, компаний, пользователей и задач с фильтрами, стадии воронок в человекочитаемом виде и расшифровку пользовательских полей, в том числе списочных. Для отчетов есть готовые инструменты: воронка продаж за период, топ клиентов по сумме сделок, ежедневная сводка, сделки в риске, активность каждого менеджера и менеджеры со снизившейся активностью. Большие выборки сначала экспортируются в JSON-файл, а затем считаются отдельным инструментом анализа: сумма, количество, среднее, группировка. В комплекте главный промпт, который объясняет агенту порядок работы.
Для кого. Для руководителей продаж и аналитиков, которые хотят задавать вопросы к данным CRM Битрикс24 обычным языком.
Подходит, если
- Нужно посчитать сумму сделок по значению пользовательского поля
- Нужно найти менеджеров с просроченными задачами или упавшей активностью
- Нужна ежедневная сводка по лидам, сделкам и звонкам
Не подходит, если
- Нужно создавать и менять сделки: инструменты рассчитаны на чтение и анализ
- Нужен локальный stdio-сервер без запуска HTTP
Пример запроса к агенту
Какая сумма сделок, где поле этаж доставки равно в подвал? И у каких менеджеров есть просроченные задачи?Ограничения
Нужен входящий вебхук Битрикс24. Сервер запускается как HTTP-сервис из собственного Python-скрипта и принимает только запросы с токеном AUTH_TOKEN. Критерии сделок в риске и сниженной активности зашиты в описании и могут не совпадать с вашими правилами. Экспорт создает файлы с данными CRM на диске сервера. Python 3.12, последние изменения в конце 2025 года.
Как отключить. Остановите процесс сервера, удалите подключение из MCP-клиента и отключите вебхук в настройках Битрикс24. Экспортированные JSON-файлы удалите вручную.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WEBHOOK обязательная, секрет | Входящий вебхук Битрикс24 |
| AUTH_TOKEN обязательная, секрет | Токен, который клиент передает в заголовке Authorization |
Проверка безопасности
- Читает данные CRM, включая персональные данные клиентов
- Вебхук может иметь права шире, чем нужно для чтения
- Выгружает данные в файлы на диске
Коротко о README
README на русском перечисляет инструменты по сущностям и показывает примеры вопросов на человеческом языке. Установка идет через uv, сервер запускается из небольшого скрипта в HTTP-режиме, запросы авторизуются токеном. Приведен пример подключения из LangChain и LangGraph, объяснены критерии сделок в риске и приложен главный промпт с описанием инструментов.
Частые вопросы
Понимает ли сервер названия полей вместо кодов UF_CRM?
Да, инструмент get_all_info_fields отдает названия и значения полей, включая списочные, и агент сопоставляет их с вопросом.
Что считается сделкой в риске?
Сделка, у которой статус не менялся больше пяти рабочих дней или нет звонков, комментариев и задач больше трех дней.
Похожие
Официальный 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, ключевые слова, реклама и патенты
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки