MCP server của MAS

MCP server Android cho Claude Code, Cursor, Codex và mọi MCP client

41 công cụ trao cho AI client của bạn đôi mắt và đôi tay trên Android: ảnh chụp màn hình nó nhìn được, OCR và so khớp ảnh mẫu, chạm, vuốt và gõ, chạy macro, và một agent dựng macro từ một câu. Điều khiển BlueStacks, LDPlayer, MuMu, MEmu hoặc bất kỳ giả lập tương thích adb nào trên Windows hay Mac, điện thoại cắm vào máy tính, hoặc thiết bị Android đám mây luôn bật, ngay từ client bạn đang dùng.

Server lưu trữ với khóa MAS của bạn trong header, rồi server cục bộ bằng URL khi ứng dụng đang mở.

claude mcp add --transport http mas-cloud https://api.automationmacro.com/mcp --header "X-API-Key: $MAS_API_KEY"
claude mcp add --transport http mas-local http://127.0.0.1:3846/mcp
Tải ứng dụng Làm quen với MAS Agent Tài liệu cài đặt

Đây là gì

MCP server Android của MAS làm gì

MCP là giao thức mà các AI client dùng để gọi công cụ bên ngoài. Server này biến một thiết bị Android thành những công cụ đó. Client của bạn xin ảnh chụp màn hình và nhận về một hình ảnh nó nhìn được; hỏi màn hình đang hiện gì và nhận về các dòng OCR kèm độ tin cậy và khung bao; gửi một ảnh mẫu và nhận về vị trí của nó; chạm, vuốt, gõ và bấm phím; mở và đóng ứng dụng. Đó là phần mà mọi MCP server Android đều làm, và nó hoạt động như nhau trên giả lập, điện thoại cắm vào máy hay thiết bị đám mây.

Server của MAS còn làm phần mà một server thiết bị không làm được. Nó đọc và chạy các macro trong thư viện của bạn, nó nhờ MAS Agent khám phá một ứng dụng và trả về một macro Python hoàn chỉnh, và nó cung cấp bản đồ agent đã học về ứng dụng đó, cộng với toàn bộ tài liệu tham chiếu SDK dưới dạng tài nguyên MCP để client của bạn viết code macro theo phong cách nhà. Điều đó khiến nó là MCP server cho tự động hóa Android ở tầng thiết bị, và là MCP server tự động hóa di động cho các tầng bên trên: macro, agent, bản đồ. Nó không phải plugin Android Studio và không phải trợ lý viết code. Nó điều khiển thiết bị.

Server lưu trữ

Đủ 41 công cụ, trên thiết bị đám mây của bạn

Một endpoint HTTP từ xa. Thuê một thiết bị đám mây, điều khiển nó, chạy macro phía máy chủ, dựng macro mới với agent, đọc bản đồ ứng dụng. Không cần cài gì, và máy tính của bạn có thể tắt.

Server cục bộ, ngay trong ứng dụng

38 công cụ, trên máy của bạn

Chính ứng dụng máy tính là server. Bật nó ở mục Integrations (MCP) rồi trỏ client của bạn vào URL loopback. Nó điều khiển bất cứ gì adb nhìn thấy, BlueStacks, LDPlayer, MuMu, MEmu trên Windows hoặc macOS hay một chiếc điện thoại đã bật gỡ lỗi USB, và nó mang theo cả thư viện macro, Image Library, phần dựng macro bằng agent, vòng lặp phát triển và bộ lập lịch.

Giả lập

Điều khiển giả lập Android: BlueStacks, LDPlayer, MuMu, MEmu trên Windows hoặc Mac

Server cục bộ là MCP server giả lập Android cho chiếc giả lập đã có trên bàn bạn. Bật nó ở mục Integrations (MCP) trong ứng dụng và trỏ client của bạn vào http://127.0.0.1:3846/mcp. Mọi công cụ thiết bị đều nhận một tham số device, là id từ list_devices, một adb serial hoặc chỉ số cổng, và bạn có thể bỏ trống khi chỉ có một giả lập đang chạy. Ứng dụng mang sẵn adb của riêng nó, nên đây là cấu hình MCP giả lập Android mà hầu hết mọi người đang tìm: một công tắc, một URL, xong.

  • BlueStacks
  • LDPlayer
  • MuMu
  • MEmu
  • Windows
  • macOS

Game là trường hợp làm hỏng các server dựa trên cây accessibility: không có cây nào để đọc. Cả hai server đều làm việc từ điểm ảnh, nên mô hình có thể chơi qua màn hình game như cách nó đi qua màn hình cài đặt.

Thiết bị đám mây

Thiết bị Android đám mây, không cần cài gì

Server lưu trữ kết nối với các thiết bị luôn bật mà MAS vận hành cho bạn. lease_device mở một phiên điều khiển và trả về lease id mà mọi công cụ thiết bị cần; đặt auto_start và nó sẽ khởi động thiết bị đang dừng trước. Phiên thuê được gia hạn ở mỗi lệnh gọi và hết hạn sau 10 phút không hoạt động, nên một client bị bỏ quên không thể giữ thiết bị mãi. run_macro thực thi trên thiết bị phía máy chủ và author_macro giao việc cho MAS Agent trên đó, cả hai đều khi máy tính của bạn đã tắt.

Công cụ thiết bị không tính phí theo lệnh gọi; chúng hoạt động trên các thiết bị đám mây tài khoản bạn sở hữu, $80/tháng mỗi thiết bị kèm hạn mức credit hằng tháng. Xem thiết bị đám mây.

Điện thoại của bạn

MCP server ADB Android cho chiếc điện thoại trên bàn bạn

Bật gỡ lỗi USB, cắm điện thoại vào, và server cục bộ liệt kê nó bên cạnh giả lập của bạn. Mọi công cụ màn hình, thao tác và thị giác đều hoạt động trên đó: mô hình có thể điều khiển điện thoại Android qua MCP giống hệt cách nó điều khiển giả lập, từ client bạn đang dùng, không cài gì lên điện thoại.

Thị giác

Ảnh chụp màn hình mô hình nhìn được, OCR và so khớp ảnh mẫu

  • screenshot trả về màn hình dưới dạng nội dung hình ảnh, nên mô hình nhìn thẳng vào đó thay vì đoán từ một cây. Server cục bộ mặc định thu nhỏ về 1280 px ở cạnh dài và báo hệ số tỷ lệ.
  • read_text chạy OCR trên màn hình hoặc một vùng và trả về từng dòng kèm độ tin cậy và khung bao, nên "chạm vào chữ Nhận" là một tọa độ, không phải một hy vọng.
  • find_image so khớp ảnh mẫu bạn gửi bằng OpenCV, với ngưỡng do bạn kiểm soát, và trả về điểm số cùng tâm để chạm.

Công cụ

Đủ 41 công cụ

Mọi công cụ theo tên, kèm tham số. Công cụ "cục bộ và lưu trữ" có ở cả hai bề mặt; số ít công cụ còn lại được đánh dấu bề mặt mà chúng thuộc về.

Device control

Pick a device and drive it: the same taps, swipes and keys a person would use.

  • get_status cục bộ và lưu trữ
    Call this first. What the server is, whether the account can run anything (subscription, AI credits), the devices it can reach, and hints, including that local emulators are only reachable through the desktop app's local server. The same body as the mas://status resource; needs no scope.
  • list_devices cục bộ và lưu trữ
    List the devices the server can reach, with their state. On the hosted server that is your cloud devices and quota; on the local server, the emulators the app sees over adb (id, serial, port, whether a macro is using one).
  • lease_device (device_id, auto_start) lưu trữ
    Open a control session on one of your cloud devices and get the lease_id every device tool needs. auto_start boots a stopped device first. A lease renews on every call and expires after ten idle minutes; one lease per device, and a device that is running a macro cannot be leased.
  • release_device (lease_id) lưu trữ
    End the control session. The device keeps running.
  • tap (x, y) cục bộ và lưu trữ
    Tap the screen at device coordinates.
  • swipe (x1, y1, x2, y2, duration_ms) cục bộ và lưu trữ
    Swipe between two points for scrolling and flicks, with a chosen duration (default 300 ms).
  • long_press (x, y, duration_ms) cục bộ và lưu trữ
    Press and hold at a point for duration_ms (default 800, 100 to 5000): context menus, drag handles, app icons.
  • drag (x1, y1, x2, y2, duration_ms) cục bộ và lưu trữ
    Touch down, move to a second point over duration_ms (default 600, 100 to 5000) and release: slow enough for sliders and drag-and-drop, unlike a flick swipe.
  • type_text (text) cục bộ và lưu trữ
    Type text into the focused input field.
  • press_key (key) cục bộ và lưu trữ
    Press BACK, HOME, ENTER, TAB, DEL or any KEYCODE_ name.
  • open_app (package) cục bộ và lưu trữ
    Launch an app by package name.
  • close_app (package) cục bộ và lưu trữ
    Force-stop an app by package name.
  • current_app cục bộ và lưu trữ
    Report the package in the foreground.
  • screen_size cục bộ và lưu trữ
    Return the screen size in pixels, the coordinate space for tap and swipe.
  • wait (ms) cục bộ và lưu trữ
    Pause for animations and loading screens: up to 10 seconds per call on the hosted server, up to 60 seconds locally. Prefer wait_for when you know what you are waiting for.

Screen understanding

Let the model see the screen and locate things on it without guessing coordinates: pixels, OCR, template matching and the accessibility tree.

  • screenshot (max_width) cục bộ và lưu trữ
    Capture the screen and return it as an image the model looks at directly. Pass max_width (200 to 2000) for a smaller image; the reply then reports the scale, and tap coordinates stay in device pixels (device_x = image_x / scale). The local server limits the long side to 1280 px by default and always reports the scale.
  • read_text (region {x1, y1, x2, y2}) cục bộ và lưu trữ
    OCR the whole screen or one region into text lines. The hosted server returns a confidence and a bounding box per line; the local server returns the lines and the scanned box.
  • find_image (template_base64 | image_id, threshold) cục bộ và lưu trữ
    Locate a template on screen with OpenCV matching and return the score and tap coordinates. The template is inline (template_base64) or an image_id from your image library, so a crop made once with crop_image is found every time.
  • get_ui_tree (max_nodes) cục bộ và lưu trữ
    The Android accessibility hierarchy as compact text, one visible element per line with its class, id, text, description, bounds and flags. Cheaper and more exact than a screenshot for buttons, fields and labels; games and canvas views expose little.
  • find_element (id, text, desc, class, contains, index) cục bộ và lưu trữ
    Find UI elements by resource id, text, content description and/or class (selectors combine). Returns the match at index with its bounds and tap centre, plus up to 20 matches. contains=true (default) matches substrings.
  • wait_for (image_id | template_base64 | text | element {id, text, desc, class}, threshold, timeout_ms, interval_ms) cục bộ và lưu trữ
    Poll the screen until one target appears or timeout_ms (default 15000, max 60000) passes: a library image (image_id) or inline template, on-screen text (OCR), or a UI element selector. Returns where it was found and the elapsed time. Use it instead of wait plus screenshot loops.

Macros and runs

Your macro library, readable and runnable from the client. Hosted runs execute server-side on a cloud device; local runs are the editor's Run button on your emulator.

  • list_macros (page, page_size) cục bộ và lưu trữ
    List your saved macros with name, id and type (code, or legacy for a retired block macro).
  • get_macro_code (macro_id, file) cục bộ và lưu trữ
    Read a code macro's project: the entry script and the file listing by default, or one file you name.
  • run_macro (macro_id, device_id, args) cục bộ và lưu trữ
    Start a saved code macro with optional argument overrides and return a run_id at once. Hosted: server-side on a cloud device of yours (it starts if stopped). Local: on the named emulator, which stays busy for the other device tools until the run ends.
  • get_run (run_id) lưu trữ
    The state of a hosted run, from launching through running to finished or failed, with its message and timings.
  • get_run_status (run_id) cục bộ
    The state of a local run (running, stopping, completed, failed, stopped), its timestamps and the exit code once it ended. The local name for get_run.
  • stop_run (run_id) cục bộ và lưu trữ
    Stop a running macro.
  • get_run_log (run_id, max_lines) cục bộ và lưu trữ
    The trailing stdout and stderr lines of a run, newest last, while it runs or after. Hosted runs come from run_macro, validate_macro or a schedule.

Image library

Your Image Library, the same one the app shows: crop a control once, then find it by id from any tool or macro.

  • list_images (folder, query, limit, page) cục bộ và lưu trữ
    List your library images, newest first, optionally within one folder or matching a name substring; each with id, name, folder, pixel size and byte size.
  • get_image (image_id) cục bộ và lưu trữ
    Fetch one library image by id: the picture itself, to confirm it is the template you mean, plus its name, folder and size.
  • crop_image (region {x, y, width, height}, name, folder) cục bộ và lưu trữ
    Crop a rectangle of the device's current screen into the library as a PNG template and return its new image_id with a small preview. The region is clamped to the screen; at least 8 by 8 pixels must remain; a name already used in the folder gets a numeric suffix.

Agent authoring

Hand a goal to MAS Agent and get a finished macro back, from any client.

  • author_macro (prompt, device_id, model, macro_id, parent_session_id, pipeline) cục bộ và lưu trữ
    Ask MAS Agent to build a macro from a plain-language goal: it explores the app on the device, captures what it needs, writes and validates the macro. macro_id improves one of your macros instead, parent_session_id continues an earlier session, pipeline picks how the code is produced (build, review, author, author_fast). Async and minutes long; returns a session_id. Hosted authoring always uses the metered cloud model; local authoring uses the provider the app has selected (provider overrides it).
  • get_agent_session (session_id, after_seq) cục bộ và lưu trữ
    Progress of an authoring session: state, summary, the macro id once it exists, and any question the agent is waiting on. Hosted sessions also return the transcript events after your cursor.
  • answer_agent_session (session_id, qid, answers) cục bộ và lưu trữ
    Answer the agent's pending question so it can continue. Hosted: qid plus an answers object keyed by question header; local: one answer string (an option label or free text).
  • stop_agent_session (session_id) cục bộ và lưu trữ
    Stop a session early. Work done so far is saved.

Developer loop

Write a macro yourself, in the house style: scaffold the project, install it as a code macro, prove it with one run.

  • scaffold_macro (name, activities, description, app_package) cục bộ và lưu trữ
    Generate the house project skeleton for a new code macro: src/app.py wiring, one src/activities/<name>.py stub per activity, common_logic.py, the scheduler library, task.yaml, ui.xml, requirements.txt and README.md. Pure: nothing is saved; returns {files: {path: content}} for you to fill in.
  • install_macro (name, files, macro_id, description) cục bộ và lưu trữ
    Create a code macro from project files, or replace the code of one of yours when macro_id is given, through the same create and code-sync path the app uses. files is {path: content}, 2 MB total; the code is syntax-checked on intake. The local server also takes project_dir, a folder on your PC.
  • validate_macro (macro_id, device_id, timeout_s, args) cục bộ và lưu trữ
    Run a macro once and wait for the verdict: passed, exit code and the log tail. Hosted: one run on a cloud device, default 300 s; a run still going at the timeout is stopped. Local: the engine's validation job on your emulator, which also checks task.yaml; pass macro_id or project_dir, and runs (1 to 5) for the graduation ladder.

App maps

What the agent has learned about an app, readable by your client.

  • get_map (package, profile) lưu trữ
    The learned menu map of an app: its screens and the proven routes between them.

Scheduling

The same scheduler the app's Schedule card uses. Hosted jobs run on a cloud device with your PC off; local jobs fire while the app is open.

  • schedule_macro (macro_id, device_id, at, every, timezone, name, weekdays) cục bộ và lưu trữ
    Schedule a code macro to run without you: once at `at` (RFC 3339) or recurring with every = daily, weekly (with weekdays) or monthly, in an IANA timezone. No hourly recurrence: a macro that repeats within the day recurs itself. Missed occurrences are skipped; the job pauses after three consecutive failures. Returns job_id and next_run_at.
  • list_schedules (status, target, page) cục bộ và lưu trữ
    Your scheduled jobs, cloud and local, with status, next and last run, failures and the auto-pause reason. Filter by status or target.
  • cancel_schedule (job_id) cục bộ và lưu trữ
    Delete a scheduled job for good; a run still going on a cloud device is stopped first. Use the app to skip one occurrence or pause a job.

Tài nguyên

Tài liệu server công bố để client viết code macro mà không cần rời cuộc trò chuyện.

  • mas://status Read first: the server, the account (subscription, AI credits), the devices it reaches, connected clients on the local server, and where local emulators live (the desktop app).
  • mas://docs/sdk-reference The complete reference of the pre-installed mas SDK macros are written against: device control, vision, elements, app management, storage, types and exceptions.
  • mas://docs/house-library The house library MAS Agent builds macros with: the scheduler skeleton, the activity runner and the runtime-UI template that scaffold_macro ships verbatim.

Cài đặt

Thêm trong một phút

Server lưu trữ nhận khóa của bạn ở mọi lệnh gọi: tạo một khóa trong ứng dụng ở mục Integrations (MCP) hoặc API Keys, chọn các phạm vi bạn muốn, rồi gửi nó trong header X-API-Key hoặc Authorization. Client nào thích thông tin xác thực ngắn hạn có thể đổi khóa lấy access token có hiệu lực 1 giờ, còn client đăng nhập tương tác thì nhận token riêng của nó. Server cục bộ không cần khóa nào cả. 

curl -s -X POST https://api.automationmacro.com/api/mcp/oauth/token -d grant_type=client_credentials -d client_secret=$MAS_API_KEY

Claude Code

Server lưu trữ với khóa của bạn trong header, rồi server cục bộ bằng URL khi ứng dụng đang mở:

claude mcp add --transport http mas-cloud https://api.automationmacro.com/mcp --header "X-API-Key: $MAS_API_KEY"
claude mcp add --transport http mas-local http://127.0.0.1:3846/mcp

Cursor

Trong .cursor/mcp.json, cả hai server dưới dạng mục HTTP:

{
  "mcpServers": {
    "mas-cloud": {
      "url": "https://api.automationmacro.com/mcp",
      "headers": { "X-API-Key": "<your key>" }
    },
    "mas-local": { "url": "http://127.0.0.1:3846/mcp" }
  }
}

Codex CLI

Trong ~/.codex/config.toml, với khóa trong biến môi trường; server cục bộ là codex mcp add mas-local --url:

[mcp_servers.mas-cloud]
url = "https://api.automationmacro.com/mcp"
bearer_token_env_var = "MAS_API_KEY"

Hermes, OpenCode, Gemini CLI và các client khác

Bất kỳ client nào nhận một server HTTP có header. Claude Desktop thì khởi chạy một lệnh, nên nó nhận chính ứng dụng làm cầu nối tới server cục bộ; ứng dụng hiển thị sẵn khối cấu hình với đường dẫn cài đặt của bạn.

{
  "mcpServers": {
    "mas-cloud": { "type": "http", "url": "https://api.automationmacro.com/mcp", "headers": { "X-API-Key": "<your key>" } },
    "mas-local": { "type": "http", "url": "http://127.0.0.1:3846/mcp" }
  }
}

Kiểm tra: yêu cầu client liệt kê thiết bị, rồi xin một ảnh chụp màn hình. Endpoint https://api.automationmacro.com/mcp, giao thức 2025-06-18, tài liệu khám phá ở /.well-known.

Agent, dưới dạng công cụ

author_macro: từ một lần AI khám phá đến macro Python hoàn chỉnh

Hầu hết MCP server Android dừng ở thiết bị. Server này trao cho bạn cả agent. author_macro nhận một mục tiêu bằng lời thường và một thiết bị đám mây rồi khởi động một phiên MAS Agent: khám phá ứng dụng, chụp ảnh mẫu và vùng chữ nó cần từ màn hình thật, biên dịch một macro Python xác định và kiểm chứng bằng cách chạy lại. get_agent_session trả về bản ghi kèm con trỏ và bất kỳ câu hỏi nào agent đặt ra; answer_agent_session trả lời câu hỏi đó. Macro hoàn chỉnh nằm trong thư viện của bạn với id trong phiên, sẵn sàng cho run_macro, và mọi lần chạy sau đó không tốn credit AI. Xem MAS Agent.

QA

Kiểm thử ứng dụng Android và quy trình QA

Trỏ client vào một bản build thử nghiệm trên giả lập hoặc thiết bị đám mây, điều khiển luồng bằng tap, type_text và press_key, và kiểm tra từng màn hình bằng read_text hoặc find_image. Đi qua luồng một lần với author_macro và nó trở thành một bài kiểm tra lặp lại được mà bạn có thể đặt lịch. Nó kiểm thử ứng dụng qua màn hình như cách người dùng làm; nó không phải framework unit test.

Bảo mật

Server từ xa, truyền tải HTTP, khóa có phạm vi, và một server cục bộ chỉ trả lời máy của bạn

Server lưu trữ là JSON-RPC không trạng thái qua HTTPS trên một endpoint. Khóa được tạo trong ứng dụng, hiển thị một lần, có thể mang ngày hết hạn và thu hồi bằng một cú nhấp; token tạo từ khóa có hiệu lực 1 giờ và mất hiệu lực cùng với khóa. Mỗi khóa chỉ mang những phạm vi bạn cấp:

  • devices:control lease a cloud device, see its screen, tap, type, manage apps and the image library
  • macros:run list and read macros; start, check, validate and stop runs; read run logs; manage schedules
  • macros:author start, follow, answer and stop an agent authoring session; scaffold and install macro code
  • maps:read read the learned map of an app

Server cục bộ lắng nghe trên loopback và chỉ trả lời chính máy của bạn: một yêu cầu từ máy khác, hay từ một trang web ở nguồn gốc khác, đều bị từ chối. Nó chạy khi ứng dụng đang mở, và bạn tắt nó ở đúng nơi bạn đã bật.

Câu hỏi thường gặp về MCP server Android

MCP server Android là gì?

MCP (Model Context Protocol) là cách các AI client như Claude Code, Cursor và Codex gọi công cụ bên ngoài. MCP server Android cung cấp một thiết bị Android dưới dạng công cụ: chụp màn hình, đọc chữ trên đó, chạm, vuốt, gõ, mở ứng dụng. Server của MAS cung cấp 41 công cụ, và thêm những gì một server thiết bị đơn thuần không làm được: chạy macro đã lưu, nhờ MAS Agent dựng macro, và đọc bản đồ nó đã học về một ứng dụng.

Làm sao kết nối Claude Code với giả lập Android?

Với giả lập của bạn, hãy bật server cục bộ trong ứng dụng ở mục Integrations (MCP) rồi đăng ký URL của nó: claude mcp add --transport http mas-local http://127.0.0.1:3846/mcp. Nó điều khiển mọi thiết bị adb nhìn thấy. Với thiết bị đám mây, thêm server lưu trữ bằng claude mcp add --transport http, rồi hoặc đăng nhập từ /mcp ngay trong Claude Code, hoặc gửi khóa của bạn dưới dạng header. Cả hai đoạn cấu hình đều có trên trang này.

Có hoạt động với BlueStacks, LDPlayer, MuMu, MEmu không?

Có. Server cục bộ nói chuyện với bất cứ gì adb devices liệt kê, bao gồm BlueStacks, LDPlayer, MuMu, MEmu và các giả lập tương thích adb khác, trên Windows hoặc macOS. Không có gì trong đó gắn với một hãng giả lập cụ thể.

Cursor hoặc Codex có điều khiển được giả lập Android qua MCP không?

Có. Cursor nhận cả hai server dưới dạng mục HTTP trong mcp.json: server lưu trữ với khóa của bạn trong header, server cục bộ với URL loopback của nó. Codex CLI thêm server lưu trữ bằng codex mcp add và một khóa lấy từ biến môi trường, còn server cục bộ thì thêm bằng --url. Cùng những tên công cụ xuất hiện ở mỗi bên.

Những MCP client nào khác hoạt động được?

Bất kỳ client nào gọi được một MCP server qua HTTP: Claude Code, Cursor, Codex, Hermes, OpenCode, Gemini CLI và các client khác. Claude Desktop và claude.ai thêm server lưu trữ dưới dạng connector tùy chỉnh rồi đăng nhập cho bạn; còn với server cục bộ, Claude Desktop khởi chạy chính ứng dụng, vì nó chạy lệnh chứ không gọi URL.

Tôi có cần cài ADB hoặc Android Studio không?

Server cục bộ điều khiển giả lập qua adb, và ứng dụng máy tính mang sẵn bản adb của riêng nó, nên không có gì phải cài ngoài ứng dụng; không cần Android Studio. Server lưu trữ thì không cần cài gì cả: thiết bị đám mây được điều khiển phía máy chủ và client của bạn chỉ gọi công cụ.

Mô hình có thực sự nhìn thấy màn hình không?

Có. screenshot trả về màn hình dưới dạng hình ảnh mà mô hình nhìn thẳng vào. read_text chạy OCR và trả về từng dòng kèm độ tin cậy và khung bao, còn find_image so khớp ảnh mẫu bạn gửi và trả về điểm số cùng tọa độ chạm. Không cần cây accessibility, đó là lý do nó hoạt động với game.

Tôi có thể điều khiển điện thoại Android thật cắm vào máy tính không?

Có, qua server cục bộ. Bật gỡ lỗi USB, cắm điện thoại vào, và nó xuất hiện trong list_devices như mọi giả lập. Các công cụ màn hình, thao tác và thị giác hoạt động giống hệt.

Đây là MCP server từ xa hay chạy cục bộ?

Cả hai. Server lưu trữ là một endpoint HTTP từ xa, https://api.automationmacro.com/mcp, với đủ 41 công cụ cho thiết bị đám mây của bạn. Server cục bộ chính là ứng dụng máy tính, tại http://127.0.0.1:3846/mcp, với 38 công cụ cho giả lập và điện thoại cắm vào máy: cùng bộ công cụ thiết bị, thị giác, macro, Image Library, dựng macro, vòng lặp phát triển và lập lịch, chỉ thiếu phiên thuê thiết bị và bản đồ ứng dụng. Khác nhau ở chỗ công việc chạy ở đâu.

Xác thực hoạt động thế nào?

Server lưu trữ nhận khóa bạn tạo trong ứng dụng, với các phạm vi bạn chọn, trong header X-API-Key hoặc Authorization: Bearer ở mọi lệnh gọi. Client nào có phần mở rộng client credentials của MCP thì có thể đổi khóa lấy token một giờ tại https://api.automationmacro.com/api/mcp/oauth/token, còn client đăng nhập tương tác sẽ nhận token riêng của nó; thu hồi khóa là chặn tất cả. Tài liệu khám phá được công bố ở /.well-known. Server cục bộ không cần khóa.

author_macro trả về gì, và mất bao lâu?

Nó khởi động một phiên MAS Agent trên thiết bị đám mây và trả về session id ngay lập tức. Agent khám phá ứng dụng trong vài phút; get_agent_session truyền bản ghi kèm con trỏ và đưa ra bất kỳ câu hỏi nào nó đặt, bạn trả lời bằng answer_agent_session. Khi xong, macro id nằm trong phiên và macro nằm trong thư viện của bạn, sẵn sàng cho run_macro. Dựng macro tiêu credit AI; chạy macro hoàn chỉnh không tốn gì. Xem MAS Agent.

Có miễn phí không? Thiết bị đám mây giá bao nhiêu?

Server cục bộ là một phần của ứng dụng máy tính, không tính thêm phí; nó cần ứng dụng đang mở và đã đăng nhập. Server lưu trữ là một phần của tài khoản MAS; công cụ thiết bị của nó hoạt động trên các thiết bị đám mây bạn sở hữu, $80/tháng mỗi thiết bị kèm hạn mức credit hằng tháng, và không có phí theo lệnh gọi cho công cụ thiết bị. Chạy macro hoàn chỉnh không tốn credit; dựng macro bằng agent tiêu credit trong lúc làm việc. Xem bảng giá.

Có chạy được 24/7 trên thiết bị đám mây mà không cần bật máy tính không?

Có. lease_device mở một phiên điều khiển trên thiết bị đám mây và có thể khởi động thiết bị đang dừng; run_macro thực thi phía máy chủ. Máy tính của bạn không cần bật, và phiên thuê được gia hạn ở mỗi lệnh gọi rồi hết hạn sau 10 phút không hoạt động. Xem thiết bị đám mây.

Tôi có thể dùng nó để kiểm thử ứng dụng Android và QA không?

Có. Trỏ client vào một bản build thử nghiệm, điều khiển luồng bằng tap, type và press_key, kiểm tra từng màn hình bằng read_text hoặc find_image, và để author_macro biến luồng bạn đi qua một lần thành bài kiểm tra lặp lại được. Nó tự động hóa ứng dụng qua màn hình như cách người dùng làm; nó không phải framework unit test.

Tải ứng dụng Xem bảng giá Tài liệu cài đặt