penmadebykisss/bitrix24-mcp

MCP-сервер, который подключает Claude, Cursor и других ИИ-ассистентов к **Битрикс24**: сделки, лиды, контакты,
задачи и комментарии в таймлайне — плюс **аналитика отдела продаж**, которую руководитель обычно собирает руками:
отчёт по воронке с конверсией и рейтингом менеджеров, зависшие сделки без движения и без задач, просроченные задачи.
Подключается за минуту через **входящий вебхук** — без приложения в маркете и без OAuth.
Спросите ассистента:
- *«Как идут продажи за сентябрь? Кто из менеджеров лучше закрывает?»*
- *«Какие сделки зависли больше недели и на какую сумму?»*
- *«Что просрочено у менеджеров на сегодня?»*
- *«Найди клиента +7 900 123-45-67 и подготовь меня к звонку»*
- *«Создай сделку „Сайт для кафе“ на 90 000 в воронке „Проекты“ с контактом Иван, +7 900…, и поставь Анне задачу перезвонить завтра»*
Инструменты
| Инструмент | Что делает |
|---|---|
| b24_portal | Сотрудники, воронки сделок и стадии с id и признаком won/lost |
| b24_search_deals | Поиск сделок по названию, воронке, стадии, ответственному, результату, периоду |
| b24_get_deal | Карточка сделки: контакты с телефонами, компания, открытые задачи, комментарии таймлайна |
| b24_find_contact | Поиск контакта по телефону (формат не важен), e-mail или имени + его открытые сделки |
| b24_tasks | Открытые, просроченные или сегодняшние задачи с разбивкой по сотрудникам |
| b24_pipeline_report | Отчёт по воронке: стадии, выиграно/проиграно, конверсия, средний цикл, рейтинг менеджеров |
| b24_stale_deals | Зависшие сделки: без изменений N дней и без открытых задач, крупные первыми |
| b24_create_deal ✏️ | Сделка сразу с новым или существующим контактом |
| b24_update_deal ✏️ | Стадия, сумма, ответственный, название, описание |
| b24_create_lead ✏️ | Лид (входящая заявка) с телефоном, e-mail и источником |
| b24_add_comment ✏️ | Комментарий в таймлайн сделки, лида, контакта или компании |
| b24_create_task ✏️ | Задача сотруднику со сроком и привязкой к сделке/лиду/контакту |
| b24_complete_task ✏️ | Закрыть задачу с комментарием-результатом |
✏️ — изменяют данные в портале; ассистент должен показать, что запишет, и получить ваше согласие.
Подключение
1. В Битрикс24: **Разработчикам → Другое → Входящий вебхук**. Отметьте права **CRM (crm)**, **Задачи (task)** и
**Пользователи (user)**, сохраните.
2. Скопируйте адрес вебхука вида https://ваш-портал.bitrix24.ru/rest/1/abc123xyz/ — это BITRIX24_WEBHOOK_URL.
Вебхук действует от имени создавшего его сотрудника и видит то же, что он. Храните адрес как пароль.
Нужен Node.js 18+.
Claude Desktop
Claude Code
Cursor, Windsurf и другие
Команда npx, аргументы -y github:penmadebykisss/bitrix24-mcp, переменная BITRIX24_WEBHOOK_URL.
Docker
Ограничения
- Лимит REST API для вебхуков — около 2 запросов в секунду; сервер сам выдерживает интервал и повторяет запрос при QUERY_LIMIT_EXCEEDED.
- Отчёт по воронке считает до 2000 сделок за период, поиск зависших — до 1000 открытых сделок.