AI SMART HUB· Hướng dẫn
AI · Bài 12/14

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.

2 phút đọc · cập nhật 20/11/2026

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 đâyCó 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ạiGõ 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

  1. Chép thư mục ai_tich_hop mới vào cạnh tool.
  2. Mở tool, đợi giao diện hiện lên.
  3. 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.
  4. 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
💡 Qua MCP, AI sửa được kịch bản (.json) và luôn lưu thành tên mới, không đè bản gốc. AI không sửa code tool (.py). Muốn sửa code thì dùng Claude Code mở trong thư mục tool.

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ỚI

Xem 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ỚI

Danh 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.

chi_loichi_ticktimtoi_da
nhat_kyChỉ đọcMỚI

Đọc nhật ký (log) gần nhất của tool. Lọc lỗi hoặc 1 acc.

so_dongchi_loistt
ds_kich_banChỉ đọcMỚI

Liệt kê các file kịch bản (.json) trong thư mục kịch bản của tool.

tim
xem_kich_banChỉ đọcMỚI

Xem 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.

tenday_du
mo_kich_banCó rào chắnMỚI

Mở 1 file kịch bản vào tool (thay kịch bản đang mở; không chạy).

ten
chay_kich_banCó rào chắnMỚI

Chạ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.

stt *kich_banly_do
dung_chayCó rào chắnMỚI

Bấm Dừng: dừng mọi acc đang chạy. Luôn được phép.

tam_dungCó rào chắnMỚI

Bấm Tạm dừng / Chạy tiếp (đảo trạng thái).

nap_kich_banCó rào chắnMỚI

Nạ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.

steps *
luu_kich_banCó rào chắnMỚI

Lư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 đè.

ten *
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.

loaibao_caotimtudentoi_da
soan_kich_banCó rào chắnMỚI

Giao 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.

yeu_cauurlmo_trangnhanhidtutra_loi
chi_phi_aiChỉ đọcMỚI

Tiền AI tool đã tiêu (theo ngày, theo thợ) và ngân sách hôm nay.

so_ngay
bao_cao_demChỉ đọcMỚI

Bá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ỚI

Tự 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.

stt *kich_bantoi_da_sualy_do
xem_chay_thu_tu_suaChỉ đọcMỚI

Xem tiến độ / kết quả lượt tự chạy thử & sửa (nhật ký, bước AI đã sửa).

id
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 ý.

id
hoi_tro_lyChỉ đọcMỚI

Hỏ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).

cau_hoi *
so_tay_xpathChỉ đọcMỚI

Sổ tay XPath tool đã học theo trang web (không truyền ten_mien = danh sách trang).

ten_mien
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ữ.

may *
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.

may *lenh *sochuenterhuongphimgoiurlgiayxy
phone_ds_kich_banChỉ đọcMỚI

ĐIỆN THOẠI: liệt kê kịch bản Box Phone (.json).

tim
phone_xem_kich_banChỉ đọcMỚI

ĐIỆN THOẠI: xem nội dung 1 kịch bản Box Phone.

ten *
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.

kich_ban *may *file_accly_do
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 đè.

ten *steps *
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 ý.

kich_ban *may *file_accdong_acctoi_da_sualam_moily_do
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).

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_hoi1chạ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_tientrueFalse = cấm hẳn AI chạy kịch bản đụng tiền/ví (kể cả 1 acc)
hoi_bang_cua_sotrueFalse = 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_loi120cửa sổ hỏi tự đóng (= từ chối) sau bao nhiêu giây
che_du_lieutrueche bí mật trong chữ trả về cho AI
cho_soan_aitruecho 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_duyet30chủ 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_hoi1chạ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áoCách xử lý
WinError 10061 / không gọi được toolTool 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