BetaDrop

@betadrop/mcp

“发布这个构建版本，并把安装链接发给我。” 对你的 AI 助手这样说，测试人员 30 秒后就能开始安装应用。

BetaDrop 可为 iOS .ipa 或 Android .apk 创建无线安装链接：测试人员在手机上打开链接，就能直接通过浏览器安装——无需等待 TestFlight 审核，无需 Play 测试轨道，也无需测试人员账号。如果你用过 Diawi 或 Firebase App Distribution，它的作用与它们相同。

BetaDrop MCP 将这一步交给 AI 助手处理。Claude、Cursor、Copilot、Windsurf、Zed 和 Antigravity 可以通过普通提示词发布构建版本、检查其是否能够安装、管理长期有效的链接、设备和 Webhook，并读取测试人员的反馈——无需打开浏览器标签页、无需使用命令行，也无需离开编辑器。

claude mcp add betadrop -s user -- npx -y @betadrop/mcp

23 个工具。一个 npx 命令。无需构建。 你的助手已经知道如何使用它们——你无需输入工具名称。

⚡ 快速开始（3 步）

第 1 步 — 获取 BetaDrop API Token

1. 在 betadrop.app 注册或登录
2. 前往 Settings → Developer
3. 在 API tokens 下，点击 Create token，为其命名（例如 "My IDE"），然后复制 Token
   (它以 bd_live_... 开头——请妥善保存，因为它只会显示一次！)

步骤 2 — 将 MCP 服务添加到编辑器

提示

🤖 AI 原生安装（最简单） 既然你已经在使用 AI 助手（例如 Cursor Composer、Claude、Copilot 或 Antigravity），就不必手动编辑配置文件！只需将以下任一提示词直接粘贴到 AI 聊天中：

• Cursor："Add the @betadrop/mcp server to my global Cursor mcp.json config"
• Antigravity："Add the @betadrop/mcp server to my Antigravity mcp_config.json"
• VS Code（Copilot）："Add the @betadrop/mcp server to my workspace .vscode/mcp.json"
• Claude Desktop："Add the @betadrop/mcp server to my Claude Desktop config"

AI 会自动为你定位、创建或更新配置文件。完成后，只需刷新或重启编辑器。

否则，请从下方选择你的编辑器并手动配置。

claude mcp add betadrop -s user -- npx -y @betadrop/mcp

claude mcp list

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"]
    }
  }
}

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"]
    }
  }
}

{
  "servers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"]
    }
  }
}

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"]
    }
  }
}

{
  "context_servers": {
    "betadrop": {
      "command": {
        "path": "npx",
        "args": ["-y", "@betadrop/mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"]
    }
  }
}

步骤 3 — 首次设置

添加 MCP 服务后，使用你的 BetaDrop API 令牌进行身份验证。打开 AI 助手并输入：

"Log me in to BetaDrop with token bd_live_xxxxxxxx"

如果设置了 $XDG_CONFIG_HOME，凭据会保存到 $XDG_CONFIG_HOME/betadrop/config.json；否则保存到 ~/.betadrop/config.json，权限为 0600（仅所有者可读）。登出时，服务器会撤销该令牌，并删除配置文件。

✅ 全部设置完成！ 现在试试以下任意提示词 👇

🚀 试试这些提示词

无需记住任何工具名称，只需自然地与 AI 助手对话：

📦 发布构建

📋 构建历史

🔑 令牌管理

✅ 发布检查、链接和设备

👤 账户

🔁 一轮中连续执行

这些是工具，不是聊天机器人，因此助手可以将它们串联起来：

"Build the release APK, publish it to BetaDrop with the last commit message as the notes, and give me the install link."

构建会在你的终端中运行，betadrop_publish 会上传构建产物，并在同一条回复中返回链接。

📖 所有可用工具

八个类别中共有二十三种工具。你无需按名称调用它们，助手会自行选择。

身份验证

发布构建版本

betadrop_publish 参数：

过期设置受计划限制。 none — 永久链接 — 是付费计划功能；若计划不支持此功能，构建版本会以带日期的链接存储，而不会被拒绝。所有计划的 expiryTimeDays 都会被限制在该计划的最大构建版本保留期限内。发生上述任一情况时，服务端会返回一个 retentionClamp 对象（requestedDays、appliedDays、maxDays、permanentDenied、message），工具结果会附加一行 ⚠️ 说明实际应用的设置。请注意，只有计划实际缩短了你要求的期限时才会报告此信息：如果未发送 expiryTimeDays，即使账户默认值被缩短，该值仍为 null。各计划当前的天数上限见 src/lib/limits.json，此处不再重复列出。

上传方式： 文件会先在本地验证（检查 ZIP 魔数），然后上传；上传进度会以 5% 为间隔持续通知你的 AI 客户端。安装链接会在工具结果中返回。上传耗时超过 90 秒的构建版本会在后台继续上传，因此工具调用不会超时 — 随后助手会调用 betadrop_upload_status 获取链接。~/.betadrop/upload_status.json 中的状态文件会实时跟踪上传进度。

构建历史

betadrop_list_builds 参数：

betadrop_list_expired_builds 参数：

每条结果都包含构建名称、版本、平台、文件大小、状态、日期和可分享的安装链接。

令牌管理

betadrop_token_create 参数：

每个端点都会强制执行权限：read 令牌可以列出构建版本、读取反馈并运行 betadrop_inspect，但不能发布、删除或更改链接、设备或 Webhook。

⚠️ 创建时明文令牌只显示一次。请立即复制！

发布检查

固定链接

betadrop_publish 也接受 standingLink 参数，可在新构建版本上线时将固定链接指向该版本。

构建版本、反馈和设备

Webhook

快速帮助

⚙️ 配置

设置以下环境变量以覆盖默认值：

如需为 MCP 服务设置这些变量，请在编辑器配置中与 command 和 args 同级添加 env 块，配置位置见步骤 2：

{
  "mcpServers": {
    "betadrop": {
      "command": "npx",
      "args": ["-y", "@betadrop/mcp"],
      "env": { "BETADROP_TOKEN": "bd_live_xxx" }
    }
  }
}

设置 BETADROP_TOKEN 后，无需登录 — 服务会直接使用该令牌：

BETADROP_TOKEN=bd_live_xxx betadrop-mcp

❓ 故障排查

“未找到工具”或没有显示 BetaDrop 工具？

• 确保已安装 Node.js 18+：node --version
• 添加 MCP 配置后重启编辑器
• 在 Claude Code 中运行 /mcp，检查服务状态
• 在 Cursor 中，前往 Settings → MCP 并点击 Refresh

提示“您尚未登录”？

• 让 AI 帮你登录 BetaDrop："Log me in to BetaDrop with token bd_live_..."
• 或在 MCP 配置中设置 BETADROP_TOKEN 环境变量——请参阅配置

上传似乎卡住了？

• 耗时超过 90 秒的构建会在后台继续上传，因此工具调用不会超时
• 让助手检查上传状态（它会调用 betadrop_upload_status）——上传完成后会返回安装链接
• 你也可以直接查看 ~/.betadrop/upload_status.json

令牌已过期或被撤销？

• 在 betadrop.app → Settings → Developer → API tokens 创建新令牌
• 使用新令牌重新登录

iOS 构建已下载到手机上，但无法打开？

• Ad-hoc .ipa 只能安装在签名时已包含在配置描述文件中的设备上——发布它不会改变这一点。将 UDID checker 发给测试人员，在 Apple Developer 门户中添加设备，然后重新签名。

BetaDrop 的其他工具

同一个发布步骤，也适用于另外两个平台——一个账户，一套 API 令牌：

📚 链接

• BetaDrop — 构建分发平台
• Model Context Protocol — 为此集成提供支持的开放标准
• 报告问题

要求

• Node.js 18+
• 一个 BetaDrop 账户——免费套餐无需绑定银行卡。各套餐的保留期限和 文件大小上限请参阅定价页面。
• 以下受支持的 AI 编辑器之一（Claude、Cursor、VS Code、Windsurf、Zed、Antigravity）

贡献

问题反馈和拉取请求：https://github.com/betadrop-app/betadrop-mcp。如果它帮你省去了 打开浏览器的麻烦，点个 ⭐ 能帮助其他移动团队发现它。

许可证

MIT