用途
BotBell MCP Server 用于让 AI 助手（如 Claude、Cursor 等）向用户的 iPhone、iPad 和 Mac 发送推送通知。配置完成后，AI 助手可以将任务结果、警报、提醒推送到用户手机，读取用户在 BotBell 应用中的回复并继续处理，以及管理机器人（仅 PAT 模式）。
主要能力
- 发送通知：将任务结果、警报、提醒推送到手机。
- 读取回复：用户在 BotBell 应用中回复，AI 读取后继续处理。
- 管理机器人：列出、创建机器人（仅 PAT 模式）。
- 支持操作按钮：在通知中添加交互按钮，用户点击即可回复，无需输入。当用户点击操作时，botbell_get_replies 会返回操作键和消息内容。
- 支持 Markdown。
- 支持多机器人管理：可通过 BOTBELL_EXTRA_TOKENS 环境变量配置额外的 Bot Token，格式为 alias1:bt_token1,alias2:bt_token2。配置额外令牌后，botbell_send 和 botbell_get_replies 可使用 alias 参数，通过特定额外令牌路由消息；PAT 模式下 botbell_list_bots 会显示额外机器人；未指定 alias 时默认使用主令牌 BOTBELL_TOKEN。
使用方式
认证模式
支持两种令牌类型，通过前缀自动检测：
- Bot Token：在 BotBell 应用中创建机器人时获取，一个令牌对应一个机器人。
- PAT：在 BotBell 应用 > Settings > API Keys 中创建，一个令牌控制所有机器人。
安装步骤
- 安装 BotBell 应用：从 App Store 下载，创建机器人并获取令牌。
- 安装 MCP Server。
- 配置 Claude Desktop：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，可选择 PAT 模式（推荐）或 Bot Token 模式。
可用工具
PAT 模式（pak_ 令牌）：
- 列出所有机器人，用于在发送前查找 bot_id。
- 创建新机器人。
- 通过特定机器人发送推送通知。
- 检查特定机器人的用户回复。
Bot Token 模式（bt_ 令牌）：
- 发送推送通知。
- 从 BotBell 应用获取用户回复。
其他 MCP 客户端
对于 Cursor 或其他 MCP 客户端，将相应配置添加到 MCP 配置中。
示例用法
- “发送通知到我的手机，说构建已完成”
- “分析这个日志文件并将摘要推送到我的手机”
- “检查我在 BotBell 中是否有任何回复”
- “列出我的机器人”（PAT 模式）
- “创建一个名为 Deploy Alerts 的新机器人”（PAT 模式）
轻量替代方案
如果不需要 MCP，可以使用：
- SDK：直接从代码调用 REST API。Python：pip install botbell；JavaScript：npm install @botbell/sdk。
- Agent Skill：一条命令安装，零依赖，适用于 30 多种 AI 工具。
适用场景
适用于需要将 AI 助手与移动设备通知联动的场景，例如接收任务完成提醒、日志分析摘要推送、通过通知按钮快速回复等。
限制
资料中未提供关于收费、价格、平台兼容性、效果或具体使用步骤的更多细节。
