MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
- 1 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Модуль CRM может создавать, изменять и комментировать сделки и контакты после подтверждения confirm=true
- MCP_EXTRA_MODULES выполняет произвольный сторонний код с правами процесса сервера
Установка
- Работает в
- Сервисы
Ручная установка
docker compose build && docker compose run --rm -T mcpРекомендуемый способ запуска по stdio, перед этим задайте BITRIX_WEBHOOK_BASE в .env.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Модуль CRM может создавать, изменять и комментировать сделки и контакты после подтверждения confirm=true
- MCP_EXTRA_MODULES выполняет произвольный сторонний код с правами процесса сервера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер устроен как ядро плюс три подключаемых модуля: задачи и проекты (26 инструментов на подключение, список, историю, чек-листы, канбан рабочих групп, спринты, учет времени), CRM (18 инструментов на сделки, контакты, пользователей и активности) и универсальные списки (2 инструмента для поиска и скачивания вложений в реестре переписки). Модули можно отключать через переменную MCP_ENABLED_MODULES или подключать свои, включая сторонние npm-пакеты вне репозитория. Каждый пишущий вызов требует явного параметра confirm=true, а универсального REST-инструмента без ограничений нет: каждый инструмент валидирует и ограничивает свой набор полей отдельно. По умолчанию сервер работает по stdio через Docker с одним общим вебхуком без базы данных; опционально поднимается второй HTTP-транспорт с мультиаккаунтным OAuth-логином и PostgreSQL только для таблицы аккаунтов.
Для кого. Для команд, которым нужно широкое и при этом контролируемое покрытие задач, CRM и списков Битрикс24 в одном сервере, с возможностью отключить лишние модули.
Подходит, если
- Нужны и задачи с канбаном и спринтами, и CRM в одном сервере, без разных серверов на разные сущности
- Важно, чтобы каждая запись явно требовала confirm=true
- Нужен мультиаккаунтный удаленный доступ через OAuth для нескольких пользователей claude.ai
Не подходит, если
- Нужен универсальный REST-инструмент без ограничения полей: в проекте его намеренно нет
- Нет Docker: базовый запуск через npm возможен, но READMEоориентирован на контейнер
Пример запроса к агенту
Покажи открытые сделки моей воронки и перенеси задачу 318 в колонку Готово на канбане проектаMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
BITRIX_WEBHOOK_BASEобязательная, секрет- Секретный адрес входящего вебхука вида https://portal.example.ru/rest/123/token
MCP_ENABLED_MODULES- Список встроенных модулей через запятую: tasks, crm, lists, по умолчанию все
MCP_EXTRA_MODULES- Сторонние npm-пакеты или пути к файлам с собственными модулями, выполняют произвольный код
MCP_TRANSPORT- stdio по умолчанию или http для сервиса mcp-http
DATABASE_URLсекрет- Строка подключения PostgreSQL, нужна только для мультиаккаунтного HTTP-транспорта
Ограничения
Мультиаккаунтный HTTP-транспорт хранит OAuth-клиентов и токены в памяти процесса и не переживает рестарт контейнера, хотя сами аккаунты сохраняются в PostgreSQL. Роль аккаунта это описательное поле, само по себе оно ничего не ограничивает. Нужен Docker Engine с Compose v2 для рекомендуемого способа запуска. Интеграционные тесты на реальном портале включаются отдельной переменной и по умолчанию выключены. Проект совсем новый, автор один, звезд нет.
Как отключить. Остановите docker compose и удалите сервер из .mcp.json или конфигурации MCP клиента.
Частые вопросы
Нужна ли база данных для обычного запуска?
Нет, PostgreSQL нужен только для мультиаккаунтного HTTP-транспорта, обычный stdio-запуск с одним вебхуком работает без базы вообще.
Можно ли отключить часть инструментов?
Да, через переменную MCP_ENABLED_MODULES можно оставить только нужные модули, например только tasks, или отключить все встроенные и подключить свой через MCP_EXTRA_MODULES.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс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-сервер Битрикс24 на входящем вебхуке: задачи, группы, канбан-стадии и комментарии задач
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
MCP-сервер Битрикс24 с аналитикой продаж
Bitrix24 MCP Server
MCP-сервер Битрикс24 на TypeScript с широким набором инструментов CRM плюс отдельная группа для мониторинга активности и эффективности менеджеров
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP-сервер Битрикс24: задачи, CRM и списки (эта карточка) | нет | OAuth | 1 | |
| MCP-сервер Битрикс24 с аналитикой продаж | нет | не нужна | 0 | на TypeScript, с аналитикой менеджеров |
| MCP-сервер Битрикс24 для Open WebUI | нет | не нужна | 0 | 32 инструмента по HTTP, для Open WebUI |
| MCP-сервер Битрикс24 на Go | нет | не нужна | 0 | один бинарник |
Коротко о README
README на русском подробно описывает архитектуру ядра с подключаемыми модулями, схему без стороннего кеша данных, запуск в Docker по stdio и опциональный HTTP-транспорт с мультиаккаунтным OAuth поверх PostgreSQL, полный список переменных окружения, разбивку 46 инструментов по трем модулям и раздел тестов и качества с typecheck, lint и интеграционными проверками на реальном портале.