bitrix24-mcp について
bitrix24-mcp は Bitrix24 の受信 Webhook を通じて、CRM と連携機能を AI アシスタントから利用できるようにします。取引、連絡先、タスク、ユーザー、ファイル、メッセージを扱うツールを備え、OAuth アプリは不要です。
主な機能
- 01CRM 取引の検索・表示・管理
- 02連絡先の検索と作成
- 03タスクの作成と完了処理
- 04条件を指定したユーザー検索
- 05ファイルのアップロードとメッセージ送信
活用シーン
- 01ステージや担当者で取引を検索
- 02連絡先の作成や取引情報の更新
- 03タスクを割り当てて完了状況を確認
- 04ファイルのアップロードや従業員への連絡
MCP 対応
Bitrix24 の受信 Webhook を介して、取引、連絡先、タスク、ユーザー、ファイル、メッセージを扱う 12 個のツールを MCP クライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
4掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| start | number | いいえ | ページネーションのオフセット（50 の倍数） |
| filter_stage_id | string | いいえ | ステージ ID で絞り込み（例：NEW、WON、LOSE） |
| filter_assigned_by_id | number | いいえ | 担当ユーザー ID で絞り込みます |
README（原文）English
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
Битрикс24 MCP — сделки, задачи и контакты CRM через нейросеть
Если вы искали, как подключить Битрикс24 к ИИ-ассистенту, спрашивать про сделки и задачи обычными словами или заводить карточки не открывая интерфейс — это оно. 12 инструментов для сделок, контактов, задач, пользователей, файлов и сообщений. Подключение — через входящий вебхук Bitrix24, без OAuth-приложения и без программирования.
Часть серии WWmcp от @theYahia.
Настройка
- В Битрикс24 откройте Приложения → Разработчикам → Другое → Входящий вебхук
- Создайте вебхук с правами:
crm,task,user,disk,im - Скопируйте полный URL вебхука
Подключение к Claude Desktop
{
"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
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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。