Bitrix24 MCP Server 是一个 Model Context Protocol（MCP）服务器，通过入站 Webhook（incoming webhook）将 Claude 连接到你的 Bitrix24 门户。配置完成后，Claude 可以在自然对话中读写 CRM 记录、管理任务、浏览磁盘、发送通知、查询产品目录、运行业务流程等。项目由 Bit2Beat（Bitrix24 专家团队）构建与维护。
使用前准备
使用本服务器需要满足以下条件：Node.js 18 或更高版本；Claude Desktop 或 Claude Code；一个 Bitrix24 入站 Webhook URL。
安装与配置
- 克隆仓库（git clone）。2. 安装依赖（npm install）。3. 创建 Bitrix24 Webhook：需要管理员权限，只有 Bitrix24 门户管理员可以创建入站 Webhook，这是平台安全限制——Webhook 相当于系统级凭据，可能携带比普通用户会话更广泛的权限。以管理员身份登录 Bitrix24 门户，进入左侧边栏的“应用（Applications）”→“Webhook”，点击“入站 Webhook（Incoming webhooks）”→“添加 Webhook”，为其设置描述性名称（例如 Claude MCP），在“权限（Permissions）”下启用所需作用域（见下方访问配置文件），复制生成的 URL，格式类似：https://your-portal.bitrix24.com/rest/1/abc123xyz/ 。该 URL 即 B24_DEFAULT_WEBHOOK，请保持私密——它授予对门户的 API 访问权限。如需在初始设置后编辑 Webhook 或添加更多作用域：应用 → Webhook → 入站 Webhook → 点击 Webhook 名称。
- 配置 Claude Desktop：打开 Claude Desktop 配置文件，在 "mcpServers" 内添加相应条目。Windows 注意：路径中使用正斜杠（/）或转义反斜杠（\）。
- 重启 Claude Desktop：保存配置文件后重启 Claude Desktop，你应该能在工具面板中看到 Bitrix24 工具。
访问配置文件（Access Profiles）
Bitrix24 Webhook 使用作用域（scopes）控制可访问的模块。每个作用域解锁一组 API 方法——但在作用域内部，所有操作（读和写）都被允许，作用域层面没有内置的“只读”标志。限制 Claude 可执行操作的实际方法，是组合正确的作用域集合。以下三种现成配置覆盖最常见的用途：
配置文件 1 — 结构检查器（不访问业务数据）：当你希望 Claude 理解门户配置（管道、阶段、自定义字段、自动化），但不访问任何实际记录（无交易、联系人、任务）时使用。适合：审计门户设置的顾问，或在构建集成前梳理 CRM 的开发者。可做：b24_read_full_config、b24_read_pipelines、b24_read_custom_fields、b24_read_entity_types、b24_read_automations、b24_read_product_catalog、b24_compare_configs、b24_users_list、b24_departments_list。不可做：读取或写入交易、联系人、任务、磁盘文件、聊天或日历。注意：管道和自定义字段数据内部通过 crm 模块访问。如果你还想检查 CRM 结构（阶段、字段名），可将 crm 加入此配置——但需注意这也会启用对 CRM 记录的读取访问。
配置文件 2 — 只读操作：当你希望 Claude 读取业务数据但不创建或修改任何内容时使用。适合：报表、分析、回答关于管道状态或任务进度的问题。重要提醒：Bitrix24 作用域在 API 层面不区分读和写。crm 作用域同时启用 crm.deal.list（读）和 crm.deal.add（写）。仅靠作用域无法强制只读访问。要实现真正的只读配置文件有两种方式：基于信任：仅启用下方作用域并指示 Claude 不要修改数据，Claude 会遵循指示，但没有技术强制。基于强制：运行一个仅注册读取工具的独立 MCP 服务器实例，这需要少量代码改动，已规划为未来功能（B24_PROFILE=readonly）。
配置文件 3 — 完全访问：当你希望 Claude 作为完整的 Bitrix24 助手——读取、写入、发送消息、管理文件以及一切操作时使用。当请求的操作需要 Webhook 未启用的作用域时，Claude 会优雅地报告，因此你可以始终从较少作用域开始，之后再添加更多。
可用工具
连接与基础：b24_test_connection（验证 Webhook 并确认门户信息和用户权限）。 CRM：b24_crm_list（带过滤和自动分页的 CRM 记录列表）、b24_crm_get（按 ID 获取单条 CRM 记录）、b24_crm_create（创建 CRM 记录）、b24_crm_update（更新 CRM 记录）、b24_crm_delete（删除 CRM 记录）、b24_crm_fields（列出实体的所有可用字段，含标准与自定义）、b24_crm_timeline_add（向 CRM 记录的时间线添加评论或活动）。 任务：b24_tasks_list（带过滤的任务列表）、b24_tasks_get（获取完整任务详情）、b24_tasks_create（创建任务）、b24_tasks_update（更新任务）、b24_tasks_complete（将任务标记为完成）。 用户与部门：b24_users_list（列出活跃用户）、b24_departments_list（列出带层级的部门）。 磁盘：b24_disk_storages（列出可用存储）、b24_disk_folder_list（浏览文件夹内容）、b24_disk_file_get（获取文件信息和下载 URL）、b24_disk_file_upload（上传文件到文件夹）。 日历：b24_calendar_list（列出日历事件）、b24_calendar_create（创建日历事件）。 沟通与协作：b24_chat_send（发送私聊或群聊消息）、b24_notify_send（发送个人通知）、b24_feed_post（发布到实时动态）、b24_groups_list（列出工作组和项目）。 业务流程：b24_bizproc_list（列出活动工作流实例）、b24_bizproc_start（在记录上启动业务流程）。 电话：b24_telephony_calls（查询通话历史日志）。 产品目录：b24_products_list（列出目录产品）、b24_products_get（获取产品详情）、b24_products_create（创建产品）、b24_products_update（更新产品）、b24_products_sections（列出目录分区）。 配置管理：b24_read_full_config（将完整门户配置导出为 JSON）、b24_read_entity_types（读取 CRM 和 SPA 实体类型）、b24_read_pipelines（读取管道及其阶段）、b24_read_custom_fields（读取所有 CRM 实体的自定义字段）、b24_read_automations（按阶段读取自动化规则）、b24_read_product_catalog（读取产品目录结构）、b24_compare_configs（比较两个门户配置 JSON 文件）、b24_apply_config（将导出的配置应用到目标门户）、b24_save_user_mapping（生成两个门户之间的用户 ID 映射）。 通用调用：b24_call（直接调用任意 Bitrix24 REST API 方法）、b24_batch（在单个 HTTP 请求中执行多个 API 调用）。
使用示例
配置完成后，你可以向 Claude 提问，例如：“显示分配给 María 的所有未关闭交易”“为 Tadeo 创建一项周五前审阅合同的任务”“本周来自公司 X 的来电有哪些？”“将此门户的完整 CRM 配置导出为 JSON”“将此门户的管道配置与 config_backup.json 中的配置进行比较”。
速率限制与重试
HTTP 客户端在请求之间强制执行至少 500 毫秒延迟以遵守 Bitrix24 的速率限制，并在遇到 429 Too Many Requests 和超时错误时自动重试（最多 3 次重试，采用指数退避）。
配置迁移
本服务器包含供需要在多个实例间复制门户配置的 Bitrix24 顾问和合作伙伴使用的工具：用 b24_read_full_config 导出源门户配置；用 b24_compare_configs 与目标比较；用 b24_apply_config 将其应用到目标。此工作流覆盖管道、阶段、自定义字段、货币、SPA 类型、自动化和产品目录。
贡献与支持
欢迎贡献，请先开 issue 讨论你想更改的内容。流程：Fork 仓库；创建功能分支（git checkout -b feature/your-feature）；提交更改；打开 pull request。Bit2Beat 是一家 Bitrix24 专业公司，在 Bitrix24 平台上构建集成、自动化和 AI 驱动工具。如需帮助实施本 MCP 服务器或构建自定义 Bitrix24 集成，可发送邮件至 info@bit2beat.com 。
限制
仅资料中明确提到的限制：Bitrix24 作用域在 API 层面不区分读和写，作用域本身无法强制只读；真正的只读需要通过仅注册读取工具的独立实例实现，该功能（B24_PROFILE=readonly）尚在规划中。关于收费、价格、平台支持范围等其他信息，资料暂未提供。