#MCP для AI

Вайбкод публикует два MCP-сервера для AI-агентов — подходят для Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Gemini CLI и любого другого клиента с поддержкой Model Context Protocol.

• mcp-vibe-api — инструменты для работы с Битрикс24 через Vibe API.
• mcp-docs — справочник по REST-методам Битрикс24.

Установка mcp-vibe-api | Инструменты (53) | HTTP-транспорт | mcp-docs | Безопасность

#Что можно делать через MCP

Подборка диалогов с AI-агентом и инструментов, которые агент реально вызывает. Помогает оценить возможности mcp-vibe-api и подобрать набор скоупов для ключа.

#Аналитика по сделкам

Пользователь: Покажи сумму сделок в работе по каждому ответственному за последний месяц.

Агент по очереди вызывает:

1. aggregate_entities для сущности deals с фильтром по closeDate, агрегатом sum по полю amount и группировкой по assignedById.
2. list_entities для сущности users — чтобы заменить идентификаторы на имена сотрудников.

Скоуп ключа: crm, user.

#Создание и публикация бота

Пользователь: Зарегистрируй бота с именем «Помощник» и пришли тестовое сообщение в чат с моим коллегой.

Агент по очереди вызывает:

1. manage_bot с действием register — создаёт бота на портале.
2. manage_bot с действием get_events — получает идентификатор диалога с коллегой из входящего события.
3. manage_bot_messages с действием send — отправляет приветственное сообщение в нужный диалог.

Скоуп ключа: imbot.

#Развёртывание приложения на сервере

Пользователь: Подними новый сервер у Yandex и выкатишь туда архив с приложением.

Агент по очереди вызывает:

1. manage_server с действиями list_providers, list_plans, list_regions, list_images — собирает каталог.
2. manage_server с действием create — создаёт сервер в выбранной конфигурации.
3. manage_server с действием get — ждёт, пока статус станет RUNNING и CONNECTED.
4. manage_server_deploy с действием deploy — запускает конвейер развёртывания (загрузка архива, установка, systemd, проверка работоспособности).
5. manage_server_deploy с действием logs — читает журналы при ошибках.

Скоуп ключа: vibe:infra.

#Подключение собственного провайдера AI

Пользователь: Добавь мой ключ OpenAI и сделай тестовый запрос к gpt-4o.

Агент по очереди вызывает:

1. manage_ai_credentials с действием list_providers — выясняет идентификатор провайдера OpenAI.
2. manage_ai_credentials с действием create — сохраняет ключ; провайдер проверяется до записи и возвращает 422 CREDENTIAL_INVALID, если ключ не работает.
3. ai_chat с действием chat и параметром model: "openai/gpt-4o" — отправляет тестовый запрос через AI Router.

Скоуп ключа: vibe:ai.

#Оставить запрос в поддержку через AI

Пользователь: Эндпоинт /v1/deals/aggregate иногда возвращает пустой ответ — заведи тикет с подробностями.

Агент по очереди вызывает:

1. get_me — забирает идентификатор портала и текущий тариф для поля context.
2. manage_feedback с действием create — отправляет тикет с категорией BUG, заголовком, описанием воспроизведения и сериализованным context (эндпоинт, тело запроса, код ответа).

Скоуп ключа: создание тикетов доступно любому ключу.

#mcp-vibe-api

Сервер, который даёт AI-агенту доступ к Битрикс24 через Vibe API. Дальше — установка, параметры запуска, инструменты, Resources, Prompts и HTTP-транспорт.

#Установка

Пакет `@bitrix24/mcp-vibecode-api`. После установки доступна команда mcp-vibe-api. Нужен Node.js версии 18 или выше — подойдёт любая актуальная LTS-сборка (18, 20, 22).

npm install -g @bitrix24/mcp-vibecode-api

#Регистрация в клиенте через CLI

Если клиент умеет управлять MCP-серверами через консоль, конфиг-файл редактировать не нужно — достаточно одной команды.

Claude Code:

claude mcp add vibecode -- mcp-vibe-api --key vibe_api_your_key_here

Команда добавит сервер в локальный конфиг текущего пользователя. Чтобы поделиться настройкой со всем проектом, добавьте флаг -s project — конфиг попадёт в .mcp.json репозитория. Управлять списком: claude mcp list, claude mcp remove vibecode.

Codex CLI:

codex mcp add vibecode -- mcp-vibe-api --key vibe_api_your_key_here

Запись попадёт в ~/.codex/config.toml. Передать API-ключ через переменную окружения вместо аргумента: codex mcp add vibecode --env VIBE_API_KEY=vibe_api_your_key_here -- mcp-vibe-api. Для проектного scope создайте .codex/config.toml в корне репозитория и пропишите блок [mcp_servers.vibecode] напрямую.

Gemini CLI:

gemini mcp add vibecode mcp-vibe-api --key vibe_api_your_key_here

Запись попадёт в ~/.gemini/settings.json. Передать ключ через переменную окружения: gemini mcp add -e VIBE_API_KEY=vibe_api_your_key_here vibecode mcp-vibe-api. Для проектного scope используйте .gemini/settings.json в корне репозитория.

#Регистрация через конфиг-файл

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows):

{
  "mcpServers": {
    "vibecode": {
      "command": "mcp-vibe-api",
      "args": ["--key", "vibe_api_your_key_here"]
    }
  }
}

Cursor (.cursor/mcp.json в корне проекта):

{
  "mcpServers": {
    "vibecode": {
      "command": "mcp-vibe-api",
      "args": ["--key", "vibe_api_your_key_here"]
    }
  }
}

Codex CLI (~/.codex/config.toml):

[mcp_servers.vibecode]
command = "mcp-vibe-api"
args = ["--key", "vibe_api_your_key_here"]

#Запуск без глобальной установки

Если глобально установить пакет нельзя, замените mcp-vibe-api на npx -y @bitrix24/mcp-vibecode-api в любом конфиге выше. Пример для Claude Desktop:

{
  "mcpServers": {
    "vibecode": {
      "command": "npx",
      "args": ["-y", "@bitrix24/mcp-vibecode-api", "--key", "vibe_api_your_key_here"]
    }
  }
}

#Параметры запуска

Ключ и базовый URL передаются флагами командной строки или через переменные окружения. При коллизии флаг побеждает.

Установка ключа через переменную окружения, чтобы не хранить его в конфигах:

export VIBE_API_KEY="vibe_api_your_key_here"
mcp-vibe-api

#Доступ по типу ключа

mcp-vibe-api работает с двумя типами ключей Вайбкод и при старте запрашивает /v1/me, чтобы определить тип. Дальше клиенту отдаются только те инструменты, которые ключ может использовать.

В описании каждой группы инструментов ниже указан тип ключа, который к ней подходит.

#Инструменты (53)

Все инструменты возвращают JSON. Для специализированных эндпоинтов есть типизированные обёртки — используйте их вместо call_api, когда они доступны: подсказки по параметрам и валидация выше. Инструменты сгруппированы в пять кластеров по типу задачи.

#Данные Битрикс24 (27) — ключ портала

Чтение и запись данных портала: CRM-сущности, чаты и боты, расширения для CRM, телефония, файлы, бизнес-процессы, рабочее время. Подходит большинству задач AI-агента.

#Сущности CRM и других модулей (10)

Покрывают единый CRUD-интерфейс над 40+ сущностями Битрикс24 — от сделок и контактов до задач, файлов, документов и записей смарт-процессов.

Поддерживаемые сущности: deals, contacts, companies, leads, quotes, activities, products, product-sections, statuses, currencies, deal-categories, requisites, timelines, invoices, items, smart-processes, tasks, calendar-events, files, folders, storages, users, departments, workgroups, chats, list-elements, catalog-products, catalog-sections, catalog-prices, orders, order-statuses, basket-items, payments, sites, pages, doc-templates, documents, bookings, bizproc-templates, openline-configs, telephony-lines и другие.

#Чаты (1)

Скоуп: im. Управляет чатами и сообщениями на стороне пользователя; для чатов, принадлежащих боту, нужен manage_bot_chat.

#Боты (3)

Управление ботами на платформе Битрикс24 — регистрация, чаты, обмен сообщениями. Скоуп ключа: imbot.

#CRM-расширения и работа с порталом (12)

#Универсальный вызов Vibe API (1)

Пример вызова: call_api({ method: "GET", path: "/v1/calls/statistics" }).

#AI (2) — ключ портала

Подключение AI-моделей через AI Router и управление BYOK-учётными данными. Скоуп: vibe:ai.

#Сборка приложений (14) — ключ портала

Создание приложений Битрикс24, развёртывание серверной части на облачных VM, настройка плейсментов в интерфейсе портала.

#Инфраструктура (3)

Облачные серверы для приложений и Black Hole-туннели. Скоуп: vibe:infra.

#Приложения (5)

#Публикация и развёртывание приложений (5)

#Плейсменты (1)

Скоуп: placement.

#Платформенное управление (8) — управляющий ключ

Эта группа доступна только управляющим ключам Вайбкод (формат vibe_live_...).

#Служебные (2) — любой ключ

Доступны и ключу портала, и управляющему.

#Resources

URI вида vibe://... отдают справочные материалы для AI-агента.

#Prompts

Готовые мульти-шаговые подсказки для AI-агента. Активируются клиентом по имени.

#HTTP-транспорт

Помимо stdio (используется по умолчанию) mcp-vibe-api поддерживает HTTP-транспорт. Подходит для серверных интеграций, где stdio неудобен.

mcp-vibe-api \
  --key vibe_api_your_key_here \
  --http \
  --http-token "$(openssl rand -hex 32)" \
  --allowed-origins https://your-client.example.com

Клиент отправляет POST http://127.0.0.1:3001/mcp с заголовками:

Authorization: Bearer <token>
Content-Type: application/json

Сервер откажется стартовать, если --http указан без токена. Сами токены не пишутся в журналы — на старте указывается только их источник (флаг или переменная окружения).

#mcp-docs

Справочник по REST API Битрикс24: методы, скоупы, плейсменты, типы и категории приложений. Работает офлайн без API-ключа — все данные встроены в пакет.

#Установка

Пакет `@bitrix24/mcp-docs`. После установки доступна команда mcp-docs. API-ключ не нужен — справочник встроен в пакет и работает без сети.

npm install -g @bitrix24/mcp-docs

#Регистрация в клиенте

Через CLI:

claude mcp add bitrix24-docs -- mcp-docs
codex mcp add bitrix24-docs -- mcp-docs
gemini mcp add bitrix24-docs mcp-docs

Через конфиг-файл:

{
  "mcpServers": {
    "bitrix24-docs": {
      "command": "mcp-docs"
    }
  }
}

#Инструменты (8)

Дополнительно сервер публикует ресурс с гайдом по REST API и промпт bitrix24-rest-intro — введение в REST и в синтаксис Вайбкод-прокси.

#Прямое использование Vibe API без MCP

Если MCP-клиент недоступен, дайте AI-модели API-ключ и ссылку на полный справочник:

Вот мой API-ключ Вайбкод: vibe_api_your_key_here
Полная документация: https://vibecode.bitrix24.tech/llms-full.txt

Опишите вашу задачу...

mcp-vibe-api подключается к любому клиенту с поддержкой Model Context Protocol — Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Gemini CLI и другим. Прямой ключ без MCP подойдёт даже клиентам без поддержки протокола, например ChatGPT.

#Безопасность

• Передавайте API-ключ через переменную окружения VIBE_API_KEY или флаг --key — не вписывайте ключ в скрипты, репозитории и публичные конфиги.
• Создавайте отдельный ключ для каждого AI-агента и оставляйте только нужные скоупы — ключи vibe_api_... поддерживают список скоупов и срок действия.
• Для серверных сценариев настраивайте IP-вайтлист и фиксированный срок жизни ключа.
• В HTTP-транспорте используйте Bearer-токен из --http-token или VIBE_MCP_HTTP_TOKEN и оставляйте --host 127.0.0.1, если внешний доступ не нужен.
• Если ключ скомпрометирован — отзовите его в разделе ключей и создайте новый.

#Смотрите также

• Управление ключами — типы ключей Вайбкод и их скоупы
• Эндпоинты Vibe API — единый CRUD над сущностями Битрикс24
• AI Router — модели и BYOK-провайдеры
• Обратная связь — отправка сообщений о проблемах через /v1/feedback