Chuyển tới nội dung chính

Máy chủ MCP cho ứng dụng AI

TikMatrix có một máy chủ MCP. Khi được bật, một ứng dụng AI trên cùng máy tính — Claude Desktop, Claude Code, Cursor hoặc bất kỳ ứng dụng MCP nào khác — có thể xem thiết bị, tài khoản và task của bạn, lên kế hoạch task mới, đọc nhật ký và ảnh chụp màn hình, tất cả từ một cuộc trò chuyện.

AI không tự thay đổi bất cứ điều gì. Việc tạo, dừng hoặc thử lại task và thêm script tùy chỉnh đều chờ bạn phê duyệt trong cửa sổ TikMatrix.

Yêu cầu giấy phép

Máy chủ MCP có trên các gói Pro, Team và Business, giống Local API. Với gói Starter, ứng dụng AI vẫn kết nối được nhưng mọi công cụ đều trả về thông báo nâng cấp.

Bật tính năng​

  1. Mở TikMatrix → Cài đặt → API cho nhà phát triển.
  2. Bật Ứng dụng AI (MCP). Mặc định là tắt.
  3. Sao chép cấu hình cho ứng dụng AI của bạn từ cùng mục đó. Cấu hình đã có sẵn đúng tên máy chủ, địa chỉ và, với Claude Desktop, đường dẫn đầy đủ tới chương trình TikMatrix trên máy tính này.

TikMatrix phải đang chạy khi bạn sử dụng. Máy chủ chỉ trả lời máy tính này: các máy khác trong mạng không thể truy cập.

Kết nối ứng dụng AI​

Claude Desktop​

Claude Desktop khởi chạy máy chủ MCP như một chương trình, nên TikMatrix cung cấp chế độ chuyển tiếp nhỏ. Mở Settings → Developer → Edit Config trong Claude Desktop và thêm đoạn mã sao chép từ TikMatrix vào claude_desktop_config.json. Nó trông như sau — đường dẫn là đường dẫn trên máy tính của bạn:

{
"mcpServers": {
"tikmatrix": {
"command": "C:\\Program Files\\TikMatrix\\TikMatrix.exe",
"args": ["--mcp-stdio"]
}
}
}

Khởi động lại Claude Desktop. Tùy chọn --mcp-stdio không mở thêm cửa sổ nào; nó chỉ chuyển tiếp tin nhắn tới TikMatrix đang chạy.

Claude Code​

claude mcp add --transport http tikmatrix http://127.0.0.1:50809/mcp

Cursor và các ứng dụng khác​

Các ứng dụng chấp nhận địa chỉ máy chủ sẽ kết nối trực tiếp tới endpoint Streamable HTTP:

{
"mcpServers": {
"tikmatrix": {
"url": "http://127.0.0.1:50809/mcp"
}
}
}

Tên máy chủ khác nhau theo phiên bản (tikmatrix, igmatrix hoặc tikmatrix-pro); đoạn mã trong Cài đặt dùng đúng tên.

AI có thể làm gì​

Công cụChức năngCần phê duyệt
list_devicesĐiện thoại đã kết nối, mỗi máy đang trực tuyến hay bận, và các nhóm của chúngKhông
list_accountsTài khoản, thiết bị chứa mỗi tài khoản, và tài khoản đã đăng nhập hay chưaKhông
list_groupsNhóm thiết bịKhông
get_script_schemaCác thiết lập mà mỗi script chấp nhậnKhông
list_tasksTask, lọc theo trạng thái, thiết bị hoặc scriptKhông
get_task_logNhật ký của một taskKhông
get_activity_logHoạt động gần đây của ứng dụngKhông
device_screenshotMàn hình điện thoại đang hiển thị gì ngay lúc nàyKhông
list_custom_scriptsCác script tùy chỉnh bạn đã đăng kýKhông
get_custom_script_guideCách viết một script tùy chỉnhKhông
plan_tasksTính toán chính xác những task nào yêu cầu sẽ tạo, mà không tạo chúngKhông
create_tasksTạo các task trong một kế hoạchCó
stop_taskDừng một task đang chạyCó
retry_taskChạy lại một task thất bạiCó
create_custom_scriptViết và đăng ký một script tùy chỉnh mớiCó
get_approvalKiểm tra kết quả của một yêu cầu đã chờ phê duyệtKhông

Phê duyệt thay đổi​

Khi AI gửi một thay đổi, TikMatrix sẽ hiện lên phía trước và cho thấy nó sẽ làm gì: với một loạt task, là script, các thiết lập và từng thiết bị, tài khoản, mục tiêu, theo từng dòng. Chọn Phê duyệt để chạy hoặc Từ chối để bỏ.

  • Nếu bạn trả lời trong khoảng 50 giây, AI nhận kết quả ngay.
  • Nếu lâu hơn, AI được thông báo rằng yêu cầu đang chờ bạn. Phê duyệt sau vẫn chạy, và AI có thể hỏi kết quả.
  • Yêu cầu chưa được trả lời sẽ hết hạn sau 15 phút, cùng với kế hoạch mà chúng xuất phát.
  • Các task được tạo theo cách này hiển thị nguồn mcp trong danh sách task.

Ví dụ yêu cầu​

  • "Những điện thoại nào của tôi đang offline, và tài khoản nào đã đăng xuất?"
  • "Làm ấm mọi tài khoản trong nhóm US-1 trong 20 phút, bắt đầu từ 9 giờ tối nay."
  • "Vì sao ba task đăng bài gần nhất thất bại? Cho tôi xem màn hình của điện thoại bị lỗi."

Bảo mật​

  • Chỉ cục bộ. Endpoint chỉ nhận kết nối từ máy tính này và từ chối các yêu cầu do trang web gửi.
  • Mặc định tắt. Không có gì có thể kết nối cho đến khi bạn bật, và tắt đi có hiệu lực ngay.
  • Mọi thay đổi do bạn phê duyệt. Điều này không phụ thuộc vào cài đặt quyền của ứng dụng AI bạn dùng.

Khắc phục sự cố​

Thông báoCần làm gì
"AI client access is turned off"Bật Ứng dụng AI (MCP) trong Cài đặt → API cho nhà phát triển.
"The app is not running"Khởi động TikMatrix, rồi thử lại.
"API access requires Pro or higher plan"Nâng cấp lên gói Pro, Team hoặc Business.
AI báo yêu cầu đang chờ, nhưng không thấy gì hiện raĐưa cửa sổ TikMatrix lên phía trước; phê duyệt đang chờ ở đó.