bitrix24-mcp 是一个面向 AI 助手的 MCP 服务器，用于把 Claude、Cursor 等 AI 助手连接到 Bitrix24 CRM。它通过入站 Webhook 接入，无需在 Bitrix24 应用市场创建应用，也无需 OAuth 授权，配置过程较快。
主要能力
- 数据操作：搜索、读取和编辑交易、线索、联系人、任务，以及时间线评论。可以创建带联系人的交易，按电话或邮箱查找联系人（含重复项搜索）。
- 销售分析：提供漏斗报告，包含各阶段汇总、赢单率、平均销售周期和经理排行榜；识别无活动且无未完成任务的停滞交易；按员工列出逾期任务。
- 交互示例：可以询问“九月销售情况如何？哪位经理成交更好？”“哪些交易停滞超过一周，金额多少？”“今天经理们有哪些逾期事项？”“查找客户 +7 900 123-45-67 并帮我准备通话”“在‘项目’漏斗中创建一笔 90,000 的‘咖啡馆网站’交易，联系人 Ivan，电话 +7 900…，并给 Anna 安排明天回电的任务”。
- 写操作确认：涉及修改门户数据的操作会先展示将要写入的内容，并需要用户确认。
使用方式
- 在 Bitrix24 中进入“开发者资源 → 其他 → 入站 Webhook”，勾选 CRM（crm）、任务（task）和用户（user）权限，保存。
- 复制 Webhook 地址，格式类似 https://你的门户.bitrix24.ru/rest/1/abc123xyz/，将其设置为环境变量 BITRIX24_WEBHOOK_URL。
- 需要 Node.js 18+。
- 在 Cursor、Windsurf 等客户端中，使用 npx 命令，参数为 -y github:penmadebykisss/bitrix24-mcp，并配置 BITRIX24_WEBHOOK_URL 环境变量。
适用场景
- 销售团队快速查询销售进展、经理业绩和漏斗转化。
- 管理者自动获取停滞交易、逾期任务等需要人工汇总的销售运营信息。
- 通过 AI 助手在对话中创建或更新 CRM 记录，减少手动操作。
限制与注意事项
- Webhook 以创建它的员工身份运行，可见范围与该员工一致，应像密码一样保管 Webhook 地址。
- Webhook 的 REST API 限制约为每秒 2 个请求；服务器会自动控制间隔，并在遇到 QUERY_LIMIT_EXCEEDED 时重试。
- 漏斗报告单次最多统计 2000 笔交易；停滞交易搜索最多扫描 1000 笔未关闭交易。
- 支持本地部署版 Bitrix24，Webhook 地址位于自有域名。
- 官方资料还提到可提供付费的部署与定制服务，但未提供具体价格、收费方式或服务范围细节。
