Bitrix24 MCP Server (NeedMoarr)
bitrix24-mcp
Однофайловый MCP для Битрикс24 на uv run: задачи с чек-листами, чаты, календарь, сделки CRM и ежедневный дайджест
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может создавать задачи, события календаря и отправлять сообщения от имени вебхука
- Вебхук с расширенным набором прав хранится только в переменной окружения
- Читает переписку в чатах и задачах
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/needmoarr-bitrix24-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'BITRIX_WEBHOOK_URL=<ваш BITRIX_WEBHOOK_URL>' bitrix24-mcp -- uvx run server.pyИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"bitrix24-mcp","type":"stdio","command":"uvx","args":["run","server.py"],"env":{"BITRIX_WEBHOOK_URL":"<ваш BITRIX_WEBHOOK_URL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add bitrix24-mcp --env 'BITRIX_WEBHOOK_URL=<ваш BITRIX_WEBHOOK_URL>' -- uvx run server.pyИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24-mcp]
command = "uvx"
args = ["run", "server.py"]
env = { BITRIX_WEBHOOK_URL = "<ваш BITRIX_WEBHOOK_URL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'BITRIX_WEBHOOK_URL=<ваш BITRIX_WEBHOOK_URL>' bitrix24-mcp uvx run server.pyИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24-mcp": {
"type": "local",
"command": [
"uvx",
"run",
"server.py"
],
"environment": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<ваш BITRIX_WEBHOOK_URL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
BITRIX_WEBHOOK_URLсекрет, обязательная- URL входящего вебхука Bitrix24
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи uv, скачай server.py из NeedMoarr/bitrix24-mcp и зарегистрируй его в Claude Code командой claude mcp add --scope user bitrix24 -e BITRIX_WEBHOOK_URL='<свой вебхук>' -- uv run <путь до server.py>.
Другие способы из описания автора
claude mcp add --scope user bitrix24 -e BITRIX_WEBHOOK_URL='https://<portal>.bitrix24.ru/rest/<user_id>/<token>/' -- uv run /path/to/server.pyКоманда из README, путь до server.py и вебхук нужно заменить на свои.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Может создавать задачи, события календаря и отправлять сообщения от имени вебхука
- Вебхук с расширенным набором прав хранится только в переменной окружения
- Читает переписку в чатах и задачах
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер это один Python-файл server.py с заголовком PEP 723, который запускается командой uv run и сам подтягивает зависимости. Через входящий вебхук портала он дает больше пятнадцати инструментов: полный цикл задач с BB-кодом, чек-листами и комментариями из чата задачи, последние диалоги и отправку сообщений только по явной просьбе пользователя, поиск сотрудников и структуру компании, события календаря, сделки CRM, статистику звонков через telephony и сводный дайджест дня: просрочки, дедлайны недели, открытые задачи и непрочитанные чаты.
Для кого. Для тех, кто хочет один личный MCP-сервер, покрывающий задачи, чаты, календарь и сделки Битрикс24 сразу.
Подходит, если
- Нужен дневной дайджест по просрочкам, дедлайнам и непрочитанным чатам
- Нужны и задачи, и чаты, и календарь в одном сервере
- Хочется запускать сервер через uv run без ручной установки зависимостей
Не подходит, если
- Нужны тесты и стабильный публичный релиз
- Нужна работа с несколькими порталами одновременно
Пример запроса к агенту
Дай дневной дайджест: что просрочено, какие дедлайны на этой неделе и что непрочитано в чатахMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
BITRIX_WEBHOOK_URLобязательная, секрет- Адрес входящего вебхука портала Битрикс24 с расширенными правами
Ограничения
Один файл без тестов и лицензии, README содержит команду регистрации сервера с личным путем автора на его компьютере, ее нужно переписать под свою систему. Статистика звонков через voximplant в README отмечена как возможно недоступная на конкретном портале автора. Токен передается только через переменную окружения, ротации нет.
Как отключить. Удалите сервер командой claude mcp remove bitrix24 в user scope или уберите блок из конфигурации клиента.
Частые вопросы
Нужно ли устанавливать зависимости вручную?
Нет, uv run сам ставит их по PEP 723-заголовку в начале server.py.
Сервер сам пишет сообщения сотрудникам?
README прямо требует вызывать chat_send только по явной просьбе пользователя, а не по инициативе агента.
Похожие
MCP-серверыMCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub
Коротко о README
README на русском группирует больше пятнадцати инструментов по разделам: задачи, чаты и сообщения, остальное (сотрудники, группы, календарь, сделки, звонки, дайджест, профиль). Дан пример регистрации в Claude Code с uv run, список прав вебхука, расширенных 14 августа 2026 года, и пояснение, что комментарии задач на самом деле живут в чатах, а не в легаси-методе task.commentitem.getlist.