Интеграционный сервер, игспользуннннанннный предодотавледия доступа к дам и фукиям дкиям дродадовадьм дададродеродададеродродадададьмеродададродададададададродадададьдададададададрадрадродродрадродьний дьний дродродадададродадададададададададьдададродродр LLM могут безопасно взаимодействонать с вашимоданнннными (котдакты, ссссссссссселки), испредопредопреререререререререререререререререререререререререререревикикий провавававый провивавававивавававый провый провый провый провый провый провский провский провав

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

И ** нттеграция с Bitrix24:* Доступ контактам и сделкам через Bitrix24 REST API.

• モデルコンテキストプロトコル(MCP): Предоставляет стаддартизированы ны нтерфейс для взаимодетвия с AI-моделями. И ** нструменты (ツール):* Фукциии, которые 人工知能 может вызывать (например, поискотактов, обовлетие стадимелидидеделки). *** Ресурсы (リソース):** Даные, которые 人工知能 может запрашивать (например, информаия о ко конкретсом контактакте илили пинаримеримеродер, инанапримеримеримеримеримермеронананананананананананананародь, инапринапримеримеримеринапримеримеримеримеродь, нанананапапринапримеримеринанананапр *Промпты(プロンプト): Таблоны для генераци запросов к 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