bitrix24-mcp (penmadebykisss)
bitrix24-mcp
Битрикс24 для агента через входящий вебхук: сделки, лиды, контакты, задачи и отчеты по воронке с рейтингом менеджеров и зависшими сделками
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Вебхук открывает CRM: персональные данные клиентов, суммы сделок и задачи сотрудников
- Записывающие инструменты создают и меняют сделки, лиды и задачи на рабочем портале
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/penmadebykisss-bitrix24-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Вебхук открывает CRM: персональные данные клиентов, суммы сделок и задачи сотрудников
- Записывающие инструменты создают и меняют сделки, лиды и задачи на рабочем портале
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Node.js дает агенту тринадцать инструментов `b24_*` для портала Битрикс24 и подключается за минуту по входящему вебхуку, без приложения в маркете и без OAuth. Для чтения служат `b24_portal`, `b24_search_deals`, `b24_get_deal`, `b24_find_contact` и `b24_tasks`. Карточка сделки включает контакты с телефонами, компанию, открытые задачи и комментарии таймлайна. Контакт ищется по телефону в любом формате, по почте или имени, и сразу с его открытыми сделками. Отличие этого сервера в аналитике отдела продаж. `b24_pipeline_report` строит отчет по воронке: стадии, выиграно и проиграно, конверсия, средний цикл и рейтинг менеджеров. `b24_stale_deals` находит сделки без изменений N дней и без открытых задач, крупные идут первыми. `b24_tasks` разбивает открытые и просроченные задачи по сотрудникам. Записывающие инструменты помечены в README значком карандаша: `b24_create_deal`, `b24_update_deal`, `b24_create_lead`, `b24_add_comment`, `b24_create_task` и `b24_complete_task`. Ассистент должен показать, что запишет, и получить согласие. Сервер сам выдерживает лимит REST около двух запросов в секунду и повторяет вызов при `QUERY_LIMIT_EXCEEDED`.
Для кого. Руководителям отделов продаж на Битрикс24, которые каждую неделю вручную собирают воронку, ищут зависшие сделки и просроченные задачи менеджеров.
Подходит, если
- Утром интересно, как идут продажи за месяц и кто из менеджеров лучше закрывает сделки
- Нужно найти сделки без движения больше недели и без задач, чтобы разобрать их на планерке
- Перед звонком клиенту подготовиться: найти его по телефону и увидеть открытые сделки
- Сделку с новым контактом, например «Сайт для кафе» на 90 000, заводят одной фразой агенту
- Менеджеру ставят задачу перезвонить завтра, а закрытую задачу отмечают с комментарием-результатом
Не подходит, если
- Нужен доступ к коду, базе и структуре коробочной установки: сервер работает только с REST вебхука
- Вебхук нельзя ограничить правами: тогда записывающие инструменты получат слишком много доступа
- Отчет требуется по более чем 2000 сделок за период: отчет по воронке считает до 2000, а поиск зависших до 1000 открытых
- Нужна аналитика по оплатам и товарам: инструменты охватывают сделки, лиды, контакты и задачи
Пример запроса к агенту
Как идут продажи за сентябрь и кто из менеджеров закрывает лучше? Покажи сделки, которые зависли больше недели.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
BITRIX24_WEBHOOK_URLобязательная, секрет- Адрес входящего вебхука Битрикс24.
Ограничения
Нужен Node.js 18 или новее. Вебхук создают в разделе разработчиков, пункт «Входящий вебхук», с правами `crm`, `task` и `user`. Он действует от имени создавшего его сотрудника и видит то же, что он, поэтому адрес хранят как пароль.
Лимит REST для вебхуков около двух запросов в секунду. Отчет по воронке считает до 2000 сделок за период, поиск зависших смотрит до 1000 открытых. Коробочная версия Битрикс24 поддерживается, адрес вебхука будет на вашем домене.
Проверка `npm test` идет на моке REST, реальный портал не нужен. Лицензия в репозитории не указана. Сервер запускается из GitHub через `npx`, поэтому версия берется с ветки по умолчанию.
Как отключить. Удалите сервер командой `claude mcp remove bitrix24` и отключите входящий вебхук в Битрикс24: после этого адрес перестанет работать.
Частые вопросы
Как подключить этот сервер к Claude Code?
Создайте входящий вебхук с правами `crm`, `task` и `user` и выполните `claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://ваш-портал.bitrix24.ru/rest/1/abc123xyz/ -- npx -y github:penmadebykisss/bitrix24-mcp`. Для Claude Desktop тот же запуск прописывают в `claude_desktop_config.json`.
Что показывает отчет по воронке?
Стадии воронки, число выигранных и проигранных сделок, конверсию, средний цикл сделки и рейтинг менеджеров. Отчет берет до 2000 сделок за выбранный период.
Как найти сделки, о которых забыли?
Вызовите `b24_stale_deals`: инструмент ищет открытые сделки без изменений N дней и без открытых задач, сначала самые крупные суммы. Просматривается до 1000 открытых сделок.
Какие инструменты изменяют данные?
`b24_create_deal`, `b24_update_deal`, `b24_create_lead`, `b24_add_comment`, `b24_create_task` и `b24_complete_task`. Ассистент должен показать, что запишет, и получить ваше согласие, поэтому не отключайте подтверждения в клиенте.
Работает ли сервер с коробочным Битрикс24?
Да. Вебхук создают на вашем домене, а все инструменты используют обычный REST. Доступ к коду и базе сервер не дает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Битрикс24 — все инструментыPython-сервер для агентов с доступом к порталу Битрикс24 через вебхук: смотрит сделки и контакты, а запись включается отдельной настройкой
Bitrix24 MCP от Bit2Beat
Bitrix24 MCP Server
MCP-сервер Битрикс24 через входящий вебхук: CRM, задачи, диск, календарь, чат, бизнес-процессы и перенос настроек между порталами
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
MCP-сервер на TypeScript для CRM Битрикс24: контакты, компании, лиды, сделки, задачи и отчеты по работе менеджеров
MCP-сервер для контактов и сделок CRM Битрикс24 через входящий вебхук: поиск, списки и смена стадии сделки
MCP-сервер для аналитики CRM Битрикс24: сделки, лиды, контакты, задачи, активность менеджеров и сделки в риске
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
MCP-сервер на TypeScript с более чем 45 инструментами для CRM Битрикс24: контакты, сделки, лиды, компании, задачи и аналитика активности
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| bitrix24-mcp (penmadebykisss) (эта карточка) | нет | API-ключ | 0 | |
| Bitrix24 MCP от Bit2Beat | нет | API-ключ | 6 | другой сервер Битрикс24 без отчетов по воронке и рейтингу менеджеров |
| Bitrix24 Stdio MCP Server | нет | API-ключ | 1 | stdio-сервер без аналитики отдела продаж |
Коротко о README
В README пример вопросов к ассистенту, таблица тринадцати инструментов, настройка вебхука, подключение к Claude Desktop, Claude Code, Cursor и через Docker, ограничения и проверка. Пакет в `package.json` называется `bitrix24-mcp` и ставится прямо из GitHub.