MCP — cho AI agent quản lý NextCore Browser

Nối Claude Code, Antigravity, Cursor, VS Code vào NextCore Browser để tạo, mở, xếp, sao lưu profile và thao tác trang trong từng profile bằng lời.

MCP (Model Context Protocol) là chuẩn chung để trợ lý AI dùng công cụ bên ngoài. NextCore Browser có sẵn một MCP server chạy trên chính Local API: trợ lý AI của bạn nối vào và làm việc với profile như khi bạn bấm trong app.

Ví dụ bạn nói với trợ lý:

• "Liệt kê các profile nhóm Farm máy 1 đang lỗi proxy."
• "Tạo 10 profile tên Shop 01–10, gắn lần lượt các proxy trong danh sách này."
• "Mở 4 profile nhóm Farm máy 2 và xếp thành lưới 2×2 trên màn hình phụ."
• "Sao lưu profile Shop Ngọc Lan vào ổ D."
• "Mở profile Shop 03, vào trang nhóm Facebook và cho tôi biết còn bao nhiêu bài chờ duyệt."

Trợ lý thao tác trang trong từng profile, giữ nguyên đăng nhập, proxy và tiện ích của profile đó, bằng bộ công cụ cùng tên với Playwright MCP chính thức (browser_*).

#Bật và kết nối

SETTINGS › AI agent (MCP), bật Bật AI agent (MCP) (bật sẵn). Server chỉ nghe trên máy này: http://127.0.0.1:<cổng>/mcp, cần token.

Dưới công tắc là bốn hàng: Claude Code, Antigravity, Cursor, VS Code. Hàng nào app thấy có trên máy thì có nút Kết nối: app tự ghi cấu hình vào tệp của trợ lý đó kèm một token riêng, bạn không phải chép gì.

Nối xong, hỏi trợ lý «Liệt kê profile NextCore Browser của tôi». Khối Lần gọi gần nhất liệt kê từng lần trợ lý gọi công cụ.

Hàng Trải nghiệm NextCore Browser & Super Agent (cần Claude Code đã nối): bấm Bắt đầu, app mở một tab Claude mới trong Orca ở repo đang mở và gõ sẵn lời mở đầu để agent tự giới thiệu việc nó làm được với app. Menu ⋯ cho chép lời đó để dán vào agent khác.

#Nối tay

Trợ lý khác, hoặc muốn tự sửa tệp: mở Nâng cao ở cuối khối. Có cổng và token của Local API, Dòng lệnh dán vào terminal (Claude Code) (nút Chép lệnh) và Cấu hình thủ công cho client khác (JSON) (nút Chép JSON). Lệnh và JSON được chép kèm token thật; màn hình chỉ hiện ••••.

{
  "mcpServers": {
    "nextcore-browser": {
      "url": "http://127.0.0.1:19880/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

#Bộ công cụ

Đủ bộ có gần 190 công cụ, khá nặng với trợ lý giới hạn số công cụ. Thêm ?bo= vào địa chỉ để chọn bộ nhỏ hơn:

Bộ nhỏ chỉ rút gọn danh sách trợ lý nhìn thấy; trợ lý gọi thẳng tên một công cụ ngoài bộ vẫn chạy.

#Công cụ

Công cụ phá huỷ tắt sẵn, trợ lý không thấy chúng. Bật công tắc Cho phép công cụ phá huỷ ở SETTINGS › AI agent (MCP).

Các công cụ ncb_trang_mo_url, ncb_trang_doc, ncb_trang_bam, ncb_trang_go, ncb_trang_chup là bản cũ, vẫn chạy cho script đã viết nhưng không hiện trong bộ app và co-ban. Viết mới thì dùng ncb_chon_profile + browser_*.

#NextCore Command: điều phối agent nhiều máy (ncb_terminal)

Một công cụ, tham số hanhDong chọn việc. may là nay (máy này) hoặc id máy lấy từ may.

Ví dụ giao việc dựng bản macOS cho máy Mac:

{ "hanhDong": "giao", "hdh": "darwin", "chu": "Phát hành bản 0.3.92 cho macOS theo docs/phat-hanh-da-nen-tang.md" }

Câu gửi tới agent bên kia có ghi nguồn «[Việc giao từ <máy> qua NEXTCORE TERMINAL — trả lời «Đã nhận» rồi làm]». Vài phút sau gọi doc hoặc giam-sat để kiểm. Gõ phím thô vào terminal (term*) không mở cho MCP.

#NextCore Kernel (nck_apply)

Từ bản 0.3.158, các quyết định của NextCore Command (chọn việc, chấm điểm, gỡ kẹt, nghiệm thu, chia lát việc lớn) đi qua nck_apply. Agent mô tả tình huống, Kernel trả quyết định; agent không nhận và không cần biết luật bên trong.

{ "module": "nck.command", "tinhHuong": { "loai": "cham-diem", "…": "dữ kiện của tình huống" } }

Kernel chạy trên máy chủ NextCore. NCB gửi câu hỏi kèm giấy phép của tài khoản và chữ ký khoá thiết bị của máy, nên chỉ máy đã đăng nhập mới gọi được.

Module nck.command còn trả bản đồ ô mã của repo đang mở: { "loai": "ban-do-o" } ⇒ các cụm tệp gắn chặt (theo import và lịch sử cùng sửa trong git), kèm số dòng, độ hay đổi, có test hay chưa; { "loai": "o-cua-tep", "tep": "<đường dẫn>" } ⇒ tệp đó thuộc ô nào. Dùng để chia lát việc lớn đúng ranh giới. Lần dựng đầu vài giây, các lần sau chỉ đọc lại tệp đã đổi.

Mất mạng ngắn thì NCB tự quyết tại máy (nguon: "cuc-bo"), tối đa 24 giờ kể từ lần cuối máy chủ trả lời. Khi máy chủ chặn vì gọi dồn dập, NCB không chuyển sang tự quyết tại máy.

#Thao tác trang trong profile

Thứ tự trợ lý thường làm:

1. ncb_liet_ke_profile lấy id (người dùng nói tên thì lọc theo q).
2. ncb_chon_profile { "id": "…" }: gắn phiên này với profile, tự mở nếu chưa mở. Từ đây mọi browser_* chạy trên profile đó.
3. browser_navigate vào trang cần làm, rồi browser_snapshot đọc cây trợ năng. Mỗi phần tử có ref.
4. browser_type / browser_click với ref đó; browser_take_screenshot hoặc browser_snapshot để kiểm kết quả.
5. Xong: ncb_tha_profile nhả profile cho phiên khác (trình duyệt vẫn mở).

• Một phiên MCP giữ một profile. Muốn chạy nhiều profile song song thì mở nhiều phiên (nhiều agent). Profile đang bị phiên khác giữ thì ncb_chon_profile báo lỗi; ncb_phien cho biết ai đang giữ.
• Bấm và gõ là sự kiện chuột, bàn phím thật, không phải lệnh JavaScript trong trang.
• Mỗi profile mở ra vẫn trả wsEndpoint riêng nếu bạn muốn nối Playwright hoặc Puppeteer từ script.

#Gõ mật khẩu mà agent không thấy

Từ bản 0.3.149, khi phiên giữ một profile, các ô ghi chú bí mật của profile (PWD ACCOUNT, khoá 2FA, PWD EMAIL, COOKIE) được nạp thành bí mật có tên. Trong mọi kết quả browser_* (cây trang, console, tệp ghi ra), giá trị thật được thay bằng <secret>PWD_ACCOUNT</secret>. Agent gõ bằng tên: browser_type với chữ PWD_ACCOUNT sẽ ra mật khẩu thật trong ô, còn agent chỉ thấy tên.

#NextCore E2E: đo trang

Bộ ncb_e2e* (NextCore E2E) đo trang web của bạn trên profile thật (đã đăng nhập sẵn), không cần dựng tài khoản thử:

ncb_e2e và ncb_e2e_lo nhận quyTac để đặt ngưỡng riêng của dự án (cỡ vùng bấm, mức tương phản AA hay AAA, ngưỡng LCP/CLS, vùng bỏ qua).

#An toàn

• Chỉ máy này gọi được (127.0.0.1), bắt token, từ chối yêu cầu từ trang web, giống Local API. Mỗi trợ lý nối bằng Kết nối có token riêng, thu hồi riêng được.
• Không công cụ nào trả mật khẩu proxy. Khi Che thông tin đăng nhập bật (SETTINGS), ncb_liet_ke_profile / ncb_xem_profile che PWD ACCOUNT, 2FA CODE, PWD EMAIL, COOKIE. Agent chỉ đọc được nguyên văn một ô qua ncb_o_bi_mat, từng ô một, và mỗi lần gọi đều ghi trong Lần gọi gần nhất.
• Các lệnh đụng tới thư mục dữ liệu (chọn, dời, dùng lại thư mục cũ), thoát hay khởi động lại app chỉ chạy được trên chính máy đó; máy chính điều khiển qua trạm (ncb_chon_thiet_bi) gọi sẽ bị từ chối.
• Ai có token và chạy được chương trình trên máy bạn là điều khiển được profile. Giữ token như mật khẩu; lộ thì đổi token ở Nâng cao hoặc Thu hồi trợ lý đó.