MCP-сервер @vibe/mcp-vibe-api - это компонент платформы Битрикс24 VibeCode, который позволяет ИИ-агентам (Claude, ChatGPT, Codex и другим) вызывать Vibe API как нативные инструменты, без ручных curl-запросов и написания обёрток с нуля.
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: что такое вайбкодинг и как ИИ собирает приложения за минуты.
MCP-сервер @vibe/mcp-vibe-api поддерживает два режима запуска - выбор зависит от среды, в которой живёт ИИ-агент.
| Режим | Когда использовать | Как запускается |
|---|---|---|
| stdio | Локальный агент (Claude Code, Codex в терминале), скрипт на той же машине | Процесс запускается хостом, общение через stdin/stdout |
| HTTP (SSE) | Удалённый агент, облачный сервис, n8n, Cursor Remote | Сервер слушает порт, агент подключается по HTTP |
В обоих случаях аутентификация - через Vibe-ключ (X-Api-Key). Ключ выдаётся в личном кабинете VibeCode и одновременно даёт доступ к Vibe 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 и возвращает ответ модели.
Инструменты разбиты на функциональные группы. Таблица ниже отражает логику разбивки - точный состав уточняйте в актуальной документации 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-обёртку. Это гарантирует корректную трансформацию полей и предсказуемое поведение для модели.
Прежде чем подключать ИИ-агента к боевому порталу, настройте режим доступа ключа. VibeCode поддерживает два режима:
WRITE_BLOCKED_READONLY_KEY с указанием заблокированного метода.Рекомендуемые сценарии:
Изменение прав доступа к ключу фиксируется: владелец получает уведомление от Companion-бота (кто и когда изменил). Журнал обращений по ключам доступен в личном кабинете VibeCode.
Подробнее о безопасности при работе ИИ с порталом - в статье Безопасность вайбкодинга в Битрикс24: как не дать ИИ сломать CRM.
Важно не путать два разных инструмента:
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.
MCP через Vibe API оптимален для CRUD-операций и работы с отдельными сущностями. Если задача - выгрузить десятки тысяч записей для анализа, лучше рассмотреть API BI-коннектора Битрикс24:
По данным базы знаний платформы, отдельное BI-API внутри VibeCode находится в разработке (на момент публикации). Пока это внешний инструмент, удобный для ИИ-ассистентов на больших данных.
Минимальный путь от нуля до работающего ИИ-агента с доступом к Битрикс24:
/keys. Выбрать режим: «только чтение» для аналитических агентов, «чтение и запись» для операционных.npm install @vibe/mcp-vibe-api (или запустить через npx).VIBE_API_KEY=...) или флаг запуска; не хардкодить в коде.discover - убедиться, что агент получил схему сущностей и видит нужные инструменты.crm.leads.list), затем write-запрос в тестовой среде./keys установить политику по умолчанию «все новые ключи - только чтение»; исключения - явно.Если вы внедряете ИИ-агентов в процессы на базе Битрикс24 или хотите разобраться, как применить VibeCode и MCP в вашем проекте, - команда АС Проект готова помочь. Мы имеем статус Платинового партнёра Битрикс24 и опыт в технических интеграциях, автоматизации и разработке под платформу. Форма заявки - на сайте.
За период добавились/подтверждены эндпоинты, полезные при работе ИИ-агента с API как с инструментом:
| Эндпоинт | Назначение | Требования |
|---|---|---|
POST /v1/embeddings |
Векторные эмбеддинги (model: bitrix/embeddings) |
scope vibe:ai, бесплатно |
GET /v1/note/documents/search |
База знаний 2.0: поиск/создание/наполнение | scope note |
GET /v1/activities/:id/transcript |
Готовая расшифровка звонка | scope crm |
POST /v1/deals/aggregate |
Агрегаты по сделкам | - |
GET /v1/bots/{botId}/events |
События бота (long-polling) | не блокировать тяжёлыми CRM-запросами |
POST /v1/infra/servers/{id}/exec |
Команда на сервере | один exec на сервер за раз (lock, таймаут 500 с) |
DELETE /v1/infra/servers/{id}/lock |
Снять зависший lock | lock может «жить» на уровне галактики |
POST /v1/infra/servers/{id}/upload |
Загрузка артефакта на сервер | работает даже при залипшем exec |
Scopes: crm (CRM + расшифровки), note (База знаний 2.0), vibe:ai (эмбеддинги и AI Router).
Данные на июль 2026 - платформа VibeCode в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией VibeCode.
Оставьте заявку - мы свяжемся с вами и проконсультируем.
Эксперт АС Проект свяжется в течение 60 минут.