fast-bitrix24-mcp
MCP-сервер для аналитики CRM Битрикс24: сделки, лиды, контакты, задачи, активность менеджеров и сделки в риске
- 2 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Читает данные CRM, включая персональные данные клиентов
- Вебхук может иметь права шире, чем нужно для чтения
- Выгружает данные в файлы на диске
Установка
- Работает в
- Сервисы
Ручная установка
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.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает данные CRM, включая персональные данные клиентов
- Вебхук может иметь права шире, чем нужно для чтения
- Выгружает данные в файлы на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на базе библиотеки fast-bitrix24 дает агенту списки сделок, лидов, контактов, компаний, пользователей и задач с фильтрами, стадии воронок в человекочитаемом виде и расшифровку пользовательских полей, в том числе списочных. Для отчетов есть готовые инструменты: воронка продаж за период, топ клиентов по сумме сделок, ежедневная сводка, сделки в риске, активность каждого менеджера и менеджеры со снизившейся активностью. Большие выборки сначала экспортируются в JSON-файл, а затем считаются отдельным инструментом анализа: сумма, количество, среднее, группировка. В комплекте главный промпт, который объясняет агенту порядок работы.
Для кого. Для руководителей продаж и аналитиков, которые хотят задавать вопросы к данным CRM Битрикс24 обычным языком.
Подходит, если
- Нужно посчитать сумму сделок по значению пользовательского поля
- Нужно найти менеджеров с просроченными задачами или упавшей активностью
- Нужна ежедневная сводка по лидам, сделкам и звонкам
Не подходит, если
- Нужно создавать и менять сделки: инструменты рассчитаны на чтение и анализ
- Нужен локальный stdio-сервер без запуска HTTP
Пример запроса к агенту
Какая сумма сделок, где поле этаж доставки равно в подвал? И у каких менеджеров есть просроченные задачи?MCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
WEBHOOKобязательная, секрет- Входящий вебхук Битрикс24
AUTH_TOKENобязательная, секрет- Токен, который клиент передает в заголовке Authorization
Ограничения
Нужен входящий вебхук Битрикс24. Сервер запускается как HTTP-сервис из собственного Python-скрипта и принимает только запросы с токеном AUTH_TOKEN. Критерии сделок в риске и сниженной активности зашиты в описании и могут не совпадать с вашими правилами. Экспорт создает файлы с данными CRM на диске сервера. Python 3.12, последние изменения в конце 2025 года.
Как отключить. Остановите процесс сервера, удалите подключение из MCP-клиента и отключите вебхук в настройках Битрикс24. Экспортированные JSON-файлы удалите вручную.
Частые вопросы
Понимает ли сервер названия полей вместо кодов UF_CRM?
Да, инструмент get_all_info_fields отдает названия и значения полей, включая списочные, и агент сопоставляет их с вопросом.
Что считается сделкой в риске?
Сделка, у которой статус не менялся больше пяти рабочих дней или нет звонков, комментариев и задач больше трех дней.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыMCP-сервер Битрикс24 с аналитикой продаж
Bitrix24 MCP Server
MCP-сервер Битрикс24 на TypeScript с широким набором инструментов CRM плюс отдельная группа для мониторинга активности и эффективности менеджеров
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API
Из блога
Коротко о README
README на русском перечисляет инструменты по сущностям и показывает примеры вопросов на человеческом языке. Установка идет через uv, сервер запускается из небольшого скрипта в HTTP-режиме, запросы авторизуются токеном. Приведен пример подключения из LangChain и LangGraph, объяснены критерии сделок в риске и приложен главный промпт с описанием инструментов.