Интеграционный сервер， использующий Model Context Protocol （MCP）， для предоставления доступа к данным и функциям Bitrix24 для больших языковых моделей （LLM） и других AI-агентов.LLM могут безопасно взаимодействовать с вашими CRM-данными (контакты, сделки), используя предопределенные “инструменты” и “ресурсы”, предоставляемые этим сервером через стандартный протокол MCP.

Ключевые Особенности

• Интеграция с Bitrix24： Доступ к контактам и сделкам через Bitrix24 REST API.
• Model Context Protocol （MCP）: Предоставляет стандартизированный интерфейс для взаимодействия с AI-моделями.
• Инструменты (Tools): Функции, которые AI может вызывать (например, поиск контактов, обновление стадии сделки).
• Ресурсы （Resources）: Данные， которые AI может запрашивать （например， информация о конкретном контакте или список активных сделок）.
• Промпты （Prompts）: Шаблоны для генерации запросов к AI.
• Асинхронность: Построен на asyncio для эффективной обработки запросов.
• Внедрение Зависимостей: Использует wireup для управления зависимостями.
• Конфигурируемость: Настройки управляются через переменные окружения.

Bitrix24 MCP Server

Интеграционный сервер, использующий Model Context Protocol (MCP), для предоставления доступа к данным и функциям Bitrix24 для больших языковых моделей (LLM) и других AI-агентов. LLM могут безопасно взаимодействовать с вашими CRM-данными (контакты, сделки), используя предопределенные “инструменты” и “ресурсы”, предоставляемые этим сервером через стандартный протокол MCP.

Ключевые Особенности

• Интеграция с Bitrix24: Доступ к контактам и сделкам через Bitrix24 REST API.
• Model Context Protocol (MCP): Предоставляет стандартизированный интерфейс для взаимодействия с AI-моделями.
  • Инструменты (Tools): Функции, которые AI может вызывать (например, поиск контактов, обновление стадии сделки).
  • Ресурсы (Resources): Данные, которые AI может запрашивать (например, информация о конкретном контакте или список активных сделок).
  • Промпты (Prompts): Шаблоны для генерации запросов к AI.
• Асинхронность: Построен на asyncio для эффективной обработки запросов.
• Внедрение Зависимостей: Использует wireup для управления зависимостями.
• Конфигурируемость: Настройки управляются через переменные окружения.
• Структурированное Логирование: Использует structlog для удобного отслеживания событий.
• Расширяемость: Легко добавлять поддержку новых сущностей Bitrix24 или новые MCP инструменты/ресурсы.

Технологии

• Python 3.12+
• Fast-Bitrix24: Клиент для Bitrix24 REST API
• MCP (Model Context Protocol): Фреймворк для создания MCP серверов (fastmcp)
• Pydantic & Pydantic-Settings: Валидация данных и управление настройками
• Structlog: Структурированное логирование
• Ruff: Линтер и форматер кода
• Asyncio
• Dishka: CLI-утилиты для управления зависимостями и скриптами

Начало Работы

Предварительные Требования

1. Python: Версия 3.12 или выше.
2. Bitrix24:
   • Аккаунт Bitrix24 (облачный или коробочный).
   • Входящий вебхук (Webhook) с необходимыми правами (как минимум crm). Как создать вебхук.

Конфигурация

Серверу требуется задать переменную окружения BITRIX_WEBHOOK_URL:

export BITRIX_WEBHOOK_URL="https://your-domain.bitrix24.ru/rest/1/yoursecretcode/"

Запуск Сервера

запустите MCP сервер:

uvx bitrix24-mcp