核心功能
telebiz-mcp 是一款基于 MCP 协议的 Telegram 自动化工具，通过 telebiz-tt 浏览器客户端桥接 Telegram 账号与 AI Agent。核心能力覆盖：
- 会话管理：列出、搜索、归档、置顶、静音群组和私聊
- 消息操作：发送文本（支持 Markdown）、转发、搜索、删除、标记已读
- 批量处理：批量发消息、批量归档、批量添加到文件夹
- 成员管理：查看群成员、添加/移除成员、创建群组
- CRM 集成：与 HubSpot 等系统关联聊天记录（功能不稳定）
显著优点
1. 零 API Token 依赖：通过浏览器会话直接操作，规避 Telegram Bot API 限制，可访问完整用户视角数据
2. 实时双向通信：WebSocket 架构保证消息即时同步
3. 灵活的过滤查询：支持按未读状态、最后发送者、消息时间等多维度筛选会话
4. 完善的监控体系：内置健康检查、状态监控脚本、cron 集成与心跳告警
局限性与风险
| 问题 | 影响 | 应对 |
|------|------|------|
| `batchAddToFolder` 多 chatId 报错 | 批量文件夹操作失效 | 改用循环单条添加 |
| `linkEntityToChat` 不稳定 | CRM 关联可能失败 | 优先在创建时关联，避免单独调用 |
| 严格速率限制 | 20 次/请求、30 次/分钟、500ms 间隔 | 需设计重试与降速逻辑 |
| 浏览器会话依赖 | telebiz-tt 标签页必须保持活跃 | 配合监控脚本及时告警 |
| 破坏性操作无二次确认 | `deleteChat`、`deleteMessages` 直接执行 | 代码层增加确认拦截 |
适合人群
- 销售/客户成功团队：自动化跟进、批量消息触达
- 社区运营者：大规模群组管理、消息归档整理
- 开发者：需将 Telegram 深度集成至内部工作流的工程团队
常规风险
- 会话安全：浏览器持有真实 Telegram 会话，需确保运行环境可信
- 网络暴露：默认端口 9716/9718 仅限本地，外放将直接导致账号风险
- 误操作风险：批量删除/发送无回收机制，测试后需立即清理