Bitrix24 MCP Server
b24-mcp
Асинхронный MCP-сервер на FastAPI для CRM Битрикс24: сделки, лиды, контакты, задачи и справочники с подсказками по фильтрам дат
Установка
cp .env.example .env
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn mcp_server.app.main:app --reloadВыполняйте в клоне репозитория, в .env укажите BITRIX_BASE_URL и BITRIX_TOKEN.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер переводит вызовы MCP в запросы к REST API Битрикс24 через входящий вебхук или OAuth-токен. Инструменты выдают сделки, лиды, контакты, пользователей, задачи и компании, а записи обогащаются понятными названиями стадий, источников и ответственных из кэшированных справочников. Если агент не задал диапазон дат, сервер добавляет предупреждение и готовый фильтр, чтобы не выгружать всю CRM. Отдельный инструмент getLeadCalls собирает журнал звонков по лиду, а callBitrixMethod проксирует любой метод REST API. Для Claude Desktop есть stdio-прокси к HTTP-серверу.
Для кого. Для отделов продаж и разработчиков, которые хотят спрашивать агента о лидах и сделках в своем Битрикс24.
Подходит, если
- Нужна выборка свежих лидов или сделок за период с понятными названиями стадий
- Нужно посмотреть звонки по конкретному лиду
- Нужен свой сервер MCP в Docker для внутренней CRM
Не подходит, если
- Нужен широкий набор типизированных инструментов записи в CRM, задачи и диск
- Нет возможности держать запущенным отдельный HTTP-сервер
Пример запроса к агенту
Покажи лиды в работе за последнюю неделю и сгруппируй по ответственнымОграничения
Сервер использует собственные HTTP-эндпоинты, SSE и WebSocket, а Claude Desktop подключается через прокси-скрипт, поэтому сервер нужно запускать отдельно. Типизированные инструменты только читают, но callBitrixMethod вызывает любой метод и может менять данные. Вебхук дает доступ ко всему, что разрешено его правам. Последние изменения в репозитории были в ноябре 2025 года.
Как отключить. Уберите блок b24-mcp из конфигурации Claude Desktop, остановите uvicorn или контейнер и отзовите вебхук в Битрикс24.
MCP
- Транспорт
- http, sse, stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BITRIX_BASE_URL обязательная | REST-адрес портала, обычно https://портал.bitrix24.ru/rest |
| BITRIX_TOKEN обязательная, секрет | Ключ входящего вебхука или OAuth-токен |
| SERVER_TIMEZONE | Часовой пояс для подсказок по датам, по умолчанию UTC |
Проверка безопасности
- callBitrixMethod вызывает любой метод REST API и может менять данные CRM
- Вебхук Битрикс24 дает доступ к клиентским данным портала
Коротко о README
README на английском и русском описывает FastAPI-сервер MCP для Битрикс24 с ресурсами, инструментами и русскими подсказками для агента. Разобран формат ответа CallToolResult, обогащение записей блоком _meta, пагинация и фильтр по семантике стадий. Установка: .env с адресом портала и токеном, pip install, запуск через uvicorn или Docker, подключение Claude Desktop через stdio-прокси. Отдельно описаны требования к токену, отладка, SSE и WebSocket.
Частые вопросы
Какой токен нужен?
Ключ входящего вебхука с доступом к CRM и задачам или OAuth-токен со scope crm, task и доступом к пользователям.
Выгрузит ли агент всю CRM одним запросом?
Без фильтров ресурсы отдают не больше пяти записей, а инструменты предлагают диапазон дат за последнюю неделю.
Похожие
Официальный 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 через входящий вебхук: поиск, списки и смена стадии сделки