bitrix24-mcp
Python-сервер для агентов с доступом к порталу Битрикс24 через вебхук: смотрит сделки и контакты, а запись включается отдельной настройкой
- 1 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Вебхук открывает CRM портала: сделки, контакты и задачи с персональными данными клиентов
- После включения записи агент создает и двигает сделки, а с `call_method` вызывает любой метод REST API
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/rip-07-bitrix24-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Вебхук открывает CRM портала: сделки, контакты и задачи с персональными данными клиентов
- После включения записи агент создает и двигает сделки, а с `call_method` вызывает любой метод REST API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту CRM и задачи портала Битрикс24 через входящий вебхук. Инструменты чтения: `whoami` показывает, от имени какого пользователя работает вебхук, `list_deal_stages` отдает стадии воронки, `list_deals` и `get_deal` ищут сделки с фильтрами по стадии, воронке, ответственному и названию, `search_contacts` находит контакт по телефону, почте или имени, `list_leads` и `list_tasks` перечисляют лиды и задачи. Запись выключена, пока в окружении не задано `BITRIX24_READ_ONLY=false`. После этого появляются `create_lead`, `create_deal`, `move_deal_stage`, `add_deal_comment` и `create_task`. Сделка по умолчанию создается в тенге. Универсальный `call_method` для любого метода REST API включается отдельной переменной `BITRIX24_ALLOW_RAW_CALLS`. Сервер запускается через `uvx` по stdio или в Docker с HTTP-транспортом на порту 8000. HTTP-режим не стартует без токена `MCP_AUTH_TOKEN` и проверяет заголовок Authorization у каждого запроса.
Для кого. Руководителям продаж и интеграторам Битрикс24, которым нужен недорогой сервер с безопасным режимом по умолчанию и возможностью включить запись позже.
Подходит, если
- Хочется спросить агента о сделках на стадии «Переговоры» и не открывать воронку в браузере
- Звонит клиент, а менеджер просит найти контакт по номеру и показать связанные сделки
- Агент должен поставить задачу сотруднику и оставить комментарий в ленте сделки после совещания
- Портал на региональном домене, например bitrix24.kz, и готового коннектора под него не нашлось
- Сервер нужно поднять в Docker для удаленных агентов с токеном доступа и обратным прокси
Не подходит, если
- Нужна коробочная 1С-Битрикс с доступом к инфоблокам и заказам магазина: сервер говорит с REST облачного портала
- Требуются отчеты по воронке и рейтинг менеджеров: в инструментах только списки и карточки, аналитику агент соберет сам
- Вебхук нельзя ограничить по правам: при включенной записи агент получит все, что доступно владельцу вебхука
- Нужен вход по OAuth от имени каждого сотрудника: сервер работает только с одним вебхуком
Пример запроса к агенту
Покажи сделки на стадии «Переговоры» и найди контакт по номеру +7 701 123 45 67.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
BITRIX24_WEBHOOK_URLобязательная, секрет- Адрес входящего вебхука портала Битрикс24.
BITRIX24_READ_ONLY- По умолчанию true, значение false включает инструменты записи.
BITRIX24_ALLOW_RAW_CALLS- Значение true включает инструмент call_method для любого метода REST API.
MCP_AUTH_TOKENсекрет- Bearer-токен, обязателен для HTTP-режима.
Ограничения
Вебхук создают в Битрикс24 в разделе разработчикам, пункт «Входящий вебхук». Права ограничивают значениями `crm`, `task` и `user`. Адрес вебхука секретный: с ним можно действовать в CRM от имени создавшего его пользователя.
Проект неофициальный и с 1С-Битрикс не связан. Нужен Python 3.10 или новее либо Docker. Сделка по умолчанию создается в тенге, валюту при необходимости задают в запросе.
Универсальный вызов REST-методов выключен. Включайте его осознанно: через него доступен любой метод API, который разрешает вебхук.
Как отключить. Удалите сервер командой `claude mcp remove bitrix24`, а входящий вебхук отключите в Битрикс24: адрес перестанет работать.
Частые вопросы
Как подключить bitrix24-mcp к Claude Code?
Создайте входящий вебхук в Битрикс24 и выполните `claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=... -- uvx --from bitrix24-mcp-server bitrix24-mcp`. Затем попросите агента показать сделки или найти контакт по телефону.
Может ли агент менять сделки по умолчанию?
Нет. Пока `BITRIX24_READ_ONLY` равна `true`, сервер отдает только инструменты чтения. Чтобы агент мог создавать лиды, двигать сделки и ставить задачи, задайте `BITRIX24_READ_ONLY=false`.
Какие права нужны вебхуку?
Хватает `crm`, `task` и `user`. Не выдавайте лишнего: вебхук действует от имени создавшего его сотрудника и видит то же, что он.
Как запустить сервер для удаленных агентов?
Скопируйте `.env.example` в `.env`, заполните `BITRIX24_WEBHOOK_URL` и `MCP_AUTH_TOKEN`, затем выполните `docker compose up -d --build`. Эндпоинт будет по адресу `http://127.0.0.1:8000/mcp`, клиент передает заголовок Authorization с Bearer-токеном. Наружу публикуйте только через обратный прокси с TLS.
Можно ли вызвать любой метод Битрикс24?
Да, но только после явного включения. Задайте `BITRIX24_ALLOW_RAW_CALLS=true`, и появится инструмент `call_method` для любого метода REST API, разрешенного вебхуку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыbitrix24-mcp (penmadebykisss)
bitrix24-mcp
Битрикс24 для агента через входящий вебхук: сделки, лиды, контакты, задачи и отчеты по воронке с рейтингом менеджеров и зависшими сделками
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
MCP-сервер для REST API Битрикс24 на чтение и запись: CRM, задачи, скрам, календарь, диск, мессенджер и события портала
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
MCP-сервер на TypeScript с более чем 45 инструментами для CRM Битрикс24: контакты, сделки, лиды, компании, задачи и аналитика активности
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| bitrix24-mcp (эта карточка) | нет | API-ключ | 1 | |
| Bitrix24 MCP от Bit2Beat | нет | API-ключ | 6 | другой сервер для Битрикс24, у этого запись и произвольные вызовы выключены по умолчанию |
| MCP-сервер Битрикс24 с реальными вызовами | нет | ключ необязателен | 3 | отдельная реализация для Битрикс24 с другим набором инструментов |
Коротко о README
README двуязычный, русский и английский разделы идут подряд. В нем таблица из 13 инструментов с пометкой чтение или запись, быстрый старт, настройки окружения и описание Docker-режима. Пакет опубликован в PyPI как `bitrix24-mcp-server`, лицензия MIT.