Bitrix24 MCP с локальным кешем CRM
bitrix24mcp
MCP-сервер Битрикс24, который держит копию CRM в PostgreSQL или SQLite и отвечает агенту из кеша, а не с каждым запросом к REST
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Создает контакты, сделки и лиды и меняет стадии сделок в реальном портале
- Хранит копию данных CRM, включая клиентские, в собственной локальной базе
Установка
- Работает в
- Сервисы
Ручная установка
pip install -e ".[webhook]"Установка с поддержкой вебхуков реального времени, для только MCP-сервера достаточно pip install -e .
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает контакты, сделки и лиды и меняет стадии сделок в реальном портале
- Хранит копию данных CRM, включая клиентские, в собственной локальной базе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер синхронизирует контакты, компании, сделки, лиды, воронки, стадии и ленту активностей из Битрикс24 в локальную базу и обслуживает чтение агента из этого кеша: поиск и карточки по всем CRM-сущностям, список воронок и стадий конкретной воронки, агрегированную сводку по клиенту и ленту событий CRM, а также отчет по портфелю сделок. Записи (создание контакта, сделки, лида, смена стадии, комментарий в ленту) уходят в Битрикс24 напрямую, а затем обновляют локальный кеш. Авторизация двумя способами: OAuth2 со всплывающим окном входа Битрикс24, который сам получает и хранит токены, либо входящий вебхук без регистрации приложения. Есть опциональный HTTP-обработчик вебхуков реального времени на события изменения контактов, компаний, сделок и лидов, чтобы кеш обновлялся мгновенно, а не только по ручной синхронизации.
Для кого. Для команд с большой CRM-базой, которым важны скорость ответа агента и агрегированные отчеты.
Подходит, если
- Нужна быстрая агрегированная сводка по клиенту или отчет по портфелю сделок без множества запросов к REST
- Нужны мгновенные обновления кеша через вебхуки реального времени
- Нужен выбор между OAuth2 с окном входа и простым вебхуком по ситуации
Не подходит, если
- Не готовы держать локальную базу (PostgreSQL или SQLite) и следить за ее свежестью
- Нужны только свежайшие данные без кеша: TTL кеша может давать чуть устаревший ответ между синхронизациями
Пример запроса к агенту
Покажи агрегированную сводку по клиенту Иванов: сделки, активности и текущий отчет по портфелюMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
BITRIX24_WEBHOOK_URLсекрет- URL входящего вебхука, альтернатива OAuth2
BITRIX24_CLIENT_IDсекрет- ID серверного приложения Битрикс24 для OAuth2
DATABASE_URLобязательная- Строка подключения к локальной базе кеша, SQLite или PostgreSQL
Ограничения
Чтение обслуживается из локального кеша, а не напрямую из Битрикс24, поэтому между синхронизациями данные могут немного отставать, свежесть определяется настройкой CACHE_TTL. Для мгновенных обновлений нужен отдельный процесс HTTP-обработчика вебхуков и регистрация событий в Битрикс24 на его адрес. Первичная синхронизация sync_crm_data нужна перед первым использованием.
Как отключить. Остановите сервер и обработчик вебхуков, удалите файл базы SQLite или базу PostgreSQL и отзовите вебхук или OAuth-приложение в портале.
Частые вопросы
Какой способ авторизации проще?
Входящий вебхук: не нужно регистрировать приложение, достаточно создать вебхук в разделе Разработчикам и вписать его URL.
Как кеш узнает об изменениях в реальном времени?
Через отдельный uvicorn-обработчик на порту 8080, зарегистрированный в Битрикс24 на события onCrmDealAdd, onCrmContactUpdate и подобные.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыMCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
MCP-сервер на TypeScript с более чем 45 инструментами для CRM Битрикс24: контакты, сделки, лиды, компании, задачи и аналитика активности
MCP-сервер Битрикс24 с аналитикой продаж
Bitrix24 MCP Server
MCP-сервер Битрикс24 на TypeScript с широким набором инструментов CRM плюс отдельная группа для мониторинга активности и эффективности менеджеров
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Bitrix24 MCP с локальным кешем CRM (эта карточка) | нет | ключ необязателен | 0 | |
| Bitrix24 MCP от Bit2Beat | нет | API-ключ | 6 | CRM, задачи и диск |
| MCP-сервер Bitrix24 на OAuth-приложении | нет | OAuth | 1 | база знаний |
| MCP-сервер Bitrix24 с расшифровкой звонков | нет | API-ключ | 1 | задачи, CRM и расшифровка звонков |
Коротко о README
README описывает кеширующую архитектуру (REST API, локальная база, MCP-инструменты, агент), структуру пакета по модулям, таблицу из девятнадцати инструментов по CRM и отчетам, установку через pip с опциональной поддержкой вебхуков, два способа авторизации с пошаговыми инструкциями, поднятие PostgreSQL через Docker Compose, запуск сервера, проверку статуса авторизации, первичную синхронизацию, настройку вебхуков реального времени, конфигурации для Claude Desktop и схему базы данных с принципом работы чтения из кеша и записи напрямую в Битрикс24.