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.
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
- Mở TikMatrix → Cài đặt → API cho nhà phát triển.
- Bật Ứng dụng AI (MCP). Mặc định là tắt.
- 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ăng | Cầ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úng | Không |
list_accounts | Tài khoản, thiết bị chứa mỗi tài khoản, và tài khoản đã đăng nhập hay chưa | Không |
list_groups | Nhóm thiết bị | Không |
get_script_schema | Các thiết lập mà mỗi script chấp nhận | Không |
list_tasks | Task, lọc theo trạng thái, thiết bị hoặc script | Không |
get_task_log | Nhật ký của một task | Không |
get_activity_log | Hoạt động gần đây của ứng dụng | Không |
device_screenshot | Màn hình điện thoại đang hiển thị gì ngay lúc này | Không |
list_custom_scripts | Các script tùy chỉnh bạn đã đăng ký | Không |
get_custom_script_guide | Cách viết một script tùy chỉnh | Không |
plan_tasks | Tí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úng | Không |
create_tasks | Tạo các task trong một kế hoạch | Có |
stop_task | Dừng một task đang chạy | Có |
retry_task | Chạy lại một task thất bại | Có |
create_custom_script | Viết và đăng ký một script tùy chỉnh mới | Có |
get_approval | Kiểm tra kết quả của một yêu cầu đã chờ phê duyệt | Khô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
mcptrong 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áo | Cầ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ờ ở đó. |