Что такое MCP и зачем он в VibeCode
Model Context Protocol (MCP) — открытый стандарт, по которому ИИ-агент получает список «инструментов» и может вызывать их в ходе диалога. Вместо того чтобы генерировать curl-команды и надеяться на корректный формат, модель видит строго описанные функции и вызывает их напрямую.
В экосистеме VibeCode MCP-сервер публикуется как npm-пакет @vibe/mcp-vibe-api. Он оборачивает Vibe API — REST-интерфейс над Битрикс24, оптимизированный под ИИ-модели, — и предоставляет его в виде инструментов MCP. Это значит: любой агент, совместимый с MCP (Claude Code, ChatGPT с плагинами, n8n, Cursor и другие), получает готовый доступ к данным портала без самостоятельной реализации пагинации, маппинга полей и обработки ошибок Битрикс24.
Почему не «сырой» REST? Vibe API намеренно не содержит универсального
POST /v1/call— он удалён в пользу entity-обёрток, которые скрывают трансформацию полей, батчинг и пагинацию. MCP-сервер транслирует эти обёртки в инструменты, которые модель вызывает без «знания» о внутреннем устройстве Битрикс24.
Подробнее об архитектуре самой платформы читайте в статье Битрикс24 VibeCode: что такое вайбкодинг и как ИИ собирает приложения за минуты.
Транспорты: stdio и HTTP
MCP-сервер @vibe/mcp-vibe-api поддерживает два режима запуска — выбор зависит от среды, в которой живёт ИИ-агент.
| Режим | Когда использовать | Как запускается |
|---|---|---|
| stdio | Локальный агент (Claude Code, Codex в терминале), скрипт на той же машине | Процесс запускается хостом, общение через stdin/stdout |
| HTTP (SSE) | Удалённый агент, облачный сервис, n8n, Cursor Remote | Сервер слушает порт, агент подключается по HTTP |
В обоих случаях аутентификация — через Vibe-ключ (X-Api-Key). Ключ выдаётся в личном кабинете VibeCode и одновременно даёт доступ к Vibe API и ИИ-моделям платформы.
Discover-схема: как модель «узнаёт» API
Одна из ключевых особенностей MCP-сервера — инструмент discover. При его вызове модель получает машиночитаемую схему всех доступных сущностей (на момент публикации — 29 сущностей). Схема написана для моделей, а не для людей: после «прочтения» документации агент пишет корректные вызовы без дополнительного промтинга.
Аналог на уровне HTTP-ключа — GET /v1/me: ключ описывает сам себя и перечисляет доступные API. Оба механизма растут по мере расширения платформы.
flowchart LR
AGENT[ИИ-агент\nClaude / ChatGPT / Codex] -- MCP вызов discover --> MCP[MCP-сервер\n@vibe/mcp-vibe-api]
MCP -- Vibe API --> B24[Битрикс24\nпортал]
MCP -- схема 29 сущностей --> AGENT
AGENT -- CRUD-инструменты --> MCP
B24 -- данные CRM\nзадачи, файлы --> MCP
На схеме показан полный цикл взаимодействия: ИИ-агент сначала вызывает discover и получает схему сущностей, затем использует CRUD-инструменты через MCP-сервер, который транслирует запросы в Vibe API Битрикс24 и возвращает ответ модели.
Группы инструментов MCP-сервера
Инструменты разбиты на функциональные группы. Таблица ниже отражает логику разбивки — точный состав уточняйте в актуальной документации vibecode.bitrix24.tech/docs (платформа в активной разработке).
| Группа | Что делает | Типичные инструменты |
|---|---|---|
| Управление порталом | Чтение и запись настроек портала | portal.get, portal.update |
| Управление ключами | Создание, ротация, отзыв API-ключей | keys.list, keys.create, keys.revoke |
| Управление приложениями | Деплой, публикация, статус | apps.list, apps.publish |
| Entity CRUD | Создание, чтение, обновление, удаление сущностей CRM и задач | crm.leads.*, crm.deals.*, tasks.*, contacts.* и др. |
| Discover / схема | Самоописание API для модели | discover, me |
Важно: универсального инструмента «вызвать любой метод Битрикс24» нет намеренно. Если нужного метода не хватает — в платформе добавляют новую entity-обёртку. Это гарантирует корректную трансформацию полей и предсказуемое поведение для модели.
Безопасность: read-only ключи и политика доступа
Прежде чем подключать ИИ-агента к боевому порталу, настройте режим доступа ключа. VibeCode поддерживает два режима:
- Чтение и запись — полный доступ к CRUD-операциям.
- Только чтение — любая запись (create / update / delete) блокируется на стороне VibeCode ещё до того, как запрос дошёл до Битрикс24. Ошибка:
WRITE_BLOCKED_READONLY_KEYс указанием заблокированного метода.
Рекомендуемые сценарии:
- ИИ-агент для анализа CRM (сегментация лидов, отчёты) → read-only.
- Агент для автоматизации операций (создание сделок, постановка задач) → чтение и запись, с явным подтверждением действий.
- Скомпрометированный ключ с read-only не позволит ничего сломать — данные останутся целыми.
Изменение прав доступа к ключу фиксируется: владелец получает уведомление от Companion-бота (кто и когда изменил). Журнал обращений по ключам доступен в личном кабинете VibeCode.
Подробнее о безопасности при работе ИИ с порталом — в статье Безопасность вайбкодинга в Битрикс24: как не дать ИИ сломать CRM.
Чем MCP-сервер VibeCode отличается от стандартного MCP-сервера Битрикс24
Важно не путать два разных инструмента:
MCP-сервер VibeCode (@vibe/mcp-vibe-api) |
Битрикс24 MCP-сервер (mcp.bitrix24.tech) |
|
|---|---|---|
| Аудитория | Разработчики, ИИ-агенты в вайбкодинге | Конечные пользователи, внешние AI-системы (ChatGPT, Yandex AI Studio) |
| API | Vibe API (entity-обёртки, оптимизированы под ИИ) | REST API Битрикс24 через OAuth / токен |
| Настройка | npm-пакет, Vibe-ключ | Раздел «Приложения → MCP-подключения» в портале |
| Кому подходит | Разработка приложений, автоматизация через ИИ-агент | Управление порталом из ChatGPT, Cursor, n8n без разработки |
| Discover | Встроен (29 сущностей) | — |
Стандартный MCP-сервер Битрикс24 описан в официальном Helpdesk: через него, например, ChatGPT может ставить задачи и управлять CRM по команде сотрудника. MCP-сервер VibeCode — инструмент следующего уровня, для разработчиков, строящих приложения и интеграции методом вайбкодинга.
Если вас интересует встроенный ИИ-агент Hermes и его связь с VibeCode, подробности — в статье ИИ-агенты Hermes и Cowork/Code: ассистент-разработчик внутри Битрикс24.
Альтернатива для аналитики на больших данных: BI-коннектор
MCP через Vibe API оптимален для CRUD-операций и работы с отдельными сущностями. Если задача — выгрузить десятки тысяч записей для анализа, лучше рассмотреть API BI-коннектора Битрикс24:
- Без пагинации и ограничений по частоте запросов.
- До 10 млн строк в одной выгрузке.
- Упрощённый синтаксис фильтрации.
- Ключ берётся из личного кабинета «Аналитика Битрикс24».
По данным базы знаний платформы, отдельное BI-API внутри VibeCode находится в разработке (на момент публикации). Пока это внешний инструмент, удобный для ИИ-ассистентов на больших данных.
Чек-лист подключения MCP-сервера VibeCode
Минимальный путь от нуля до работающего ИИ-агента с доступом к Битрикс24:
- [ ] Получить доступ к VibeCode — платформа идёт по подписке BitrixGPT + Маркетплейс Битрикс24; на старте доступен триал 14 дней.
- [ ] Создать Vibe-ключ — в личном кабинете VibeCode, раздел
/keys. Выбрать режим: «только чтение» для аналитических агентов, «чтение и запись» для операционных. - [ ] Установить пакет —
npm install @vibe/mcp-vibe-api(или запустить черезnpx). - [ ] Выбрать транспорт — stdio для локального агента, HTTP для облачного или удалённого.
- [ ] Передать ключ — через переменную окружения (
VIBE_API_KEY=...) или флаг запуска; не хардкодить в коде. - [ ] Вызвать
discover— убедиться, что агент получил схему сущностей и видит нужные инструменты. - [ ] Проверить права — выполнить тестовый read-запрос (например,
crm.leads.list), затем write-запрос в тестовой среде. - [ ] Настроить политику ключей — в разделе
/keysустановить политику по умолчанию «все новые ключи — только чтение»; исключения — явно.
АС Проект — Платиновый партнёр Битрикс24
Если вы внедряете ИИ-агентов в процессы на базе Битрикс24 или хотите разобраться, как применить VibeCode и MCP в вашем проекте, — команда АС Проект готова помочь. Мы имеем статус Платинового партнёра Битрикс24 и опыт в технических интеграциях, автоматизации и разработке под платформу. Форма заявки — на сайте.