ブログ
Claude CodeからMCPでクラウドスマホを操作する

AIエージェントに本物のAndroidスマホを見せて操作させる。一行のインストールとブラウザでのサインインから最初の指示まで手順を解説します。
CloudPhone GoをGoogleの優先ソースに追加すると、ゲーム攻略や放置設定を検索したときに新しい記事が表示されやすくなります。ワンタップで追加、いつでも解除できます。
Claude CodeからMCPでクラウドスマホを本当に操作できる?
できます。CloudPhone Goは公式MCPサーバーを提供しており、Claude Codeにコマンドを一行貼り、初回にブラウザでログインするだけで、AIが本物のAndroidスマホのスクリーンショット、タップ、スワイプ、文字入力、APKインストール、GPS移動、ガイド実行まで行えます。設定は数分、手元に必要なのはNode 18以上だけです。
録画マクロは決まった座標を再生するだけなので、画面が変わると誤タップします。AIエージェントは毎回スクリーンショットを見てから次の行動を決めるため、ポップアップやお知らせにも対応しやすくなります。
放置やデイリー周回、開発中アプリのテストをAIに任せたい人には、眠らない手が一本増えるようなものです。端末は台湾のデータセンターで24時間動き続け、PCを閉じても止まりません。
MCPとは?なぜスマホ操作に向いているのか
MCP(Model Context Protocol)は、AIツールが外部の機能を呼び出すためのオープン標準です。AI用の拡張スロットのようなもので、MCPサーバーをつなげばClaude Code、Claude Desktop、Codex、Cursorなどがそのツールを使えるようになります。
スマホ操作は「見る、判断する、操作する」の繰り返しで、スクリーンショット、ピクセル色、タップのツールにそのまま対応します。AIは人と同じように画面を見て操作するだけです。
CloudPhone GoのMCP接続は中継サーバーを通らないP2P直結です。指示はPCから台湾の実機へ直接届くため、ブラウザで操作するときと近い応答性になります(実際の速さは回線によって変わります)。
始める前に何を用意すればいい?
準備するものは多くありませんが、一つ欠けると止まります。まずは表で確認してください。
| 項目 | 必要なもの | 補足 |
|---|---|---|
| CloudPhone Go端末 | いずれかのプラン | 月払い・年払いどちらでも、更新はいつでも停止可 |
| OS | Windows、macOS、Linux | いずれも対応 |
| Node.js | 18以上 | ターミナルで node -v を実行して確認 |
| AIツール | Claude Code、Claude Desktop、Codex、Cursor | ご自身のアカウントを使用 |
| ネットワーク | WebRTCの直接接続ができること | 厳しい社内VPNやファイアウォールではブロックされることがあります |
社内ネットワークで使う場合は、まずテザリングや自宅回線で一度試すと、ファイアウォールが原因か切り分けられます。
Claude Codeにつなぐ手順(クイック接続)
Claude Codeを例に、ゼロから最初の指示までの流れです。おすすめは「クイック接続」で、トークンを発行したりコピーしたりする必要はなく、初回にブラウザでログインするだけです。
- ターミナルで claude mcp add cloudphone -- npx -y @zerohuman-ai/poc-mcp@latest を実行します。このコマンドはCloudPhone Go(app.cloudphonego.com)の端末メニュー ⋯ →「AI / MCP」、または「マイページ → 開発者」の「クイック接続(おすすめ)」からもコピーできます。
- Claude Codeで「クラウドスマホのスクリーンショットを撮って画面を説明して」と頼みます。
- 最初の呼び出しで、AIが https://app.cloudphonego.com/mcp-link?code=BCDF-GHJK のようなログイン用リンクを返します。PCにブラウザがあれば自動で開きます。
- CloudPhone Goアカウントでログインし、「リクエスト元」が自分のPC名で、「コード」がAIに表示されたものと同じことを確認してから「許可」を押します。心当たりがなければ「拒否」を押してください。
- Claude Codeに戻ってもう一度試すよう伝えると、接続されてスクリーンショットが撮れます。
以降、このPCはログインしたままになります(ユーザーの設定フォルダに保存)。ログインの有効期間は90日で、切れたときは自動で再ログインを求められます。「AI / MCP」画面のトークン一覧にも表示され、いつでも取り消せます。ターミナルで済ませたい場合は npx -y @zerohuman-ai/poc-mcp@latest login でログインでき、login を logout に変えればログアウトです。
コマンドの @latest により、npx は起動のたびに新しいバージョンを確認します。AIツールを再起動するだけで最新版が使えます。
最初の呼び出しはパッケージのダウンロードとP2P接続の確立があるため、40秒ほどかかることがあります。2回目以降は速くなります。
詳細:トークンで接続するのはどんなとき?
「AI / MCP」画面の下にある「詳細:トークンで接続」を開くと、トークンを自分で発行できます。CI、ブラウザのないサーバー、特定の端末だけ・読み取り専用に制限したい場合に向いています。手順は次のとおりです。
- CloudPhone Goの「AI / MCP」画面で「詳細:トークンで接続」を開き、「新しいtokenを作成」で分かりやすい名前を付けます。後で取り消すときに迷いません。
- 「操作できるデバイス」で、「すべてのデバイス」か1台だけかを選びます。AIに触らせるのが1台だけなら、その1台だけを選びましょう。
- 「権限」は3段階から選びます。「読み取り専用」(スクリーンショットと状態、--readonly と同じ)、「操作」(タッチ、文字入力、GPSを追加)、「フル」(ファイル、APK、スクリプトを追加)。最初は読み取り専用か操作がおすすめです。フルを選ぶと「攻略」スイッチも出ます。初期状態はオフで、AIに攻略を任せるときだけオンにします。
- 有効期間を7日、30日、90日から選びます(初期値は30日)。初回は7日で十分です。
- 「tokenを作成」を押します。トークンは一度しか表示されないので、コピーして保存し、「保存しました」を押します。
- 使うツールの設定をコピーします。Claude Codeのコマンド、Claude Desktopの.mcpb、CodexのTOML、CursorのJSON、手動設定のJSONがあります。Claude Codeのコマンドはターミナルで実行します。中身は npx -y @zerohuman-ai/poc-mcp@latest --token にトークンを付けたものです。
- Claude Codeで「クラウドスマホのスクリーンショットを撮って画面を説明して」と頼みます。つながると、画面の表示が WAITING から CONNECTED に変わります。
Claude Desktop、Codex、Cursorの設定方法は?
同じ「AI / MCP」メニューに、ツールごとの設定方法が用意されています。設定ファイルを手書きする場面はほとんどありません。
- Claude Desktop:.mcpbファイルをダウンロードし、ダブルクリックでインストール。インストール時のトークン欄は空欄でかまいません。空欄ならブラウザでのログインになります。
- Codex:CodexのMCP設定はJSONではなくTOMLです。CodexのTOMLをコピーし、~/.codex/config.toml に貼り付けます。クイック接続なら [mcp_servers.cloudphone]、command = "npx"、args = ["-y", "@zerohuman-ai/poc-mcp@latest"] の3行です。
- Cursor:JSON設定をコピーし、CursorのMCP設定(mcp.json)に貼り付け。クイック接続なら {"mcpServers":{"cloudphone":{"command":"npx","args":["-y","@zerohuman-ai/poc-mcp@latest"]}}} です。
ログインはPCごとに初回の呼び出しで一度だけです。トークンを使う場合は、ツールごとに別のトークンにすれば、不要になった分だけ取り消せます。
どんなツールが使える?
MCPサーバーのツールは大きく5種類に分かれます。どれを使うかはAIが選びますが、知っておくと指示を具体的に書けます。
| 分類 | ツール | 主な用途 |
|---|---|---|
| 画面を見る | スクリーンショット、ピクセル色、review_last_screen_touch | 今どの画面か、ボタンが有効か、直前のタップが正しい位置か |
| 操作 | タップ、スワイプ、文字入力、キー、ナビ、回転、一括入力 | メニューを開く、リストをスクロール、名前入力、縦横切り替え |
| ファイルとアプリ | ファイル読み書き・改名・削除、APKインストール | 設定ファイルの配置、テスト版アプリの導入 |
| 自動化 | スクリプト実行・停止、ガイド実行・停止、GPS設定・移動 | ガイドマーケットのガイドを起動、仮想位置の変更 |
| 状態 | 端末一覧、接続状態、ログ | 複数端末から正しい一台を選ぶ、問題の調査 |
起動時のオプションも覚えておくと便利です。
- --profile core:よく使う12ツールだけを公開。ツールが少ないほどAIの選び間違いが減り、コンテキストも節約できます。
- --readonly:見るだけモード。まずAIに画面を観察させ、理解できているのを確認してから操作を許可しましょう。
- --inspector:ローカルの可視化デバッガを開き、AIが送った指示とタップ位置を確認できます。
座標は常に0から1000の比率で指定します。画面中央なら(500, 500)です。解像度が違っても同じ比率なら同じ相対位置を押すので、メモやガイドを書き直す必要がありません。
実際にAIに何を頼める?
接続できたら、普通の言葉で話しかけるだけです。実用的な例をいくつか挙げます。
- 「ゲームを起動してお知らせを閉じ、ログインボーナスを受け取ったらスクショを送って」
- 「10分ごとにスクリーンショットを撮って、HPバーが赤くなったら帰還ボタンを押して」(放置中の見張りに便利)
- 「PCにあるこのAPKをクラウドスマホに入れて、起動後にトップ画面で落ちないか確認して」
- 「ガイドマーケットのこのデイリーガイドを3周回して、終わったらログを報告して」

指示は具体的なほど安定します。特定の文字が出る、ボタンがグレーになる、など「終わり」の条件を明確に伝えましょう。
ブラウザとMCPは同時に接続できるので、タブで画面を見ながら、おかしいと思ったらすぐ手動で引き継げます。
ログイン、トークン、権限を安全に管理するには?
ログインしたPCもトークンも、スマホを操作できる鍵です。パスワードと同じように扱ってください。
- トークンやトークンを含む設定ファイルを、公開リポジトリやDiscord、掲示板に貼らない。
- ブラウザでのログインは、そのPCにアカウント内のすべてのクラウドスマホを90日間操作させます。特定の端末だけ、読み取り専用だけにしたいときはトークンを使いましょう。
- 権限は必要な分だけ。見るだけなら読み取り専用を選び、APKのインストールやスクリプト実行が不要ならフルは選ばない。
- 有効期間はできるだけ短くし、切れたら新しく発行する。
- 使わないトークンやログイン済みのPCはすぐ取り消す。どちらも「マイページ → 開発者」のトークン一覧で管理できます。
注意点が一つあります。取り消しても、すでに確立された接続は切れません。トークンの漏えいやPCの不正利用が心配なときは、取り消したうえで端末を再起動し、古い接続を確実に切りましょう。
また、AIや自動化でゲームを操作することは、ゲームによっては利用規約に反する場合があります。どのゲームで使うかはご自身でリスクを判断してください。
つながらない、動きがおかしいときのトラブル対処
| 症状 | 考えられる原因 | 対処 |
|---|---|---|
| 最初の呼び出しが長い | パッケージのダウンロードと接続確立中 | 40秒ほど待つ。2回目以降は速い |
| ログイン用リンクが期限切れ・使用済みになる | リンクの有効期限切れ、または一度使用済み | AIにもう一度呼び出してもらい、新しいリンクを受け取る |
| 「許可」を押したのにまだログインを求められる | AIがまだ再試行していない | AIにもう一度試すよう伝える |
| いつまでもつながらない | 社内VPNやファイアウォールがWebRTCをブロック | テザリングや自宅回線で試す |
| npxでエラーになる | Nodeのバージョンが古い | Node 18以上に更新 |
| タップ位置がずれる | 比率ではなくピクセル座標を使っている | 0から1000の比率に直す |
| たまにハンドシェイクに失敗 | ブラウザとMCPが同時接続時に競合 | 数秒待って再試行 |
| AIが権限エラーを返す | トークンの権限レベルが足りない(読み取り専用など) | 権限を「操作」か「フル」にしてトークンを作り直す。攻略を使うならフルで「攻略」をオン |
タップに反応がないときは、review_last_screen_touchで直前のタッチを確認させると、ボタンの端や読み込み途中が原因だと分かることがよくあります。
よくある質問
Q:プログラミングができないと使えませんか? A:いいえ。設定はコマンドを一行コピーして貼り、初回にブラウザでログインするだけで、その後は日本語でClaude Codeに指示すれば操作できます。
Q:MCPの利用に追加料金はかかりますか? A:MCPはクラウドスマホの機能の一つです。Claude Code、Codex、Cursorはご自身のアカウントを使うため、料金は各AIツールのプランに従います。
Q:ブラウザとAIで同じ端末を同時に操作できますか? A:できます。両方同時に接続できますが、ハンドシェイクの瞬間にまれに競合することがあるので、その場合は再試行してください。
Q:PCを閉じてもAIは動き続けますか? A:クラウドスマホ自体は24時間動きますが、Claude CodeはPC上で動いているため、PCを閉じるとAIは止まります。長時間の無人放置にはガイドマーケットのガイドを端末上で実行するのがおすすめです。
Q:AIで操作するとアカウントがBANされますか? A:どちらとも保証はできません。自動化に関するルールはゲームごとに異なるので、規約を確認したうえでご自身で判断してください。
出典
- Model Context Protocol 公式ドキュメント:MCP は AI アプリと外部システムをつなぐオープン標準
- npm パッケージ @zerohuman-ai/poc-mcp(現在 0.4.x、Node 18 以上が必要)
- Claude Code 公式ドキュメント:claude mcp add で MCP サーバーを接続
- MCP Bundles(.mcpb)公式 GitHub:Claude デスクトップ版でローカル MCP サーバーをワンクリック導入
- Cursor 公式ドキュメント:Model Context Protocol(mcp.json 設定)
- MDN:WebRTC のプロトコル(ICE、STUN、TURN とファイアウォール、NAT)
CloudPhone Goはクラウドスマホサービスです。ゲームは台湾のデータセンターにある専用の実機Androidで動くので、パソコンやスマホの電源を切っても動き続けます。
