Cổng MCP: để Claude và Cursor điều khiển tool bằng lời
MCP là gì, cắm vào Claude Desktop / Claude Code / Cursor bằng 1 cú bấm, các lệnh AI dùng được, rào an toàn chặn bằng máy và cách chỉnh giới hạn.
MCP là gì?
Nói nôm na: MCP là cái ổ cắm chuẩn. App AI nào có "phích MCP" (Claude Desktop, Claude Code, Cursor…) cắm vào là dùng được các nút của tool.
| Trước đây | Có MCP |
|---|---|
| Mở tool xem log → chép lỗi → dán sang AI → AI đoán → tự sửa, tự bấm chạy lại | Gõ 1 câu. AI tự đọc log, xem kịch bản, sửa, nạp vào tool, chạy thử 1 acc, đọc kết quả |
Máy chủ MCP chạy ngay trên máy bạn, nói chuyện với tool qua cổng nội bộ 127.0.0.1, không mở ra Internet.
Cài trong 4 bước
- Chép thư mục
ai_tich_hopmới vào cạnh tool. - Mở tool, đợi giao diện hiện lên.
- Bấm đúp CAI_MCP.bat: tự tìm Claude Desktop / Claude Code / Cursor, sao lưu cấu hình cũ rồi cắm vào, cuối cùng tự thử. Thấy dòng ✔ trang_thai là được.
- Tắt hẳn Claude Desktop (chuột phải icon ở khay đồng hồ → Quit) rồi mở lại. Lần đầu AI dùng lệnh, bấm Allow.
Câu mẫu để gõ
- Xem AutoSmartTool đang chạy gì
- Acc nào lỗi, lỗi gì, gom theo nguyên nhân
- Đọc log acc lỗi gần nhất, tìm bước sai trong kịch bản, sửa rồi nạp vào tool, chạy thử 1 acc
- Tóm tắt báo cáo SQLite tuần này
Các lệnh AI dùng được (30 lệnh)
Tự lấy từ gpm_mcp.py. Dấu * = tham số bắt buộc.
trang_thaiChỉ đọcMỚIXem AutoSmartTool đang làm gì: đang chạy hay rảnh, kịch bản đang mở, tiến độ, số acc xong/lỗi, các acc lỗi. Gọi cái này ĐẦU TIÊN. (Status of the GPM automation tool.)
ds_accChỉ đọcMỚIDanh sách acc/profile trong tool: STT, tên, có tick không, kết quả lần chạy (ok/err), ghi chú lỗi. Không trả proxy/IP.
nhat_kyChỉ đọcMỚIĐọc nhật ký (log) gần nhất của tool. Lọc lỗi hoặc 1 acc.
ds_kich_banChỉ đọcMỚILiệt kê các file kịch bản (.json) trong thư mục kịch bản của tool.
xem_kich_banChỉ đọcMỚIXem nội dung 1 kịch bản (theo tên file) hoặc kịch bản đang mở (bỏ trống ten). Không đổi gì trong tool.
mo_kich_banCó rào chắnMỚIMở 1 file kịch bản vào tool (thay kịch bản đang mở; không chạy).
chay_kich_banCó rào chắnMỚIChạy kịch bản đang mở (hoặc mở kich_ban rồi chạy) trên các acc có STT ghi rõ. Quá số acc cho phép / 'all' / kịch bản đụng tiền-ví → máy tính của chủ hiện cửa sổ hỏi, chủ bấm Yes mới chạy. Kịch bản tiền: chỉ 1 acc. Nên chạy THỬ 1 acc trước, xem trang_thai/nhat_ky rồi mới xin chạy nhiều.
dung_chayCó rào chắnMỚIBấm Dừng: dừng mọi acc đang chạy. Luôn được phép.
tam_dungCó rào chắnMỚIBấm Tạm dừng / Chạy tiếp (đảo trạng thái).
nap_kich_banCó rào chắnMỚINạp danh sách bước (JSON steps) vào ô soạn của tool để chủ máy xem — CHƯA lưu file, chưa chạy.
luu_kich_banCó rào chắnMỚILưu kịch bản đang mở thành file mới. Trùng tên file có sẵn → hỏi chủ máy, mặc định KHÔNG ghi đè.
bao_cao_dbChỉ đọcMỚIĐọc báo cáo kết quả trong SQLite (gpm_data.db). loai: tom_tat (mặc định) | acc_loi | acc_ok | acc_khong_ro | loi_hay_gap | theo_ngay | tim_acc | tong_swap | tong_chuyen | chuyen_loi | vi_dang_giu.
soan_kich_banCó rào chắnMỚIGiao cho THỢ AI RẺ trong tool (DeepSeek...) soạn kịch bản từ mô tả tiếng Việt; mo_trang=true thì mở acc tick đầu tiên quét trang thật. Tốn vài trăm đồng/lần. Trả kết quả sau ≤45 giây; chưa xong thì gọi lại với id + tu để xem tiếp / trả lời câu thợ hỏi.
chi_phi_aiChỉ đọcMỚITiền AI tool đã tiêu (theo ngày, theo thợ) và ngân sách hôm nay.
bao_cao_demChỉ đọcMỚIBáo cáo của 'bác sĩ đêm': lỗi lặp lại, chẩn đoán, bản vá đã tạo.
chay_thu_tu_suaCó rào chắnMỚITự CHẠY THỬ & SỬA 1 kịch bản trên ĐÚNG 1 acc test: hỏng ở bước nào → AI của tool đọc chữ trang thật lúc đó, sửa bước → chạy lại (tối đa toi_da_sua lần). Sửa trên bản sao <tên>__tuthu.json, bản gốc giữ nguyên. Luôn hỏi chủ máy trước. Xem bằng xem_chay_thu_tu_sua.
xem_chay_thu_tu_suaChỉ đọcMỚIXem tiến độ / kết quả lượt tự chạy thử & sửa (nhật ký, bước AI đã sửa).
ap_ban_chay_thuCó rào chắnMỚIÁp bản đã sửa (lượt chạy thử ĐẠT) vào kịch bản gốc; bản cũ cất ban_cu/. Chủ máy phải bấm đồng ý.
hoi_tro_lyChỉ đọcMỚIHỏi trợ lý hỗ trợ của tool cách dùng 1 tính năng (đọc từ hướng dẫn sử dụng).
so_tay_xpathChỉ đọcMỚISổ tay XPath tool đã học theo trang web (không truyền ten_mien = danh sách trang).
phone_ds_mayChỉ đọcMỚIĐIỆN THOẠI: danh sách điện thoại Android trong Box Phone (tên máy 01..15, sẵn sàng/không thấy, đang chạy gì). Gọi trước các lệnh phone_.
phone_man_hinhChỉ đọcMỚIĐIỆN THOẠI: đọc CHỮ trên màn hình 1 máy → danh sách phần tử đánh số #1, #2... (nút, ô nhập, vị trí %). Dữ liệu nhạy cảm đã che; ô mật khẩu không lộ chữ.
phone_thao_tacCó rào chắnMỚIĐIỆN THOẠI: làm 1 thao tác trên 1 máy. lenh: cham {so} | giu {so} | go {so?, chu, enter?} | vuot {huong: len/xuong/trai/phai} | quay_lai | home | phim {phim: enter/xoa/tab} | mo_app {goi: com.discord} | mo_link {url} | cho {giay} | cham_xy {x,y phần trăm}. Số #N lấy từ phone_man_hinh vừa đọc (đọc lại sau mỗi thao tác). Lần đầu mỗi máy / bước nguy hiểm / app ví → chủ máy phải bấm đồng ý trên máy tính. Trả kèm bước kịch bản Box Phone tương ứng để gom thành kịch bản.
phone_ds_kich_banChỉ đọcMỚIĐIỆN THOẠI: liệt kê kịch bản Box Phone (.json).
phone_xem_kich_banChỉ đọcMỚIĐIỆN THOẠI: xem nội dung 1 kịch bản Box Phone.
phone_chay_kich_banCó rào chắnMỚIĐIỆN THOẠI: chạy 1 kịch bản Box Phone trên các máy ghi rõ (vd "07" / "01,03" / "all"). Nhiều hơn số máy cho phép / all / kịch bản đụng tiền → chủ máy phải bấm đồng ý. Kịch bản tiền: 1 máy/lần.
phone_luu_kich_banCó rào chắnMỚIĐIỆN THOẠI: lưu danh sách bước thành file kịch bản Box Phone (vd gom các buoc_kich_ban từ phone_thao_tac). Trùng tên file có sẵn → chủ máy phải bấm đồng ý mới ghi đè.
phone_chay_thuCó rào chắnMỚIĐIỆN THOẠI: CHẠY THỬ 1 kịch bản đã lưu trên đúng 1 máy (1 acc). Bước nào lỗi → AI của tool đọc màn hình, sửa bước đó rồi chạy tiếp (tối đa toi_da_sua lần). Không đổi file gốc. Xem kết quả bằng phone_xem_chay_thu. Lần đầu mỗi máy / có tiền / xoá dữ liệu app → chủ máy phải đồng ý.
phone_xem_chay_thuChỉ đọcMỚIĐIỆN THOẠI: xem tiến độ / kết quả các lượt chạy thử (nhật ký từng bước, bước AI đã sửa, kịch bản sau sửa khi ghi id).
phone_dungCó rào chắnMỚIĐIỆN THOẠI: dừng mọi máy đang chạy kịch bản + trợ lý AI trên phone. Luôn được phép.
Rào an toàn (chặn bằng máy, AI không lách được)
- Chạy quá số acc cho phép, chạy "all", hoặc kịch bản đụng tiền/ví → máy tính hiện cửa sổ Yes / No. Không bấm trong 2 phút = từ chối. Cửa sổ nằm trên máy, không nằm trong khung chat, nên AI không bấm thay được.
- Kịch bản tiền/ví: AI chỉ chạy 1 acc mỗi lần, kể cả khi bạn đồng ý.
- Không ghi đè kịch bản có sẵn, không xoá, không đọc file key / Excel / cookie.
- Chữ trả về cho AI được che (ví, seed, email, proxy…). Mọi lệnh AI gọi được ghi vào
ai_log/mcp_nhat_ky_NGÀY.txt.
Chỉnh giới hạn
Sửa ai_tich_hop/gpm_mcp_cfg.json bằng Notepad, lưu là có tác dụng ngay.
| Khoá | Mặc định | Ý nghĩa |
|---|---|---|
toi_da_acc_khong_hoi | 1 | chạy tới bao nhiêu acc thì KHÔNG cần hỏi (quá số này → hiện cửa sổ hỏi) |
cho_chay_kich_ban_tien | true | False = cấm hẳn AI chạy kịch bản đụng tiền/ví (kể cả 1 acc) |
hoi_bang_cua_so | true | False = không hiện cửa sổ hỏi → việc cần hỏi sẽ bị TỪ CHỐI luôn |
giay_cho_tra_loi | 120 | cửa sổ hỏi tự đóng (= từ chối) sau bao nhiêu giây |
che_du_lieu | true | che bí mật trong chữ trả về cho AI |
cho_soan_ai | true | cho AI ngoài giao việc soạn kịch bản cho thợ AI rẻ trong tool (tốn vài trăm đồng/lần) |
cau_noi | "" | đường dẫn gpm_web_cau_noi.json nếu để chỗ lạ (thường để trống) |
phone_phut_duyet | 30 | chủ máy cho AI điều khiển 1 điện thoại → được làm tiếp trên máy đó bao nhiêu phút không hỏi lại |
phone_toi_da_may_khong_hoi | 1 | chạy kịch bản phone trên tới bao nhiêu máy thì không cần hỏi |
cau_noi_phone | "" | đường dẫn box_web_cau_noi.json nếu để chỗ lạ (thường để trống) |
Gặp lỗi?
| Báo | Cách xử lý |
|---|---|
WinError 10061 / không gọi được tool | Tool chưa mở. Hoặc tool đang chạy ở thư mục khác: chép ai_tich_hop vào cạnh tool đang chạy rồi bấm lại CAI_MCP.bat |
| Claude không thấy "aismarthub" | Phải Quit hẳn ở khay đồng hồ (bấm X chỉ thu nhỏ) |
| "Chủ máy bấm TỪ CHỐI / không trả lời kịp" | Đúng thiết kế. Cửa sổ hỏi có thể nằm sau cửa sổ khác, nhìn thanh taskbar |