TL;DR — бери и пользуйся
Я сделал репозиторий, где собрал всю аналитику отдела продаж для Bitrix24 CRM в одном месте: MCP-сервер, готовый дашборд, бэкенд и ETL. Не «кусочек», а цельная платформа, из которой можно форкнуть и продолжать вайбкодить поверх. Вот он: github.com/mkhamzanov/bitrix24_public.
data/. Четыре команды — и у тебя живой дашборд на localhost:3000. Код открытый — вот репозиторий.Если слово «MCP» тебе пока ничего не говорит — не страшно, ниже объясняю за 60 секунд. Если уже разобрался — листай сразу к быстрому старту.
1. Что лежит внутри
Обычно для такой задачи приходится собирать зоопарк: один репо с парсером, другой с фронтом, третий с базой. Я специально сложил всё в один репозиторий — открыл, и сразу видно, как одно соединяется с другим.
Всё это собрано на популярном стеке — Next.js 15, React 19, Tailwind 4 на фронте, FastAPI + PostgreSQL на бэке и Apache Airflow для расписания ETL. Если знаешь хотя бы половину — освоишься быстро.
2. Что такое MCP за 60 секунд
MCP — это способ дать AI-агенту прямой доступ к твоим данным и инструментам. Представь USB-C для нейросетей: сервис пишет один MCP-адаптер — и сразу становится доступен в Claude, ChatGPT, Cursor. Не нужно копипастить выгрузки в чат — агент сам ходит за данными. Anthropic открыл протокол в конце 2024, и за полгода его поддержал весь рынок, включая OpenAI.
В моём репо MCP-сервер (mcp_server/server.py) read-only: он только читает данные из CRM и отдаёт их агенту. То есть ты прямо в чате спрашиваешь «какая конверсия по менеджеру X за май» — и Claude сам берёт цифры из mart-слоя и отвечает. Ничего сломать он не может — запись закрыта.
3. Почему демо без бэкенда — это круто
Главная боль любого дашборда — чтобы его увидеть, обычно надо сначала поднять базу, налить туда данные, настроить коннекторы. Полдня уходит впустую. Я сделал так, что фронт читает готовые снимки данных (CSV/JSONL) из папки data/ — никакого PostgreSQL и Airflow для демо не нужно.
Это значит: ты можешь показать рабочее демо за пару минут — клиенту, команде, себе. А когда захочешь подключить реальный портал — поднимаешь ETL и базу, и те же экраны начинают показывать живые цифры. Один и тот же фронт, два режима.
Я ненавижу демки, которые «сначала поднимите пять сервисов». Поэтому здесь демо запускается из файлов — открыл и сразу видно, что получишь.
4. Быстрый старт за 4 команды
Скопируй репозиторий к себе и выполни четыре строчки. Это всё, что нужно для демо без бэкенда:
npm install
cp .env.local.example .env.local
python scripts/generate_mock.py # синтетические данные в data/
npm run dev
# → http://localhost:3000 (логин admin / admin).env.local.
5. Стек и слои архитектуры
Данные едут по медальон-архитектуре: сырьё из Bitrix24 (raw) → типизированный слой (staging) → витрины для дашборда (mart). Удобно расширять: добавил новую сущность в ETL — она поднимается до витрины, и фронт её показывает.
Сколько частей в каждом слое (оценка по репо)
Цифры приблизительные — суть в том, что фронт и ETL самые «жирные», а MCP-сервер компактный и аккуратный.
6. Сравнение с альтернативой
Честно: есть похожий проект — kartochka/bitrix24-mcp. Это аккуратный MCP-сервер для Bitrix24 на Python и FastMCP с набором инструментов: поиск контактов, работа со сделками, смена стадии. Если тебе нужен только MCP-слой к CRM — это хороший узкий инструмент.
Разница простая: то — один инструмент, а мой репозиторий — это вся платформа сразу: MCP + готовый фронт-дашборд + бэкенд + ETL + AI-инсайты. То есть ты получаешь не кубик, а собранную систему, из которой удобно вайбкодить дальше.
| Что внутри | kartochka/bitrix24-mcp | bitrix24_public (мой) |
|---|---|---|
| MCP-сервер | ||
| Готовый фронт-дашборд | ||
| Бэкенд (FastAPI) | ||
| ETL-пайплайн | ||
| AI-инсайты (Claude + Whisper) | ||
| Демо без бэкенда | ||
| Запись в CRM (смена стадии) | ||
| Фокус | Только MCP | Цельная платформа |
Это не хейт — оба репо живые и полезные. Просто выбирай по задаче: нужен лёгкий MCP к CRM — бери kartochka/bitrix24-mcp; нужна готовая аналитика и каркас под вайбкодинг — github.com/mkhamzanov/bitrix24_public.
7. Кому пригодится
8. Форкни и вайбкоди дальше
Это бесплатный шаблон — форкай и адаптируй под свой портал. Поменяй брендинг, добавь свои метрики, подключи реальный Bitrix24 — или просто открой репо в Cursor / Claude Code и допиливай промптами. Каркас есть — вайбкодинг сверху уже в кайф.
