Битрикс24 MCP

kartochka/bitrix24-mcp· Проверено 12.11.2026· 65на GitHub

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

2 реализации:

Минимальный сервер на Python: 6 инструментов для контактов и сделок, запуск через uvx.

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

Что сделать до подключения

Python 3.12 или новее

Облачный или коробочный Битрикс24 с входящим вебхуком

BITRIX_WEBHOOK_URL

адрес входящего вебхука Битрикс24 с правами не меньше crm

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'BITRIX_WEBHOOK_URL=https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/' --transport stdio bitrix24 \
  -- uvx bitrix24-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.bitrix24]
command = "uvx"
args = ["bitrix24-mcp"]

[mcp_servers.bitrix24.env]
BITRIX_WEBHOOK_URL = "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": ["bitrix24-mcp"],
      "env": {
        "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "bitrix24": {
      "type": "stdio",
      "command": "uvx",
      "args": ["bitrix24-mcp"],
      "env": {
        "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": ["bitrix24-mcp"],
      "env": {
        "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": ["bitrix24-mcp"],
      "env": {
        "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "bitrix24": {
        "type": "local",
        "command": ["uvx", "bitrix24-mcp"],
        "environment": {
          "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": ["bitrix24-mcp"],
      "env": {
        "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": ["bitrix24-mcp"],
      "env": {
        "BITRIX_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.ru/rest/<ID>/<код вебхука>/"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_contactчитает контакт по ID

search_contactsищет контакт по имени, телефону, email

list_contactsперечисляет контакты компании

get_dealчитает сделку по ID

list_dealsперечисляет сделки

update_deal_stageменяет стадию сделки

52 инструмента на TypeScript: CRM, задачи, воронки и аналитика отдела продаж; ставится сборкой из исходников.

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

Что сделать до подключения

Node.js 18 или новее и npm

Копия репозитория: npm install и npm run build

BITRIX24_WEBHOOK_URL

в Битрикс24: Приложения → Вебхуки → Входящий вебхук, права на CRM и задачи

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'BITRIX24_WEBHOOK_URL=https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/' --transport stdio bitrix24-mcp-server \
  -- node /path/to/your/bitrix24-mcp-server/build/index.js

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.bitrix24-mcp-server]
command = "node"
args = ["/path/to/your/bitrix24-mcp-server/build/index.js"]

[mcp_servers.bitrix24-mcp-server.env]
BITRIX24_WEBHOOK_URL = "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "bitrix24-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/bitrix24-mcp-server/build/index.js"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "bitrix24-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/your/bitrix24-mcp-server/build/index.js"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "bitrix24-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/bitrix24-mcp-server/build/index.js"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "bitrix24-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/bitrix24-mcp-server/build/index.js"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "bitrix24-mcp-server": {
        "type": "local",
        "command": ["node", "/path/to/your/bitrix24-mcp-server/build/index.js"],
        "environment": {
          "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "bitrix24-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/bitrix24-mcp-server/build/index.js"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "bitrix24-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/bitrix24-mcp-server/build/index.js"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://<ваш-домен>.bitrix24.com/rest/<USER_ID>/<WEBHOOK_CODE>/"
      }
    }
  }
}

Инструменты сервера

bitrix24_create_contactсоздаёт контакт

bitrix24_create_dealсоздаёт сделку

bitrix24_update_dealменяет сделку

bitrix24_create_leadсоздаёт лид

bitrix24_get_latest_leadsпоказывает свежие лиды

bitrix24_create_companyсоздаёт компанию

bitrix24_create_taskставит задачу

bitrix24_list_tasksперечисляет задачи

bitrix24_search_crmищет по всей CRM

bitrix24_get_deal_stagesпоказывает стадии воронки

bitrix24_filter_deals_by_budgetотбирает сделки по бюджету

bitrix24_get_all_usersперечисляет сотрудников

bitrix24_diagnose_permissionsпроверяет права вебхука

bitrix24_monitor_user_activitiesпоказывает звонки и письма менеджера

bitrix24_compare_user_performanceсравнивает менеджеров

bitrix24_track_deal_progressionпоказывает движение сделки по стадиям

bitrix24_generate_sales_reportстроит отчёт по продажам

bitrix24_forecast_performanceстроит прогноз продаж

Показано 18 из 52.

Что попросить агента

«Создай контакт <Иван Петров> с почтой <ivan@example.com> и телефоном <+7 900 000-00-00>»Вызовет bitrix24_create_contact с именем, почтой и телефоном

«Создай контакт <Мария Иванова>, затем сделку «<Разработка сайта>» на <500 000> ₽ и привяжи её к контакту»Создаст контакт через bitrix24_create_contact и сделку с привязкой через bitrix24_create_deal

«Поставь задачу «<Перезвонить клиенту>» с высоким приоритетом на завтра и привяжи к контакту <ID>»Создаст задачу через bitrix24_create_task

«Найди все контакты и сделки, связанные с <example.ru>»Поищет по CRM через bitrix24_search_crm

«Переведи сделку <ID> в стадию <C14:WON>»В варианте kartochka проверит сделку через get_deal и сменит стадию через update_deal_stage

Для каких задач

Найти контакт по телефону или email и показать его сделки

Перевести сделку на следующую стадию воронки

Завести контакт, сделку на нужную сумму и связать их

Поставить задачу с дедлайном и привязать её к контакту

Сравнить менеджеров по сделкам и конверсии и собрать отчёт по продажам

Ограничения

Оба проекта давно не обновлялись: последние изменения в мае и июле 2025 года

Вебхук даёт полный доступ в пределах своих прав: держите его адрес в секрете и меняйте время от времени

Вариант kartochka умеет только контакты и сделки, без лидов, компаний и задач

Вариант gunnit ограничивает запросы к API двумя в секунду

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

Сервер пишет «Webhook validation failed»

Проверьте адрес вебхука, его права и доступность вашего портала Битрикс24.

Ошибки «Cannot find module» при запуске

Выполните npm install и соберите проект командой npm run build.

Лиды не читаются или доступ к ним запрещён

Дайте вебхуку права crm, crm.lead.read и crm.lead.write; в простом режиме CRM лиды могут быть выключены, переключите CRM в классический режим. Начните разбор с bitrix24_diagnose_permissions.

Постоянные ошибки лимита запросов

Клиент сам выдерживает 2 запроса в секунду; если ошибки не уходят, реже обращайтесь к серверу.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Bitrix24 MCP Server (kartochka)	kartochka	65	локально	токен	6	28 мая 2025
Bitrix24 MCP Server (gunnit)	gunnit	35	локально	токен	52	16 июля 2025

Частые вопросы

Как создать входящий вебхук?

В Битрикс24 откройте Приложения → Вебхуки и создайте входящий вебхук с правами на CRM, а для задач — и на них. Скопируйте адрес вида https://<домен>/rest/<ID>/<код>/ в переменную окружения сервера.

Подходит ли коробочный Битрикс24?

Вариант kartochka работает и с облачным, и с коробочным порталом. Нужен только входящий вебхук с правами crm.

Какой вариант выбрать?

kartochka ставится одной командой uvx bitrix24-mcp и закрывает поиск контактов и работу со стадиями сделок. gunnit требует сборки из исходников, зато покрывает лиды, компании, задачи и аналитику отдела продаж.

Сервер не видит лиды или задачи — что делать?

В gunnit вызовите bitrix24_diagnose_permissions и bitrix24_validate_webhook: они проверяют подключение и права вебхука. Чаще всего вебхуку не хватает нужного права.

Работает ли сервер из России?

Сервер запускается на вашем компьютере и обращается к вашему порталу Битрикс24 по вебхуку; зарубежные аккаунты не нужны.

Битрикс24 MCP

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

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

Какую реализацию выбрать

Частые вопросы

Похожие серверы