# Битрикс24 MCP — сделки, задачи и контакты CRM через нейросеть

Если вы искали, как подключить Битрикс24 к ИИ-ассистенту, спрашивать про сделки и задачи обычными словами или заводить карточки не открывая интерфейс — это оно. **12 инструментов** для сделок, контактов, задач, пользователей, файлов и сообщений. Подключение — через входящий вебхук **Bitrix24**, без OAuth-приложения и без программирования.

[![npm](https://img.shields.io/npm/v/@theyahia/bitrix24-mcp)](https://www.npmjs.com/package/@theyahia/bitrix24-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Часть серии [WWmcp](https://github.com/theYahia/WWmcp) от [@theYahia](https://github.com/theYahia).

## Настройка

1. В Битрикс24 откройте **Приложения → Разработчикам → Другое → Входящий вебхук**
2. Создайте вебхук с правами: `crm`, `task`, `user`, `disk`, `im`
3. Скопируйте полный URL вебхука

## Подключение к Claude Desktop

```json
{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "@theyahia/bitrix24-mcp"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://your-company.bitrix24.ru/rest/1/your-webhook-key/"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://your.bitrix24.ru/rest/1/key/ -- npx -y @theyahia/bitrix24-mcp
```

## Инструменты (12)

| Инструмент | Описание |
|------|-------------|
| `list_deals` | Список сделок CRM с фильтрами по стадии, ответственному и сортировкой |
| `get_deal` | Получить одну сделку по ID |
| `create_deal` | Создать сделку с названием, суммой, стадией и контактами |
| `update_deal` | Обновить поля сделки |
| `list_contacts` | Список контактов с фильтрами по имени, телефону и e-mail |
| `create_contact` | Создать контакт с именем, телефоном и e-mail |
| `list_tasks` | Список задач с фильтрами по статусу, ответственному и группе |
| `create_task` | Создать задачу с названием, дедлайном и приоритетом |
| `complete_task` | Отметить задачу выполненной |
| `list_users` | Список сотрудников с фильтрами по активности и отделу |
| `upload_file` | Загрузить файл на Битрикс24.Диск |
| `send_message` | Отправить сообщение в чат сотруднику или в группу |

## Демо-промпты

```
Покажи все открытые сделки в Битрикс24
Создай сделку «Редизайн сайта» на 500000 рублей
Выведи все контакты с почтой на «@gmail.com»
Поставь задачу «Подготовить презентацию» сотруднику 5, дедлайн завтра
Заверши задачу 123
Кто из сотрудников активен в отделе 2?
Отправь сообщение сотруднику 1: «Встреча через 15 минут»
```

## Переменные окружения

| Переменная | Обяз. | Описание |
|----------|----------|-------------|
| `BITRIX24_WEBHOOK_URL` | да | Полный URL вебхука Битрикс24 вместе с ключом авторизации |

## Лицензия

MIT

---

Часть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)