de en es ja ko ru zh

mcp-b24

Name: mcp-b24
Author: kostikpenzin

by kostikpenzin

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

适用于 Bitrix24 的 MCP 服务器

npm version npm downloads license tests Node.js MCP protocol platform

dependencies secrets malware

41 个工具 · 约 870 个操作 · Bitrix24 REST 1.0 + 3.0 · 88 个测试

适用于 Bitrix24 平台的 MCP 服务器。将 Bitrix24 REST API（CRM、任务、聊天、文件、日历、HR、智能流程、邮件、电话、工作流、事件、开放通道、聊天机器人、文档生成器、报价、货币、网页表单、跟踪、库存）封装为 41 个工具，你的 AI 代理可以直接调用——并且会在门户上执行真实调用（与官方的 Bitrix24 MCP 不同，后者仅提供文档）。

安装 · 配置 · 功能 · 工具 · 使用场景 · 开发 · npm 包

语言： English · Русский

门户与订阅

此 MCP 服务器封装了 Bitrix24 REST API。 Bitrix24 是一个一体化工作空间：CRM、任务、项目、聊天、视频通话、文档、邮件、日历、HR、业务流程、电话等。它提供云端（*.bitrix24.ru / *.bitrix24.com）和本地部署两种形式。

⚠️ 使用此服务器需要一个 Bitrix24 门户。你需要一个传入 Webhook（BX24_WEBHOOK_URL）或一个 OAuth 应用（BX24_DOMAIN + BX24_CLIENT_ID + BX24_CLIENT_SECRET + BX24_REFRESH_TOKEN）。在门户的 开发者资源 → 传入 Webhook 下创建 Webhook，或在 oauth.bitrix24.ru 注册 OAuth 应用。

➡️ 更多详情：bitrix24.com · REST 文档：apidocs.bitrix24.ru

Related MCP server: fast-bitrix24-mcp

兼容的 API 版本

API	版本	基础路径	认证	模块
Bitrix24 REST	1.0 + 3.0	`/rest/<method>.json`	传入 Webhook 或 OAuth 2.0	CRM、tasks、IM、disk、calendar、user、catalog、lists、mail、telephony、bizproc、HR、timeman、events、open lines、chat bots、document generator、quotes、currency、webforms、tracking、inventory

安装

前提条件

Node.js 18+
一个有效的 Bitrix24 门户（云端或本地部署）
一个认证凭据：传入 Webhook 或 OAuth 应用（见下文）

从 npm 安装

npm install -g mcp-b24
# or run without installing
npx -y mcp-b24

环境变量

变量	必填	描述
`BX24_MODE`	可选	`webhook` 或 `oauth`（省略时自动检测）
`BX24_WEBHOOK_URL`	webhook	传入 Webhook URL：`https://portal.bitrix24.ru/rest/<user_id>/<secret>/`
`BX24_DOMAIN`	oauth	门户域名，例如 `portal.bitrix24.ru`
`BX24_CLIENT_ID`	oauth	OAuth 客户端 ID
`BX24_CLIENT_SECRET`	oauth	OAuth 客户端密钥
`BX24_REFRESH_TOKEN`	oauth	用于自动刷新的刷新令牌
`BX24_ACCESS_TOKEN`	可选	现成的访问令牌（否则从刷新获取）
`BX24_OAUTH_SERVER`	可选	`https://oauth.bitrix.info`（默认）
`BX24_CONFIRM_DESTRUCTIVE`	可选	设置为 `true` 以在破坏性操作前要求 `confirm: true`
`BX24_AUTO_PAGINATE`	可选	设置为 `true` 以自动收集列表页，最多 `BX24_MAX_ROWS` 行
`BX24_MAX_ROWS`	可选	自动分页的行数上限（默认 5000）
`BX24_RATE_LIMIT_RPS`	可选	每秒请求数（非企业版 ≤2，企业版 ≤5；默认 2）
`BX24_RATE_LIMIT_BURST`	可选	令牌桶突发（默认 50）
`BX24_DEFAULT_LANG`	可选	`ru` 或 `en`（默认 `ru`）
`BX24_LOG_LEVEL`	可选	`silent` `error` `warn` `info` `debug`（默认 `info`）
`BX24_AUDIT_LOG`	可选	破坏性 + 认证事件的 JSONL 审计路径（省略则禁用）
`BX24_TRANSPORT`	可选	`stdio` 或 `http`（默认 `stdio`）
`BX24_HTTP_HOST/PORT/PATH`	可选	HTTP 传输端点（默认 `127.0.0.1:3000/mcp`）

你可以：

设置 BX24_WEBHOOK_URL — 最简单，以 Webhook 创建者的身份操作；无需刷新，或
设置 BX24_DOMAIN + OAuth 凭据 — 服务器将自动刷新访问令牌（有效期约 1 小时）并遵循 OAuth 响应中的 client_endpoint。

破坏性操作确认

当设置 BX24_CONFIRM_DESTRUCTIVE=true 时，服务器在执行破坏性操作（delete、remove、complete、leave、kick、cancel、stop、close、mute、unbind、clear、markDeleted、kill 等）之前要求显式的 confirm: true 参数。没有该参数时，工具会返回结构化的 requiresConfirmation 预览并且不会执行，从而防止 AI 代理造成意外数据丢失。每次执行的破坏性操作都会写入 JSONL 审计日志（BX24_AUDIT_LOG）。当未设置或为 false 时，破坏性操作无需确认即可执行（默认）。

MCP 客户端配置

Claude Desktop

添加到 claude_desktop_config.json：

npx（推荐）：

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/",
        "BX24_CONFIRM_DESTRUCTIVE": "true"
      }
    }
  }
}

OAuth：

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_MODE": "oauth",
        "BX24_DOMAIN": "portal.bitrix24.ru",
        "BX24_CLIENT_ID": "app.abc123",
        "BX24_CLIENT_SECRET": "******",
        "BX24_REFRESH_TOKEN": "******"
      }
    }
  }
}

Windows — 使用 cmd /c：

{
  "mcpServers": {
    "bitrix24": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Docker：

docker build -t mcp/bitrix24 .

{
  "mcpServers": {
    "bitrix24": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "BX24_WEBHOOK_URL", "mcp/bitrix24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Streamable HTTP：

BX24_TRANSPORT=http BX24_HTTP_PORT=3000 BX24_WEBHOOK_URL="https://..." npx mcp-b24
# serves http://127.0.0.1:3000/mcp

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

VS Code

添加到 .vscode/mcp.json（注意：顶层键是 servers，而不是 mcpServers）：

{
  "servers": {
    "bitrix24": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Codex CLI

codex mcp add bitrix24 --env BX24_WEBHOOK_URL=https://portal.bitrix24.ru/rest/1/abcd1234/ -- npx -y mcp-b24

从源码

git clone https://github.com/kostikpenzin/mcp_b24.git
cd mcp_b24
npm install
npm run build

{
  "mcpServers": {
    "bitrix24": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_b24/dist/index.js"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

工具概览

41 个工具，约 870 个操作

工具	描述	分组
`bx24_crm_leads`	线索：增删改查、联系人、产品行、用户字段、转换、卡片配置	CRM
`bx24_crm_deals`	交易 + 管道/类别、产品行、联系人绑定、重复交易、用户字段	CRM
`bx24_crm_contacts`	联系人：增删改查、公司绑定、用户字段、卡片配置	CRM
`bx24_crm_companies`	公司：增删改查、联系人绑定、用户字段、卡片配置	CRM
`bx24_crm_invoices`	发票（SMART_INVOICE，entityTypeId=31）+ 阶段	CRM
`bx24_crm_products`	贸易目录：产品、分类、价格、仓库、价格类型、计量单位、增值税、比率、库存单据、属性、报价/SKU/服务	CRM
`bx24_crm_activities`	活动（通话/会议/邮件）+ 待办 + 可配置 + 类型 + 徽章 + 完整时间线	CRM
`bx24_crm_requisites`	银行账户信息 + 预设 + 银行明细 + 关联 + 用户字段	CRM
`bx24_crm_duplicates`	重复项搜索与合并 + 状态字典 + 易变类型	CRM
`bx24_smart_processes`	智能流程：类型 + 项目（任意实体）	CRM
`bx24_crm_quotes`	报价：增删改查、产品行、联系人绑定、用户字段	CRM
`bx24_crm_documents`	文档生成器：模板、文档、编号器、绑定、提供程序	CRM
`bx24_crm_currency`	货币：增删改查、基础货币、本地化	CRM
`bx24_crm_webform`	网页表单 + 结果 + 选项	CRM
`bx24_crm_tracking`	跟踪：轨迹、来源、渠道	CRM
`bx24_crm_automation`	CRM 自动化触发器	CRM
`bx24_crm_calllists`	呼叫列表（冷呼叫拨号列表）	CRM
`bx24_crm_addresses`	CRM 地址：增删改查、按客户、按筛选器删除	CRM
`bx24_crm_stagehistory`	阶段移动历史	CRM
`bx24_tasks`	任务：生命周期 + 检查清单 + 评论 + 已用时间 + 流程 + 阶段 + 计划器 + 依赖关系 + 用户字段	协作
`bx24_projects`	群组/项目（社交网络）+ 成员 + 主题	协作
`bx24_disk`	磁盘：存储、文件夹、文件、版本、共享、外部链接、权限	协作
`bx24_im`	即时通讯：消息、通知、用户、搜索、计数器、最近、部门、事件 v2、文件 v2	协作
`bx24_im_chat`	聊天：创建、成员、所有者/管理员、标题/颜色/头像、静音、消息	协作
`bx24_conf`	视频会议	协作
`bx24_calendar`	日历：事件、日历节、会议、资源、可用性、设置	协作
`bx24_openlines`	IM 开放线路：配置、会话、操作员、CRM 链接、网络	协作
`bx24_bots`	聊天机器人 v2：注册、聊天、消息、反应、命令、文件、事件	协作
`bx24_users`	用户：当前、获取、搜索、用户字段（包括列表）、增删改查	组织
`bx24_departments`	部门 / 组织结构	组织
`bx24_time`	工作时间跟踪（timeman）+ 时间控制 + 网络范围 + 日程 + 记录	组织
`bx24_hr`	人力资源：员工、邀请、解雇、调动	组织
`bx24_lists`	通用列表（信息块）+ 分类 + 字段类型	业务
`bx24_mail`	邮件：邮箱、消息、发送/回复/转发、筛选器、服务、消息→任务/日历/聊天/CRM	业务
`bx24_reports`	分析与报表	业务
`bx24_marketing`	细分、广播、线索筛选器	业务
`bx24_workflows`	业务流程与机器人：模板、实例、任务、机器人/活动增删改查、事件	业务
`bx24_telephony`	电话：外部线路/通话、SIP、voximplant（回拨、信息呼叫、TTS、线路、统计）	业务
`bx24_events`	事件订阅 + 离线队列 + 支持的事件列表	业务
`bx24_batch`	在一个请求中组合最多 50 个 REST 调用（`$result[]` 引用）	通用
`bx24_call`	按名称调用任意 Bitrix24 REST 方法（逃生舱）	通用

每个领域工具都是基于操作的：action 枚举选择操作（例如 action: "add"、"list"、"update"、"delete"）。完整操作列表： docs/en/TOOLS_REFERENCE.md（俄语：docs/ru/）。

功能

MCP 服务器理解俄语和英语的自然语言。您无需知道工具名称或操作枚举——用简单的语言描述您的需求， AI 代理会将其映射到正确的工具和操作。

您可以做什么

CRM — 创建/查找/更新线索、联系人、公司、交易、报价；跨管道移动交易；管理活动（通话/会议）；产品行；自定义字段；银行账户信息 + 银行明细；查找并合并重复项；智能流程；文档生成；货币；网页表单；跟踪；地址；呼叫列表；自动化触发器；阶段历史
任务与项目 — 创建、完成、委派、推迟任务；检查清单；评论；已用时间；流程；看板阶段；计划器；依赖关系；用户字段；管理群组/项目 + 主题
聊天与即时通讯 — 创建聊天、添加/移除成员、发送/编辑/删除消息、反应、搜索、计数器、通知、最近；开放线路（配置、会话、操作员）；聊天机器人 v2（注册、命令、文件）
文件（磁盘） — 上传/下载/移动/复制文件、列出文件夹、版本、共享、公共链接、权限、附加对象
日历 — 事件、日历节、会议、资源、可用性、设置
人力资源与组织 — 用户、部门、工作时间 + 时间控制 + 网络范围 + 日程、邀请/解雇/调动
业务 — 通用列表 + 分类、邮件（包括消息→任务/事件/聊天/CRM）、报表、营销、工作流 + 机器人/活动增删改查、电话（通话、SIP、 voximplant 回拨/信息呼叫/TTS/线路/统计）、事件
贸易目录 — 产品、分类、价格、价格类型、计量单位、增值税、比率、舍入规则、附加费用、库存单据、产品属性、变体（报价）、SKU 头、服务、库存记录（bizproc）、电话、事件订阅
批量与通用 — 组合最多 50 个调用；按名称调用任意 REST 方法

安全性

凭据（webhook 密钥、OAuth 令牌）绝不会暴露给 AI 代理或在工具结果中返回
破坏性操作可能需要显式 confirm: true （BX24_CONFIRM_DESTRUCTIVE=true），并写入 JSONL 审计日志
通过令牌桶遵守速率限制；QUERY_LIMIT_EXCEEDED（503）和 OPERATION_TIME_LIMIT（429）会以退避方式重试
密码管理和认证/登录操作被排除——认证通过环境变量自动处理

使用场景

1. 创建线索

您说："创建一条线索 Ivan Petrov，电话 +79001234567，邮箱 ivan@example.ru"

AI 代理将调用 bx24_crm_leads，使用 action: "add" 和 fields = { TITLE: "Ivan Petrov", PHONE: [{ VALUE: "+79001234567", VALUE_TYPE: "WORK" }], EMAIL: [...] }。

2. 显示我今天的任务

您说："Покажи мои задачи на сегодня"

AI 代理将调用 bx24_tasks，使用 action: "list"，按 RESPONSIBLE_ID = current 和 DEADLINE = today 筛选。

3. 跨管道移动交易

您说："Передвинь сделку №456 на стадию «В работе»"

AI 代理将调用 bx24_crm_deals，使用 action: "update" 设置 STAGE_ID（阶段可通过 action: "category_list" 列出）。

4. 向聊天发送消息

您说："Напиши в чат «Проект Альфа»: релиз сегодня в 18:00"

AI 代理将调用 bx24_im_chat，使用 action: "sendMessage" （DIALOG_ID = chatNNN，MESSAGE = "…"）。

5. 上传文件并分享链接

您说："Загрузи PDF-договор на Диск в папку «Договоры 2026» и скинь ссылку в чат «Партнёры»"

AI 代理将：bx24_disk → file_upload，然后 file_getExternalLink，然后 bx24_im_chat → sendMessage。

6. 启动审批工作流

您说："Запусти бизнес-процесс «Согласование с юристами» для сделки #456"

AI 代理将调用 bx24_workflows，使用 action: "start"、 templateId 和 documentId = ["crm", "DEAL", 456]。

7. 分析销售漏斗

你说：「制作『销售』漏斗报告：按阶段划分的交易、平均客单价」

AI 代理将调用 bx24_crm_deals action: "list"（按 CATEGORY_ID 过滤）和 bx24_reports action: "funnel_stages"，然后进行聚合。

开发

npm install          # Install dependencies
npm run build        # Compile TypeScript + chmod +x
npm run dev          # Watch mode
npm test             # Run 88 tests (vitest)
npm run test:coverage
npm start            # Run server
docker build -t mcp/bitrix24 .   # Docker image
npm publish          # Publish to npm (auto clean + build + test)

项目结构

mcp_b24/
├── src/
│   ├── index.ts          # MCP server entry point (transport selection)
│   ├── server.ts         # MCP server: register/list/call + instructions
│   ├── config.ts         # Environment configuration (BX24_*)
│   ├── api-client.ts     # HTTP client: webhook/OAuth, refresh, backoff, token-bucket
│   ├── error.ts          # Error handling
│   ├── types.ts          # Shared types
│   ├── i18n/             # ru.ts, en.ts, index.ts
│   ├── audit/log.ts      # JSONL audit of destructive + auth events
│   ├── utils/            # logger, tokenBucket
│   ├── transport.ts      # stdio + Streamable HTTP
│   └── tools/
│       ├── framework.ts  # Data-driven action-tool framework
│       ├── params.ts     # Reusable param schemas
│       ├── index.ts      # Tool registration (41 tools)
│       ├── batch.ts      # bx24_batch
│       ├── call.ts       # bx24_call (escape-hatch)
│       ├── crm/          # 10 CRM tools
│       ├── collab/       # 7 collab tools
│       ├── org/         # 4 org tools
│       └── biz/          # 7 biz tools
├── docs/                 # en/ + ru/ (USER_GUIDE, SELLER_GUIDE, DEVELOPER_GUIDE, TOOLS_REFERENCE, AUDIT_LOG)
├── i18n/README.ru.md     # Russian README
├── specs/openapi.yaml    # OpenAPI overview
├── Dockerfile            # Multi-stage Docker build
├── docker-compose.yml
├── .env.example
├── LICENSE
├── CHANGELOG.md
├── package.json
└── tsconfig.json

许可证

MIT

作者

Penzin Konstantin — GitHub · penzin85@gmail.com

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

2Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Bitrix24 MCP Server
CRM Project Management
OneAtDrt
F
license
Not graded
quality
D
maintenance
Provides a REST API and MCP server to interact with Bitrix24 CRM, enabling CRUD operations on entities like deals, leads, contacts, and tasks via natural language.
Updated a year ago (2025-03-28 13:49 UTC)
10
13
fast-bitrix24-mcp
CRM Research & Data
darkClaw921
F
license
Not graded
quality
C
maintenance
MCP server for interacting with Bitrix24 REST API, enabling CRUD operations on deals, contacts, companies, users, leads, and tasks, plus analytics and risk assessment.
Updated 8 months ago (2025-12-24 18:55 UTC)
2
BitrixMCP
CRM Project Management Calendar Management
john7ross
A
license
B
quality
A
maintenance
Universal MCP server for the Bitrix24 REST API, enabling full read and write access to CRM, tasks, calendar, disk, and more. Supports any MCP client with stdio or Streamable HTTP transport.
Updated 23 days ago (2026-08-02 20:01 UTC)
88
MIT
bitrix24-mcp
CRM Communication Calendar Management
RCS-kz
F
license
Not graded
quality
D
maintenance
Production-grade MCP server for Bitrix24 Cloud with 45 tools, safe by default. Connects Claude Desktop to your Bitrix24 tenant for AI-driven CRM, tasks, messaging, and calendar operations.
Updated 4 months ago (2026-04-30 14:27 UTC)

View all related MCP servers

Related MCP Connectors

better-notion-mcp
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
server
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
postman-mcp-server
A basic MCP server to operate on the Postman API.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kostikpenzin/mcp_b24'

If you have feedback or need assistance with the MCP directory API, please join our Discord server