MCP-сервер Битрикс24: чтобы нейросеть не выдумывала методы

Главная беда генерации кода для Битрикс24 в выдуманных методах. Модель уверенно предлагает вызов, которого в API нет, и обнаруживается это уже при запуске. MCP-сервер решает проблему просто: он отдаёт модели настоящую документацию, и та пишет код по ней, а не по памяти.

Доступа к данным портала у сервера нет: он возвращает описания методов, параметры, ошибки и примеры. Запросы в Битрикс24 отправляет уже тот код, который вы получили.

Как подключить

1. Возьмите адрес сервера: https://mcp-dev.bitrix24.tech/mcp. Авторизация не нужна.
2. Добавьте его в свой инструмент. В Claude Code это команда claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.tech/mcp, в Codex команда codex mcp add b24-dev-mcp --url https://mcp-dev.bitrix24.tech/mcp, в Cursor сервер прописывается в файле mcp.json, в Copilot в файле .vscode/mcp.json с типом http.
3. Проверьте, что инструмент видит сервер: в интерфейсных клиентах рядом с ним появляется список из пяти инструментов, имена которых начинаются с bitrix-.
4. Отправьте контрольный запрос: «Используй MCP-сервер Битрикс24 и покажи параметры метода crm.item.add». В ответе должны прозвучать entityTypeId и fields.

Если вместо имён параметров пришли общие рассуждения о CRM, модель отвечает по памяти и к серверу не обращалась. Этот признак работает в любом клиенте.

Инструменты вызываются по-разному

Claude Code, Claude Desktop, Gemini и Antigravity обращаются к серверу сами, когда видят, что задача про Битрикс24. Codex нужно просить явно: добавьте в запрос, что следует использовать MCP и официальную документацию. Cursor смотрит на содержимое контекста, поэтому файл с настройками добавляют в чат. В Copilot сервер выбирается в списке инструментов.

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

Если не работает

Ошибка подключения обычно означает, что клиент пытается использовать устаревший транспорт. Сервер работает по Streamable HTTP, отдельного адреса для SSE у него нет: в настройках выбирайте тип http. Ответ с кодом 406 говорит, что клиент принимает только JSON, а должен принимать и поток событий. Ответ «не найдено» означает неточное имя метода: сначала ищем через поиск по документации, потом запрашиваем подробности по найденному имени. Если запрос вообще не уходит, проверьте исходящий доступ к домену сервера: в корпоративных сетях его закрывает прокси.

Когда задача не про REST API, а про готовое приложение в портале, смотрите в сторону Вайбкода: там документация приходит агенту автоматически.