ガイド

スマートフォンファームを動かす、 たった 1 つのプロンプトで

本物の Android と iPhone を 1 台の Mac にラックし、ホストを一度ペアリングしたら、BusyBro や MCP クライアントへの自然言語プロンプト 1 つでフリート全体を動かします。スクリーンショット、タップ、サインイン、自動化。何かを変える操作にはすべて確認ゲートがかかります。

かつてスマートフォンファームとは、端末だらけの部屋と、その間を歩き回る人のことでした。Busymate のファームは、電源付き USB ハブを備えた Mac 上のホストデーモンです。接続されたすべての端末を検出し、各画面をブラウザにミラーし、すべての操作をツールとして公開し、自身をダッシュボードの端末としてペアリングするので、フリートはあなた自身の端末の隣にライブの健全性とともに現れます。すべての操作がツールなので、AI アシスタントは 1 文で 1 台でもラック全体でも動かせます。

このガイドは空のハブからその 1 文までを扱います。境界については正直です。生の強力な操作、つまりシェル、任意の入力、ストア外からのアプリインストール、ネットワーク切り替え、再起動は管理者専用で、常に確認を求め、自由入力のアシスタントからは完全に隔離されています。プロンプトが動かすのは安全で厳選された領域で、テストランに必要なことの大半はそこに収まります。

始める前に

必要な もの

接続できるハードウェア、ホストする Mac 1 台、そして所有者となる Busymate アカウント。

  • ホストとなる Mac と、電源付き USB ハブ、データ対応ケーブル。充電専用ケーブルは不可です。

  • USB デバッグを有効にした Android と、デベロッパモードをオンにした iPhone。プラットフォームが要求する端末上の操作はこれだけです。

  • 端末の編集アクセスを持つ Busymate アカウント。ホストとそれがプロビジョニングするすべての端末はその所有者に属します。

  • プロンプトを入力する場所として、ダッシュボードの BusyBro、または前のガイドのとおり MCP で接続した Claude Code。

ステップ・バイ・ステップ

順番どおりに 進める

ラックし、インストールし、フリートが現れるのを見て、オンボードし、エージェントに渡す。

  1. 01

    端末をラックする

    電源付きハブ経由で端末を Mac に接続します。各 Android では USB デバッグをオンにし、ホストから求められたら「USB デバッグを許可」をタップします。Android に必要な設定はそれだけです。各 iPhone ではデベロッパモードを有効にし、求められたらホストを信頼します。Apple が要求する一度きりの 2 タップです。iOS 側のそれ以外はすべてデーモンがプロビジョニングします。

  2. 02

    デーモンをインストールし、サインインして起動する

    1 行でファームホストをインストールできます。ホストがペアリングできるようブラウザで一度サインインし(デーモンはサインインなしでは起動を拒否するので、所有者のいないファームが誤って動くことはありません)、ログインと再起動で自動的に立ち上がるよう自動起動付きで起動します。ステータスコマンドは動作中のビルド、オンラインの端末数、ホストがペアリング済みかを表示します。

    ホストはディスク上に保持する長期の資格情報で自身を Busymate 端末としてペアリングするので、あなたのセッションは二度と必要ありません。各端末はその配下の子端末となり、USB の再接続後も変わらない安定した ID を持ち、あなたの所有権を引き継ぎます。

    インストール、ペアリング、起動、確認
    bash
    curl -fsSL https://farm.busymate.net/install.sh | bash   # macOS / Linux
    bmfarm login                 # sign in once in the browser so the host can pair
    bmfarm start --autostart     # start the background daemon; relaunches at login
    bmfarm status                # running build, phones online / total, pairing state
  3. 03

    ダッシュボードにフリートが現れるのを見る

    ダッシュボードで Phone Farm ビューを開きます。サイドバーには Daemon の項目(マシンごとのコントロールパネルと、ホストからストリームされるライブログを備えたファーム全体のペイン)と、ファームのマシンごとの項目があり、後者はその Mac の Android と iOS の端末を開きます。各端末には機種、OS バージョン、バッテリー、状態と、ライブミラーが表示されます。画面は動画としてストリームされ、ブラウザでハードウェアデコードされ、タップ、スワイプ、キー入力は物理端末まで往復します。デーモン再起動後の復旧はハートビート駆動なので、更新する必要はありません。

  4. 04

    1 つの操作で全端末をオンボードする

    各端末には最新に保つべきコンポーネントがいくつかあります。端末上の制御ランナー、証明書の信頼、キャプチャ用の Busymate DevTools アプリなどです。ラックを歩き回る代わりに、ホストカードの Onboard all phones 操作がフリート全体の巡回を代行し、端末ごとに分離されているので 1 台のインストール失敗が巡回全体を止めることはありません。ダッシュボードはコンポーネント別のライブグリッドを描画します。セルはデーモンがインストール済みバージョンを確認して初めて緑になり、すでに最新のコンポーネントは薄色のスキップ、人手が必要なもの(Apple ID のプロンプト、有料アプリ)は偽装せずフラグが立ちます。

  5. 05

    エージェントを接続する

    同じツールへ通じる扉が 2 つあります。BusyBro はダッシュボードとスタンドアロンの BusyBro アプリに組み込まれ、すでにあなたとしてサインイン済みです。Claude Code、あるいは任意の MCP クライアントは、前のガイドのとおりコマンド 1 つとブラウザでのサインインで同じサーバーに接続します。どちらでもアシスタントはあなたとして動作します。すべてのファームツールはあなた自身のファーム端末に限定され、ホストのリモート操作オプトインに縛られ、ロールの権限に照らして検査されます。

  6. 06

    その 1 つのプロンプトを書く

    フリート全体でやりたいことを自然な言葉で伝えます。アシスタントはオンラインの端末を列挙し、各端末のスクリーンショットを撮り、アプリを開き、画面の UI 階層を読んで必要な要素を見つけてタップし、サインイン情報を入力し、端末ごとに報告します。ファームコンソールで設定した変数(テストアカウント、クーポンコード)は名前で自動化から参照できるので、プロンプトにパスワードを含める必要はありません。

    端末を変更するものはすべて、実行されようとしている内容の完全なペイロード付きの確認カードを先に表示して待機します。スクリーンショットや UI ダンプに確認は不要ですが、タップ、公開ストアからのインストール、自動化の実行には必要です。生のシェル、生の ADB、任意の入力、プロキシと機内モードの切り替え、再起動は管理者専用の強力な操作で、自由入力のアシスタントからはまったく届きません。それらはダッシュボードと MCP ツールの中で、明示的な確認の先に留まります。

    プロンプト 1 つ、ラック全体
    text
    On every online farm phone: take a screenshot, open the checkout app, sign in with the test-account variables, and tell me which phones show the new "Pay in 3" button. Flag any phone whose screen is black.
  7. 07

    繰り返し実行させ、端末が送るものをキャプチャする

    自動化はホスト上の普通の JavaScript ファイルで、インストール、起動、検索とタップ、入力、スクリーンショットといった端末 API と、それらを間隔実行するスケジューラを備えます。アシスタントにスケジュールを頼めば、端末ごとの結果を持つ夜間ジョブになります。ファーム端末の通信は共有プロキシを経由してあなた自身の端末と同じフィードに流れるので、実行時のネットワーク活動は他のキャプチャ同様に検査、モック、エクスポートできます。Android のファーム端末は証明書がシステムストアに置かれる root 済み階層で動作し、ピン留めするアプリ以外のすべてを復号します。

    フリートの健全性もツールです。どの端末に注意が必要か尋ねれば、アシスタントはダッシュボードが表示するのと同じハートビートを読み、自己修復の巡回を起動できます。これも確認の先にあります。

    実行を夜間ジョブに変える
    text
    Run the login-smoke automation on all Android farm phones every night at 02:00 and message me only if a phone fails.

トラブルシューティング

うまくいかない ときは

ファームの問題はほぼ必ず、ケーブルか、端末上のタップか、ゲートが正しく働いているかのどれかです。

  • 端末がフリートに現れない

    十中八九、充電専用ケーブルか、Android の「USB デバッグを許可」プロンプトが未応答です。ケーブルを交換し、端末のロックを解除してプロンプトを承認してください。iOS ではデベロッパモードがオンでホストが信頼済みか確認します。

  • デーモンが起動を拒否する

    ホストに所有者がいるまで即座に失敗します。ログインコマンドを実行してサインインし、再度起動してください。ステータスコマンドがペアリングを確認します。

  • ミラーのタイルが真っ黒

    端末がロック中、画面がオフ、または制御ランナーがまだ準備できていません。端末を起こしてください。黒いままなら、その端末に対してオンボード操作を実行し、コンポーネントを実際の証拠で再検査させます。

  • アシスタントがシェルコマンドを実行できないと言う

    正しく、意図どおりです。生のシェル、生の ADB、その他の強力な操作は管理者専用で、自由入力のアシスタントには禁止されています。明示的な確認ゲートが適用されるダッシュボードのコンソールか MCP ツールを直接使ってください。

  • 見えている端末への操作が拒否された

    ファーム操作は自分のファーム端末に限定され、ホストのリモート操作オプトインと、ロールの端末編集アクセスが必要です。ホストの設定でオプトインを、そしてロールの権限を確認してください。

よくある質問

よくある 質問

これはクラウド端末やエミュレータですか?

どちらでもありません。あなたが管理するマシンに接続されたハブ上の物理端末です。自分でラックする代わりにマネージドフリートを借りることもできます。料金ページで説明しています。

アシスタントが本当に端末を壊すことはありますか?

破壊的な領域は管理者専用で確認ゲート付き、自由入力プロンプトからは遮断されています。プロンプトができること、つまりスクリーンショット、タップ、アプリ起動、ストアからのインストール、自動化は、必ず実行前に正確な操作をプレビューします。

ファーム端末で通信キャプチャは動きますか?

はい。ファーム端末は共有プロキシを経由して他の端末と同じダッシュボードフィードに流れ、root 済みの Android ファーム端末は証明書ピン留めを除きシステム全体を復号します。

本物の端末が並ぶラックが、 あと一文で動く

接続し、ホストをペアリングし、アシスタントにフリートを動かさせましょう。変更はすべてあなたが承認します。

Ask your mate