MCP-сервер Битрикс24 на fastmcp
Bitrix24 MCP Server
Python MCP-сервер для контактов и сделок Битрикс24 на fastmcp и fast-bitrix24: инструменты и MCP-ресурсы по URI, ставится через uvx
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Инструмент update_deal_stage меняет стадию сделки без встроенного подтверждения
- Вебхук действует с правами пользователя, для которого он создан
Похожий инструмент с большим сообществом: Bitrix24 MCP Server, 65 ★ репозитория
Установка
- Работает в
- Сервисы
Ручная установка
uvx bitrix24-mcpПеред запуском задайте переменную окружения BITRIX_WEBHOOK_URL.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент update_deal_stage меняет стадию сделки без встроенного подтверждения
- Вебхук действует с правами пользователя, для которого он создан
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает часть 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, а не только вызовом инструмента
- Достаточно контактов и сделок, а остальное планируется добавить самостоятельно
Не подходит, если
- Нужны задачи, лиды, компании или запись новых сущностей: в коде есть только обновление стадии сделки
- Нужна готовая интеграция без доработки: проект задуман как расширяемая основа
Пример запроса к агенту
Найди контакт по телефону и покажи его активные сделки в Битрикс24MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
BITRIX_WEBHOOK_URLобязательная, секрет- Адрес входящего вебхука портала Битрикс24 с правами crm
Ограничения
Из операций записи есть только обновление стадии сделки, создания и удаления сущностей нет. Нужен Python 3.12 и права вебхука как минимум на crm. README на русском описывает структуру и установку, но не описывает подтверждение перед изменением стадии. Автор один, звезд нет, проект студенческого масштаба судя по README.
Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.
Частые вопросы
Можно ли создавать сделки и контакты?
Нет, README и список инструментов описывают только чтение и одно действие записи: обновление стадии сделки.
Чем ресурсы отличаются от инструментов здесь?
Ресурсы вроде contact://123 отдают ту же информацию, что и инструменты, но в текстовом виде по URI, для клиентов, которые запрашивают контекст, а не вызывают функцию.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыMCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
MCP-сервер Битрикс24 с реальными вызовами
MCP Server for Bitrix24
MCP-сервер Битрикс24 с 43 инструментами и около 870 действиями, который выполняет настоящие вызовы REST API, а не только отдает документацию
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
MCP-сервер на TypeScript с более чем 45 инструментами для CRM Битрикс24: контакты, сделки, лиды, компании, задачи и аналитика активности
MCP-сервер для аналитики CRM Битрикс24: сделки, лиды, контакты, задачи, активность менеджеров и сделки в риске
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Read-only MCP-сервер, который читает сделки, контакты и компании Битрикс24 SELECT-запросами к базе, минуя REST API
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP-сервер Битрикс24 на fastmcp (эта карточка) | нет | не нужна | 0 | |
| MCP-сервер Битрикс24 с аналитикой продаж | нет | не нужна | 0 | на TypeScript, с аналитикой менеджеров |
| MCP-сервер Битрикс24 для Open WebUI | нет | не нужна | 0 | 32 инструмента по HTTP, для Open WebUI |
| MCP-сервер Битрикс24 на Go | нет | не нужна | 0 | один бинарник |
Коротко о README
README на русском описывает интеграционный сервер на MCP для доступа LLM к контактам и сделкам Битрикс24, перечисляет технологии: fast-bitrix24, fastmcp, pydantic, structlog, ruff, wireup, дает инструкции по установке вебхука и запуску через uvx или тестовый скрипт, и отдельно описывает и инструменты, и ресурсы с примерами URI. Лицензия MIT.