BETACloudPhone Go 目前為 Beta 測試階段。效能調校期間功能可能調整,你的回饋會決定下一步做什麼。Beta 測試中,歡迎提供回饋。申請 Beta 測試 →

部落格

用 Claude Code 透過 MCP 操控雲端手機

用 Claude Code 透過 MCP 操控雲端手機

讓 AI 代理看見並操作一台真實的 Android 手機。這篇從貼上一行指令、瀏覽器登入到第一次下指令,一步一步說明。

在 Google 搜尋優先看到我們的攻略

把 CloudPhone Go 加入 Google 偏好來源,之後搜尋遊戲攻略、掛機設定時,我們的新文章會更常出現在你的結果裡。只要一鍵,隨時可以取消。

加入 Google 偏好來源

用 Claude Code 透過 MCP 真的能操控雲端手機嗎?

可以。CloudPhone Go 雲手機(雲端手機)提供官方 MCP server,你把一行指令貼進 Claude Code,第一次使用時用瀏覽器登入你的帳號,AI 就能截圖看畫面、點擊、滑動、打字、裝 APK,甚至移動 GPS 和跑攻略。整個設定大約幾分鐘,需要的只有 Node 18 以上。

這跟一般「錄製巨集」不一樣。巨集只會照座標重播,畫面一變就亂點;AI 代理會先看截圖再決定下一步,遇到彈窗、公告、更新提示也比較有機會自己處理。

對想掛機、想讓 AI 幫忙刷每日任務,或是在寫 Android App 想讓 AI 幫忙測試的人來說,等於多了一隻 24 小時不睡覺的手。雲端手機在台灣機房持續運作,你關掉電腦它也不會停。

28 秒實錄:只跟 Claude 說「繼續玩塔塔彈珠」,它透過 MCP 自己截圖、看畫面、長按發射,拿到 1500 糖果獎勵卡,塔塔升到 2 級。用 AI 操作遊戲可能違反部分遊戲的使用條款,請先確認。中文旁白為 AI 語音。 在 YouTube 上觀看 ↗

MCP 是什麼?為什麼適合拿來操控手機?

MCP(Model Context Protocol)是讓 AI 工具呼叫外部功能的開放標準。你可以把它想成 AI 的「外掛插槽」:只要有 MCP server,Claude Code、Claude Desktop、Codex、Cursor 這類工具就能使用它提供的工具。

手機操作其實很適合交給 MCP。每一步都是「看畫面、判斷、動手」,正好對應截圖、取色、點擊這幾個工具。AI 不需要懂遊戲引擎,只要像人一樣看著螢幕操作就好。

CloudPhone Go 的 MCP 連線走 P2P 直連,不經過中繼伺服器。指令從你的電腦直接送到台灣機房裡那台真實的 Android 手機,延遲表現跟你用瀏覽器操作時差不多(實際會依網路而異)。

開始前要準備什麼?

準備工作不多,但少一樣就會卡住。下面這張表先對一下:

項目需求備註
CloudPhone Go 裝置任一方案月繳或年繳都可以,隨時可取消續約
電腦系統Windows、macOS 或 Linux三種都支援
Node.js18 以上在終端機輸入 node -v 確認
AI 工具Claude Code、Claude Desktop、Codex 或 Cursor用你自己的帳號
網路能建立 WebRTC 直連嚴格的公司 VPN 或防火牆可能擋住

如果你平常在公司網路下用,建議先用手機熱點或家裡網路測一次,排除防火牆的問題,之後再回公司環境試。

怎麼把 Claude Code 接上雲端手機?(快速連線)

以下以 Claude Code 為例。推薦用「快速連線」:不用先產生 token,也不用複製貼上任何金鑰,第一次使用時用瀏覽器登入就好。

  1. 在電腦的終端機執行 claude mcp add cloudphone -- npx -y @zerohuman-ai/poc-mcp@latest。這行指令也可以在 CloudPhone Go(app.cloudphonego.com)的裝置選單 ⋯ →「AI / MCP」,或「我的 → 開發者」裡的「快速連線(推薦)」直接複製。
  2. 打開 Claude Code,輸入「截一張雲端手機的圖並描述畫面」。
  3. 第一次呼叫時,AI 會回你一個登入連結,例如 https://app.cloudphonego.com/mcp-link?code=BCDF-GHJK。電腦有瀏覽器的話,會自動幫你打開。
  4. 用你的 CloudPhone Go 帳號登入,確認「要求來自」顯示的是你的電腦名稱、「代碼」跟 AI 給你的一樣,再按「允許」。不認得就按「拒絕」。
  5. 回到 Claude Code,請它再試一次,就會連上並開始截圖。

之後這台電腦會保持登入(存在你的使用者設定資料夾),不用每次重來。登入憑證有效 90 天,過期時會自動要你重新登入;它也會出現在「AI / MCP」視窗的 token 清單裡,隨時可以撤銷。習慣用終端機的話,也可以直接執行 npx -y @zerohuman-ai/poc-mcp@latest login 登入,登出則把 login 換成 logout。

指令裡的 @latest 會讓 npx 每次啟動時檢查有沒有新版本,所以你只要重開 AI 工具,就會自動用到最新版。

第一次呼叫可能要等 40 秒左右,因為要下載套件並建立 P2P 連線,這是正常的。之後的呼叫就會快很多,不用重來。

進階:什麼時候該改用 token 連線?

在「AI / MCP」視窗下方展開「進階:用 token 連線」,就能自己產生 token。適合 CI、沒有瀏覽器的伺服器,或想限制 AI 只能碰特定裝置、只能唯讀的情況。步驟如下:

  1. 在 CloudPhone Go 的「AI / MCP」視窗展開「進階:用 token 連線」,在「建立新 token」先取一個好認的名字,例如「筆電 Claude Code」,之後要撤銷時才分得清楚。
  2. 「可操作的裝置」選「全部裝置」或只選一台。只想讓 AI 碰某一台,就只選那台。
  3. 「權限」三選一:唯讀(截圖和狀態,等於 --readonly)、操作(再加觸控、輸入和 GPS)、完整(再加檔案、APK 和腳本)。第一次建議從唯讀或操作開始。選完整時,另有「攻略」開關,預設關閉,要讓 AI 管攻略才打開。
  4. 「有效期」選 7 天、30 天或 90 天,預設是 30 天。第一次試用選 7 天就夠。
  5. 按「建立 token」。token 只會顯示這一次,先複製保存,再按「我已經存好了」。
  6. 選你的工具複製設定:Claude Code 指令、Claude Desktop .mcpb、Codex TOML、Cursor JSON 或手動設定 JSON。Claude Code 的指令貼到電腦的終端機執行,背後跑的是 npx -y @zerohuman-ai/poc-mcp@latest --token 加上你的 token。
  7. 打開 Claude Code,輸入「截一張雲端手機的圖並描述畫面」。連上之後,視窗裡的狀態會從 WAITING 變成 CONNECTED。

Claude Desktop、Codex、Cursor 怎麼設定?

同一個「AI / MCP」選單裡,每種工具都有對應的設定方式,大多不用自己手打設定檔:

  • Claude Desktop:下載 .mcpb 檔,雙擊安裝即可。安裝時的 token 欄位可以留空,留空就是用瀏覽器登入。
  • Codex:Codex 的 MCP 設定是 TOML,不是 JSON。複製 Codex TOML,貼到 ~/.codex/config.toml。快速連線的內容是 [mcp_servers.cloudphone]、command = "npx"、args = ["-y", "@zerohuman-ai/poc-mcp@latest"] 三行。
  • Cursor:複製 JSON 設定,貼進 Cursor 的 MCP 設定(mcp.json)。快速連線的內容是 {"mcpServers":{"cloudphone":{"command":"npx","args":["-y","@zerohuman-ai/poc-mcp@latest"]}}}。

每台電腦第一次呼叫時登入一次就好。如果改用 token,建議每個工具各用一組,這樣某台電腦不用了,只要撤銷那一組,其他工具不受影響。

有哪些工具可以用?

MCP server 提供的工具大致分成五類。AI 會自己挑要用哪個,但你知道有哪些,下指令時就能講得更精準。

類別工具常見用途
看畫面截圖、像素取色、review_last_screen_touch確認現在在哪個畫面、按鈕亮了沒、上一下點對位置沒
操作點擊、滑動、輸入文字、按鍵、導覽、旋轉、批次輸入點選單、捲列表、打帳號名稱、切橫直向
檔案與 App檔案讀寫、改名、刪除、安裝 APK放設定檔、裝測試版 App
自動化執行或停止腳本、跑或停攻略、設定與移動 GPS啟動攻略市集的攻略、切換虛擬定位
狀態裝置清單、連線狀態、log多台裝置時選對機器、查問題

啟動時還有幾個好用的選項:

  • --profile core:只開 12 個最常用的工具。工具少,AI 選錯的機會也少,也比較省 context。
  • --readonly:只看不動。剛接上時先用這個讓 AI 觀察,確定它理解畫面再開放操作。
  • --inspector:開一個本機的視覺化除錯頁,可以看到 AI 送了什麼指令、點在哪裡。

座標一律用 0 到 1000 的比例值,例如畫面正中央就是 (500, 500)。不管手機解析度是多少,同一個比例都會點到同一個相對位置,寫進攻略或筆記也不用改。

實際能叫 AI 做哪些事?

接上之後,你用一般說話的方式下指令就好。以下是幾個實用的例子:

  • 「打開遊戲,關掉所有公告,領每日登入獎勵,完成後截圖給我看。」
  • 「每 10 分鐘截一次圖,如果角色血量條變紅就按回城。」(適合掛機時盯場)
  • 「把我電腦上的 APK 裝到雲端手機,打開後確認首頁有沒有閃退。」
  • 「列出我所有裝置,告訴我哪台目前連線正常。」
  • 「在攻略市集幫我跑這份每日攻略三輪,跑完回報 log。」
AI 代理看著畫面自己判斷下一步,幫你把每日任務肝完
AI 代理看著畫面自己判斷下一步,幫你把每日任務肝完

指令越具體,AI 越不會亂猜。講清楚「做完的判斷條件」,例如看到某個字、某個按鈕變灰,比只說「做完」可靠很多。

如果你同時開著瀏覽器分頁看畫面,也可以即時看到 AI 在點什麼。瀏覽器和 MCP 可以同時連同一台裝置,看到怪怪的就自己手動接手。

登入、token 和權限要怎麼管才安全?

用瀏覽器登入的電腦和 token 一樣,都等於一把可以操作你手機的鑰匙,保管方式請比照密碼:

  • 不要把 token 或含 token 的設定檔貼到公開的 GitHub、Discord 或論壇。
  • 瀏覽器登入會讓這台電腦操控你帳號裡的所有雲手機,有效 90 天。只想開放特定裝置或唯讀,請改用 token。
  • 權限只給需要的。只要看畫面就選「唯讀」,不需要裝 APK 或跑腳本就不要選「完整」。
  • 有效期能短就短,到期再產生新的,比一組用到天荒地老安全。
  • 不用的 token 或登入過的電腦立刻撤銷。全部都在「我的 → 開發者」的 token 清單管理。

要特別注意:撤銷不會切斷已經建立的連線。如果你懷疑 token 外流或電腦被別人用過,撤銷之後最好也重開裝置,確保舊連線斷掉。

另外,用 AI 或自動化操作遊戲,可能違反部分遊戲的使用條款。要不要用、用在哪款遊戲,請自己衡量風險。

連不上或動作怪怪的?常見錯誤排除

狀況可能原因怎麼處理
第一次呼叫等很久正在下載套件並建立連線等約 40 秒,之後就會變快
登入連結打不開或顯示過期連結已過期或已經用過回到 AI 工具請它重新呼叫一次,拿新的連結
按了允許,AI 還是說要登入AI 還沒重新呼叫請 AI 再試一次
一直連不上公司 VPN 或防火牆擋 WebRTC換手機熱點或家用網路測試
npx 指令報錯Node 版本太舊升級到 Node 18 以上
點擊位置偏掉用了像素座標而不是比例改用 0 到 1000 的比例值
偶爾握手失敗瀏覽器和 MCP 同時連線時搶握手稍等幾秒重試即可
AI 說沒有權限token 的權限等級不夠(例如選了唯讀)建立一組新的 token,權限選「操作」或「完整」;要用攻略,選完整並打開「攻略」

如果 AI 點了卻沒反應,可以請它用 review_last_screen_touch 回頭檢查上一下的觸控,常常就能發現是點到按鈕邊緣或畫面還沒載完。

常見問題

Q:一定要會寫程式才能用嗎? A:不用。設定只需要複製貼上一行指令,第一次再用瀏覽器登入,之後用中文對 Claude Code 下指令就可以操作手機。

Q:用 MCP 會另外收費嗎? A:MCP 本身是雲端手機的功能。你用自己的 Claude Code、Codex 或 Cursor 帳號,費用依各家 AI 工具自己的方案計算。

Q:可以同時用瀏覽器和 AI 操作同一台嗎? A:可以,兩邊能同時連線。只是握手的瞬間偶爾會互搶,重試一下就好。

Q:關掉電腦後 AI 還會繼續嗎? A:雲端手機本身會 24 小時持續運作,但 Claude Code 是跑在你的電腦上,電腦關了 AI 就停。想要長時間無人掛機,可以改用攻略市集的攻略在裝置上執行。

Q:AI 操作遊戲會被封號嗎? A:我們無法保證。不同遊戲對自動化的規定不同,請先看清楚遊戲條款,自己判斷風險。

資料來源

  1. Model Context Protocol 官方文件:MCP 是連接 AI 應用與外部系統的開放標準
  2. npm 套件 @zerohuman-ai/poc-mcp(目前為 0.4.x,需 Node 18 以上)
  3. Claude Code 官方文件:用 claude mcp add 連接 MCP 伺服器
  4. MCP Bundles(.mcpb)官方 GitHub:Claude 桌面版一鍵安裝本機 MCP 伺服器
  5. Cursor 官方文件:Model Context Protocol(mcp.json 設定)
  6. MDN:WebRTC 連線協定(ICE、STUN、TURN 與防火牆、NAT)

關於 CloudPhone Go:這是一款雲手機服務:遊戲在台灣機房的專屬實體 Android 手機上執行,電腦和手機關掉也會繼續跑。

看完整功能 →攻略市集入門 →更多文章 →
CloudPhone Go mascot

準備好永不下線了嗎?

專屬雲端手機幾秒內開機。選好方案、Google 登入,讓它替你肝。

立即啟用雲端手機