MCP-сервер @vibe/mcp-vibe-api - это компонент платформы Битрикс24 Вайбкод, который позволяет ИИ-агентам (Claude, ChatGPT, Codex и другим) вызывать Vibe API как нативные инструменты, без ручных curl-запросов и написания обёрток с нуля.
Model Context Protocol (MCP) - открытый стандарт, по которому ИИ-агент получает список «инструментов» и может вызывать их в ходе диалога. Вместо того чтобы генерировать curl-команды и надеяться на корректный формат, модель видит строго описанные функции и вызывает их напрямую.
В экосистеме Вайбкод 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 Вайбкод: что такое вайбкодинг и как ИИ собирает приложения за минуты.
MCP-сервер @vibe/mcp-vibe-api поддерживает два режима запуска - выбор зависит от среды, в которой живёт ИИ-агент.
| Режим | Когда использовать | Как запускается |
|---|---|---|
| stdio | Локальный агент (Claude Code, Codex в терминале), скрипт на той же машине | Процесс запускается хостом, общение через stdin/stdout |
| HTTP (SSE) | Удалённый агент, облачный сервис, n8n, Cursor Remote | Сервер слушает порт, агент подключается по HTTP |
В обоих случаях аутентификация - через Vibe-ключ (X-Api-Key). Ключ выдаётся в личном кабинете Вайбкода и одновременно даёт доступ к Vibe API и ИИ-моделям платформы.
Одна из ключевых особенностей MCP-сервера - инструмент discover. При его вызове модель получает машиночитаемую схему всех доступных сущностей (на октябрь 2026-66 сущностей, всего в Vibe API более 1 600 методов). Схема написана для моделей, а не для людей: после «прочтения» документации агент пишет корректные вызовы без дополнительного промтинга.
Аналог на уровне HTTP-ключа - GET /v1/me: ключ описывает сам себя и перечисляет доступные API. Оба механизма растут по мере расширения платформы.
flowchart TD
AGENT["ИИ-агент\nClaude / Codex"] -- вызов discover --> MCP["MCP-сервер\n@vibe/mcp-vibe-api"]
MCP -- схема 66 сущностей --> AGENT
AGENT -- CRUD-инструменты --> MCP
MCP -- Vibe API --> B24["Битрикс24 портал"]
B24 -- данные CRM и задачи --> 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-обёртку. Это гарантирует корректную трансформацию полей и предсказуемое поведение для модели.
Прежде чем подключать ИИ-агента к боевому порталу, настройте режим доступа ключа. Вайбкод поддерживает два режима:
WRITE_BLOCKED_READONLY_KEY с указанием заблокированного метода.Рекомендуемые сценарии:
Изменение прав доступа к ключу фиксируется: владелец получает уведомление от Companion-бота (кто и когда изменил). Журнал обращений по ключам доступен в личном кабинете Вайбкода.
Подробнее о безопасности при работе ИИ с порталом - в статье Безопасность вайбкодинга в Битрикс24: как не дать ИИ сломать CRM.
Важно не путать два разных инструмента:
MCP-сервер Вайбкода (@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 | Встроен (66 сущностей) | - |
Стандартный MCP-сервер Битрикс24 описан в официальном Helpdesk: через него, например, ChatGPT может ставить задачи и управлять CRM по команде сотрудника. MCP-сервер Вайбкода - инструмент следующего уровня, для разработчиков, строящих приложения и интеграции методом вайбкодинга.
Если вас интересует встроенный ИИ-агент Hermes и его связь с Вайбкодом, подробности - в статье ИИ-агенты Hermes и Коворк/Код: ассистент-разработчик внутри Битрикс24.
MCP через Vibe API оптимален для CRUD-операций и работы с отдельными сущностями. Если задача - выгрузить десятки тысяч записей для анализа, лучше рассмотреть API BI-коннектора Битрикс24:
По данным базы знаний платформы, отдельное BI-API внутри Вайбкод находится в разработке (на момент публикации). Пока это внешний инструмент, удобный для ИИ-ассистентов на больших данных.
Минимальный путь от нуля до работающего ИИ-агента с доступом к Битрикс24:
/keys. Выбрать режим: «только чтение» для аналитических агентов, «чтение и запись» для операционных.npm install @vibe/mcp-vibe-api (или запустить через npx).VIBE_API_KEY=...) или флаг запуска; не записывать прямо в коде.discover - убедиться, что агент получил схему сущностей и видит нужные инструменты.crm.leads.list), затем write-запрос в тестовой среде./keys установить политику по умолчанию «все новые ключи - только чтение»; исключения - явно.Если вы внедряете ИИ-агентов в процессы на базе Битрикс24 или хотите разобраться, как применить Вайбкод и MCP в вашем проекте, - команда АС Проект готова помочь. Мы имеем статус Платинового партнёра Битрикс24 и опыт в технических интеграциях, автоматизации и разработке под платформу. Форма заявки - на сайте.
За период добавились/подтверждены эндпоинты, полезные при работе ИИ-агента с API как с инструментом:
| Эндпоинт | Назначение | Требования |
|---|---|---|
POST /v1/embeddings |
Векторные эмбеддинги (model: bitrix/embeddings) |
право доступа vibe:ai, бесплатно |
GET /v1/note/documents/search |
База знаний 2.0: поиск/создание/наполнение | право доступа note |
GET /v1/activities/:id/transcript |
Готовая расшифровка звонка | право доступа 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).
Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.
discover отдаёт 66 сущностей Битрикс24, всего в API более 1 600 методов. Отдельно работает бот-платформа.Данные на 29 августа 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.
Оставьте заявку - мы свяжемся с вами и проконсультируем.
Эксперт АС Проект свяжется в течение 60 минут.