MCP-сервер для работы с REST API Битрикс24

Model Context Protocol (MCP) для Битрикс24 — это сервер, который позволяет AI-инструментам с поддержкой MCP получать актуальную REST-документацию Битрикс24.

Если использовать MCP-сервер, нейросеть:

  • обращается к реальной документации Битрикс24
  • не выдумывает REST-методы
  • генерирует корректный код интеграций и приложений

Когда нужно использовать MCP

Подключайте MCP-сервер Битрикс24, если:

  • вы разрабатываете чат-бота для Битрикс24
  • создаете приложение или интеграцию через REST API
  • настраиваете автоматизацию, AI-агента или no-code сценарий
  • пишете чат-бота для Битрикс24 с помощью ChatGPT
  • генерируете код интеграции Битрикс24 через Claude или Copilot
  • нейросеть выдает несуществующие REST-методы Битрикс24
  • AI открывает ссылки документации Битрикс24 и получает 404

Как работает MCP в Битрикс24

MCP-сервер передает AI-ассистенту структурированные данные из документации Битрикс24: описания методов, списки параметров, допустимые значения и подсказки по использованию.

Это позволяет:

  • получать актуальные методы и поля API под конкретную задачу
  • работать со структурированными данными вместо свободного текста
  • сокращать количество ошибок и правок кода

Транспортный протокол

MCP-сервер Битрикс24 работает по протоколу Streamable HTTP без поддержки SSE (Server-Sent Events).

При настройке MCP-клиента выбирайте тип транспорта http (Streamable HTTP), а не sse. Например, в конфигурации VS Code это явно задается полем "type": "http".

Как подключить MCP-сервер

Укажите адрес сервера https://mcp-dev.bitrix24.tech/mcp в настройках среды разработки.

Сервер доступен без авторизации.

Codex CLI

  1. Добавьте MCP-сервер командой:
codex mcp add b24-dev-mcp --url https://mcp-dev.bitrix24.tech/mcp

  1. Проверьте, что сервер появился в списке, командой codex mcp list.

  2. После подключения отправляйте запросы в Codex как обычно. При необходимости укажите в запросе, что нужно использовать MCP и официальную документацию Битрикс24.

Codex, VS Code

  1. Откройте файл ~/.codex/config.toml.

  2. Добавьте конфигурацию MCP-сервера:

[mcp_servers.b24-dev-mcp]
        url = "https://mcp-dev.bitrix24.tech/mcp"

  1. Перезапустите VS Code или переподключите сессию Codex.

  2. Отправляйте запросы в чат Codex как обычно. При необходимости явно укажите, что нужно использовать MCP и официальную документацию Битрикс24.

Cursor

  1. Откройте File > Preferences > Cursor Settings > Tools & MCP > New MCP server. Cursor откроет системный файл mcp.json.

  2. Добавьте конфигурацию через создание нового элемент массива mcpServers в файле mcp.json:

{
        "mcpServers": {
            "b24-dev-mcp": {
            "url": "https://mcp-dev.bitrix24.tech/mcp",
            "timeout": 30000
            }
        }
        }

  1. Сохраните файл. На странице File > Preferences > Cursor Settings > Tools & MCP рядом с сервером появится зеленый индикатор и список доступных инструментов.

  2. При составлении запроса добавьте файл mcp.json в контекст.

Альтернативный способ добавления MCP. Нажмите на кнопку ниже, сработает перенаправление на Cursor. Cursor автоматически откроется и предложит добавить сервер с уже заполненной конфигурацией.

Add b24-dev-mcp MCP server to Cursor

GitHub Copilot Chat, VS Code

  1. Для настройки используйте инструкцию GitHub.

  2. Создайте файл .vscode/mcp.json в корне проекта. Содержимое файла:

{
          "servers": {
            "b24-dev-mcp": {
              "url": "https://mcp-dev.bitrix24.tech/mcp",
              "type": "http"
            }
          },
          "inputs": []
        }

  1. Запустите MCP-агент кнопкой Start, которая появится в файле .vscode/mcp.json.

  2. Выберите настроенный MCP-агент в чате. Copilot будет запрашивать контекст у MCP при генерации кода.

Claude Desktop, Anthropic

  1. Перейдите в Settings > Connectors.

  2. Нажмите Add custom connector.

  3. Заполните поля:

    • Name: b24-dev-mcp;

    • URL: https://mcp-dev.bitrix24.tech/mcp.

  4. Сохраните настройки. Claude автоматически определяет, когда стоит использовать MCP.

Claude Code CLI

  1. Выполните команду:
  claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.tech/mcp

  1. Проверьте, что сервер добавлен, командой claude mcp list.

  2. После подключения отправляйте запросы как обычно. Claude Code автоматически определяет, когда стоит использовать MCP.

Gemini Code Assist CLI

  1. Добавьте MCP-сервер командой:
gemini mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.tech/mcp
  1. Проверьте, что сервер появился в списке, командой gemini mcp list. Gemini автоматически определяет, когда стоит использовать MCP.

Google Antigravity

  1. Откройте меню MCP Store, нажав на ... в верхней части панели агента.

  2. Нажмите Manage MCP Servers.

  3. Выберите View raw config.

  4. Добавьте в открывшийся файл mcp_config.json настройки подключения:

    {
          "mcpServers": {
            "b24-dev-mcp": {
                 "serverUrl": "https://mcp-dev.bitrix24.tech/mcp"
             }
          }
        }

  5. Сохраните изменения.

Примеры запросов

MCP-сервер автоматически предоставляет ассистенту актуальные данные REST API Битрикс24, но способы взаимодействия между средой разработки и MCP различаются.

Пример универсального запроса к нейросети: «Напиши интеграцию для Битрикс24 через REST API. Для получения актуальных методов используй MCP-сервер и официальную документацию Битрикс24.»

Codex CLI

Особенность: чтобы Codex точно использовал MCP, явно указывайте это в запросе.

  1. Отправьте запрос в Codex, например: «Найди метод REST API Битрикс24 для создания лида и покажи пример запроса на JavaScript. Используй MCP».

  2. Codex обращается к подключенному MCP-серверу за актуальным описанием методов и параметров.

  3. Ассистент генерирует ответ с учетом документации.

Codex, VS Code

Особенность: чтобы Codex точно использовал MCP, явно указывайте это в запросе.

  1. Отправьте запрос в чат Codex, например: «Найди метод REST API Битрикс24 для создания лида и покажи пример запроса на JavaScript. Используй MCP».

  2. Codex обращается к подключенному MCP-серверу за актуальным описанием методов и параметров.

  3. Ассистент генерирует ответ с учетом документации.

Cursor

Особенность: необходимо подключить MCP конфигурацию в контекст чата.

  1. Добавьте файл mcp.json в контекст чата.

  2. Отправьте запрос в чат с AI-ассистентом — «Напиши curl-запрос для создания лида в Битрикс24.»

  3. Ассистент обратится к MCP-серверу.

  4. MCP вернет информацию о методе и его параметрах из документации.

  5. Ассистент сгенерирует код на основе ответа MCP.

GitHub Copilot Chat, VS Code

Особенность: необходимо выбрать MCP в качестве агента для выполнения запроса.

  1. Выберите MCP-агент и отправьте запрос в чат с AI-ассистентом — «Создай лид в Битрикс24 с контактной информацией и источником "веб-сайт". Покажи пример на JavaScript.»

  2. Copilot автоматически использует выбранный MCP-агент.

  3. MCP вернет информацию о методе и его параметрах из документации.

  4. Ассистент сгенерирует код на основе ответа MCP.

Claude Desktop, Anthropic

Особенность: автоматически определяет, надо ли использовать MCP.

  1. Отправьте запрос в чат с AI-ассистентом — «Напиши запрос для создания нового лида в Битрикс24. В лид будут переданы данные: имя, компания и телефон».

  2. Claude сам определит, что нужны данные из подключенного MCP и отправит запрос.

  3. MCP вернет информацию о методе и его параметрах из документации.

  4. Ассистент сгенерирует код на основе ответа MCP.

Claude Code CLI

Особенность: автоматически определяет, надо ли использовать MCP.

  1. Выполните команду claude для запуска сессии.

  2. Отправьте запрос — «Напиши curl-запрос для создания лида в Битрикс24».

  3. Claude Code сам определит, что нужны данные из подключенного MCP, и отправит запрос.

  4. MCP вернет описание подходящего метода и его параметры из документации.

  5. Ассистент сгенерирует код на основе ответа MCP.

Gemini Code Assist CLI

Особенность: автоматически определяет, надо ли использовать MCP.

  1. Выполните команду gemini chat и отправьте запрос — «Собери curl-запрос для создания лида с полями имя, телефон и источником «сайт».

  2. Gemini сам определит, что нужны данные из подключенного MCP и отправит запрос.

  3. MCP вернет описание подходящего метода и его параметры из документации.

  4. Gemini сгенерирует код на основе ответа MCP.

Google Antigravity

Особенность: автоматически определяет, надо ли использовать MCP.

  1. Отправьте запрос в чат — «Найди метод для обновления сделки в CRM».

  2. Antigravity определит, что нужны данные из MCP, выполнит поиск и вернет результат.

  3. Ассистент сгенерирует ответ с учетом документации.

FAQ

Почему ChatGPT выдумывает методы Bitrix24 REST API?

Потому что у нейросети нет доступа к актуальной документации. Подключение MCP-сервера позволяет модели получать реальные методы API.

Как заставить Claude использовать документацию Bitrix24?

Подключить MCP-сервер Bitrix24. После этого модель будет обращаться к документации напрямую.

Можно ли использовать MCP для генерации Bitrix24 интеграций?

Да. MCP позволяет AI-ассистентам получать методы REST API и генерировать корректный код.

Предыдущая
Работа в контексте текущего пользователя
Следующая
Обзор раздела