bitrix24-mcp

Name: bitrix24-mcp
Author: theYahia

本地服务

github.com/theYahia商业与营销18 周前更新

代码仓库

关于 bitrix24-mcp

bitrix24-mcp 通过 Bitrix24 入站 Webhook 将 CRM 与日常协作功能提供给 AI 助手使用。它包含处理交易、联系人、任务、用户、文件和消息的工具，无需创建 OAuth 应用。

主要功能

01筛选、查看和管理 CRM 交易
02筛选及创建联系人
03创建和完成任务
04按条件查询用户
05上传文件并发送消息

适用场景

01查询特定阶段或负责人的交易
02创建联系人或更新交易信息
03为员工创建任务并跟踪完成情况
04上传文件或向员工聊天发送消息

MCP 相关

该 MCP 服务通过 Bitrix24 入站 Webhook 向 MCP 客户端提供 12 个工具，覆盖 CRM 交易、联系人、任务、用户、文件和消息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "theyahia-bitrix24": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

启动命令npx -y @theyahia/bitrix24-mcp

需要配置的环境变量

BITRIX24_WEBHOOK_URL密钥API key for the service

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@theyahia/bitrix24-mcp1.0.1stdio

工具

收录的工具列表 · 更新于 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

Часть WWmcp · Telegram: @vhodvai

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。