BetaDrop

@betadrop/mcp

「このビルドを公開して、インストールリンクを送って。」 AI アシスタントにそう伝えれば、30秒後にはテスターがアプリをインストールできます。

BetaDrop は、iOS の .ipa または Android の .apk をOTAインストールリンクで配布します。テスターはスマートフォンでリンクを開き、ブラウザーから直接インストールできます。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コマンド1つ。ビルド手順なし。 アシスタントはすでに使い方を理解しているので、ツール名を入力する必要はありません。

⚡ クイックスタート（3ステップ）

ステップ1 — BetaDrop APIトークンを取得する

1. betadrop.app で登録するか、ログインします
2. 設定 → 開発者 に移動します
3. APIトークン の下にある トークンを作成 をクリックし、名前（例："My IDE"）を付けて、トークンをコピーします
   (先頭は bd_live_... です。安全な場所に保存してください。一度しか表示されません！)

Step 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"]
    }
  }
}

Step 3 — 初回セットアップ

MCP サーバーを追加したら、BetaDrop API トークンで認証します。AI アシスタントを開き、次のように入力してください。

"Log me in to BetaDrop with token bd_live_xxxxxxxx"

資格情報は、$XDG_CONFIG_HOME/betadrop/config.json が設定されている場合はその場所に、そうでない場合は ~/.betadrop/config.json に、0600 権限（所有者のみ読み取り可能）で保存されます。ログアウトすると、トークンはサーバー上で失効し、設定ファイルは削除されます。

✅ 準備完了です！ それでは、以下のプロンプトを試してみましょう 👇

🚀 これらのプロンプトを試す

ツール名を覚える必要はありません。AI アシスタントに自然な言葉で話しかけるだけです。

📦 ビルドの公開

📋 ビルド履歴

🔑 トークン管理

✅ リリースの確認、リンク、デバイス

👤 アカウント

🔁 1 回のやり取りで連続実行

これらはチャットボットではなくツールなので、アシスタントは複数のツールを連続して実行できます。

"リリース APK をビルドして、最後のコミットメッセージをノートとして BetaDrop に公開し、インストールリンクを教えてください。"

ビルドはターミナルで実行され、betadrop_publish が成果物をアップロードし、同じ返信でリンクが返されます。

📖 利用可能なすべてのツール

8 つの分野にわたる 23 個のツールがあります。ツール名を指定して呼び出す必要はありません。アシスタントが選択します。

認証

ビルドの公開

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 サーバーにこれらを設定するには、ステップ 2 のエディター設定で、command と args の隣に env ブロックを追加します。

{
  "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 に次のように依頼してください："bd_live_... トークンで BetaDrop にログインして"
• または、MCP 設定で環境変数 BETADROP_TOKEN を設定してください。設定を参照してください

アップロードが止まっているように見えますか？

• 90 秒以上かかるビルドは、ツール呼び出しがタイムアウトしないよう、バックグラウンドでアップロードを続けます
• アシスタントにアップロード状況の確認を依頼してください（betadrop_upload_status が呼び出されます）。アップロードが完了すると、インストールリンクが返されます
• ~/.betadrop/upload_status.json を直接確認することもできます

トークンの有効期限が切れた、または取り消されましたか？

• betadrop.app → Settings → Developer → API tokens で新しいトークンを作成してください
• 新しいトークンで再度ログインしてください

iOS ビルドをスマートフォンにダウンロードしても開けませんか？

• アドホック .ipa をインストールできるのは、署名時にプロビジョニングプロファイルに含まれていたデバイスだけです。公開しても条件は変わりません。テスターにUDID チェッカーを送信し、Apple Developer ポータルでデバイスを追加して、再署名してください。

BetaDrop が提供するその他のツール

同じ公開手順を、ほかの 2 つの方法でも利用できます。アカウントと 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