MCP-сервер Битрикс24 на fastmcp
Bitrix24 MCP Server
Python MCP-сервер для контактов и сделок Битрикс24 на fastmcp и fast-bitrix24: инструменты и MCP-ресурсы по URI, ставится через uvx
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Инструмент update_deal_stage меняет стадию сделки без встроенного подтверждения
- Вебхук действует с правами пользователя, для которого он создан
Установка
Ручная установка
uvx bitrix24-mcpПеред запуском задайте переменную окружения BITRIX_WEBHOOK_URL.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает часть REST API Битрикс24 в семь MCP-инструментов для контактов и сделок: получение по id, поиск по имени, телефону или email, список с фильтром по компании, список активных сделок и обновление стадии сделки. Отдельно, кроме инструментов, сервер отдает MCP-ресурсы по URI вида contact://123, deal://456 и deals://active с тем же содержимым в текстовом виде, что подходит клиентам, которые запрашивают данные как ресурсы, а не через вызов инструмента. Клиент к Битрикс24 собран на библиотеке fast-bitrix24, зависимости внедряются через wireup, настройки через pydantic-settings.
Для кого. Для разработчиков, которым нужен небольшой пример MCP-сервера Битрикс24 с поддержкой и инструментов, и ресурсов, чтобы доработать под свой набор сущностей.
Подходит, если
- Нужен MCP-клиент, который умеет запрашивать данные Битрикс24 как ресурсы по URI, а не только вызовом инструмента
- Достаточно контактов и сделок, а остальное планируется добавить самостоятельно
Не подходит, если
- Нужны задачи, лиды, компании или запись новых сущностей: в коде есть только обновление стадии сделки
- Нужна готовая интеграция без доработки: проект задуман как расширяемая основа
Пример запроса к агенту
Найди контакт по телефону и покажи его активные сделки в Битрикс24Ограничения
Из операций записи есть только обновление стадии сделки, создания и удаления сущностей нет. Нужен Python 3.12 и права вебхука как минимум на crm. README на русском описывает структуру и установку, но не описывает подтверждение перед изменением стадии. Автор один, звезд нет, проект студенческого масштаба судя по README.
Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| BITRIX_WEBHOOK_URL обязательная, секрет | Адрес входящего вебхука портала Битрикс24 с правами crm |
Проверка безопасности
- Инструмент update_deal_stage меняет стадию сделки без встроенного подтверждения
- Вебхук действует с правами пользователя, для которого он создан
Коротко о README
README на русском описывает интеграционный сервер на MCP для доступа LLM к контактам и сделкам Битрикс24, перечисляет технологии: fast-bitrix24, fastmcp, pydantic, structlog, ruff, wireup, дает инструкции по установке вебхука и запуску через uvx или тестовый скрипт, и отдельно описывает и инструменты, и ресурсы с примерами URI. Лицензия MIT.
Частые вопросы
Можно ли создавать сделки и контакты?
Нет, README и список инструментов описывают только чтение и одно действие записи: обновление стадии сделки.
Чем ресурсы отличаются от инструментов здесь?
Ресурсы вроде contact://123 отдают ту же информацию, что и инструменты, но в текстовом виде по URI, для клиентов, которые запрашивают контекст, а не вызывают функцию.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма