Bitrix24 MCP с подтверждением записи

Установка

npx skillfoxx add mcp/ericvanin-bitrix24-mcp-server

claude mcp add --transport http bitrix24 https://your-server.example.com/mcp

{
  "mcpServers": {
    "bitrix24": {
      "type": "http",
      "url": "https://your-server.example.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "bitrix24": {
      "url": "https://your-server.example.com/mcp"
    }
  }
}

code --add-mcp '{"name":"bitrix24","type":"http","url":"https://your-server.example.com/mcp"}'

{
  "servers": {
    "bitrix24": {
      "type": "http",
      "url": "https://your-server.example.com/mcp"
    }
  }
}

codex mcp add bitrix24 --url https://your-server.example.com/mcp

[mcp_servers.bitrix24]
url = "https://your-server.example.com/mcp"

gemini mcp add -s user -t http bitrix24 https://your-server.example.com/mcp

{
  "mcpServers": {
    "bitrix24": {
      "httpUrl": "https://your-server.example.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "bitrix24": {
      "serverUrl": "https://your-server.example.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "bitrix24": {
      "type": "streamableHttp",
      "url": "https://your-server.example.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "bitrix24": {
      "type": "streamable-http",
      "url": "https://your-server.example.com/mcp"
    }
  }
}

{
  "mcp": {
    "bitrix24": {
      "type": "remote",
      "url": "https://your-server.example.com/mcp"
    }
  }
}

{
  "context_servers": {
    "bitrix24": {
      "url": "https://your-server.example.com/mcp"
    }
  }
}

cp .env.example .env && npm ci && npm run build && npm start

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер размещается самостоятельно (Docker Compose или Coolify) с собственным OAuth-приложением Битрикс24 и базой PostgreSQL. Каждый MCP-клиент проходит отдельную авторизацию OAuth 2.1 с PKCE и динамической регистрацией, токены Битрикс24 шифруются AES-256-GCM и обновляются потокобезопасно. Инструменты чтения обнаруживают схему конкретного портала: типы CRM-сущностей включая смарт-процессы через crm.type.list, поля, воронки, стадии, пользователей и элементы по универсальным методам crm.item.*. Запись сделана намеренно в два шага: инструмент подготовки (создание, обновление, смена стадии) возвращает читаемую человеком сводку и ожидающую операцию, а выполняется только после отдельного вызова подтверждения; операция атомарна и не может выполниться дважды при параллельных запросах, ожидающие операции истекают через десять минут. Каждая запись оставляет аудит-запись со статусом. Сырые REST-вызовы, удаление, администрирование схемы, роботы, бизнес-процессы и привязка событий в этой версии намеренно не открыты.

Для кого. Для команд, которым важна многопользовательская авторизация каждого клиента и жесткий контроль над записью в CRM с подтверждением каждой операции.

Пример запроса к агенту

Подготовь перенос сделки 4821 на стадию «Оплачено» и покажи сводку перед подтверждением

Ограничения

Это независимый проект, не официальный продукт Битрикс24, автор рекомендует сначала протестировать на непродуктивном портале. Требует Node.js 20.11+, PostgreSQL 14+ и собственное OAuth-приложение Битрикс24 с публичным HTTPS-адресом обработчика. Версия 0.3.1 принимает облачные домены *.bitrix24.* и ровно один настроенный кастомный домен портала, другие коробочные домены пока отклоняются. Реальный доступ всегда ограничен правами того пользователя Битрикс24, который прошел OAuth, и правами самого OAuth-приложения.

Как отключить. Остановите развернутый сервер (docker compose down), удалите OAuth-приложение в портале и отзовите MCP_AUTH_TOKEN.

MCP

Транспорт

http

Авторизация

OAuth

Проверка безопасности

• При включенном режиме write_with_confirmation может создавать и менять сущности CRM после подтверждения
• Хранит зашифрованные OAuth-токены пользователей портала в собственной базе PostgreSQL

Коротко о README

README перечисляет включенное (собственное OAuth-приложение, шифрование токенов, read-only инструменты, обнаружение SPA, кеш метаданных схемы, подготовленные операции записи с подтверждением, аудит, стейтлес Streamable HTTP с OAuth 2.1), быстрый старт с переменными окружения, установку локального приложения Битрикс24, подключение клиентов (Claude custom connector, Claude Code, Codex, generic static-bearer), полную таблицу конфигурации, инструкции по Docker и Coolify и архитектурную схему. Ссылки на SECURITY.md перед продакшен-развертыванием.

Похожие