Tóm tắt nhanh:
ak-webmcpgiúp AI agent chạy trong trình duyệt gọi thẳng trang, form hay tính năng của bạn qua tool WebMCP đăng ký bằngdocument.modelContext, thay vì đọc DOM rồi đoán chỗ bấm. Nó đặt tên, mô tả, JSON Schema, annotation an toàn rồi kiểm bằng validator và evals, sau đó có thể chuyển sangak-agent-browserđể chạy tự động. WebMCP chỉ là lớp thêm vào trang sẵn có, không phải MCP server: việc đó là củaak-mcp-builder.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn muốn biến một form thành tool, thêm tool cho hành động trong app một trang hoặc component React, cho widget nhúng ở site đối tác dùng tool, hoặc kiểm lại bộ tool khi agent hay gọi nhầm. Không dùng khi bạn cần dựng MCP server cho API, chạy một MCP tool có sẵn, hay chỉ tự động hoá trình duyệt: skill sẽ chỉ sang đúng chỗ.
flowchart LR
A["Trang, form, tính năng có sẵn"] --> B["ak-webmcp"]
B --> C["Tool WebMCP đã kiểm"]
C --> D["Test bằng Inspector và evals"]
D --> E["Chạy tự động: ak-agent-browser"]
A -->|"Cần MCP server"| F["ak-mcp-builder"]Nó dựa trên 4 ý:
| Ý | Câu hỏi | Ví dụ |
|---|---|---|
| WebMCP khác MCP server | Logic của tool chạy ở đâu? | add_to_cart chạy bằng JavaScript trên trang, dùng phiên đăng nhập của người dùng |
| Imperative hay declarative | Hành động có phải chỉ là gửi một form HTML? | Form hỗ trợ gắn thuộc tính toolname; widget tự viết hay cần đọc kết quả thì gọi registerTool |
| Annotation an toàn | Agent gọi thoải mái, hay phải hỏi người dùng trước? | Tìm sản phẩm là readOnlyHint; thanh toán, xoá là consequentialHint; quyền vẫn kiểm trong execute |
| Điều kiện trình duyệt | Trình duyệt đích có thật sự có API này không? | Cần HTTPS và cô lập origin; không hỗ trợ thì trang vẫn chạy giao diện bình thường |
Mỗi tool nên làm đúng một việc, bộ tool càng nhỏ càng tốt, và giữ trong ngân sách ký tự: tên tối đa 30, mô tả tối đa 500, mô tả tham số tối đa 150, output tối đa 1.5K.
Prompt mẫu để biến form thành tool:
/ak-webmcp Biến form "Liên hệ hỗ trợ" ở trang <đường dẫn trang> thành tool WebMCP.
Ràng buộc: giữ nguyên validation và giao diện form hiện tại, người dùng vẫn thấy form.
Xong khi: validator không báo lỗi và Inspector thấy tool với đủ tham số.Skill này không có cờ. Sau tên lệnh bạn mô tả trang, form hoặc tính năng muốn biến thành tool. Các tuỳ chọn như --strict thuộc script đi kèm, không phải cờ của skill.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách ghi đầu vào, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-webmcp: biến trang, form có sẵn thành tool WebMCP cho agent" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-webmcp". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-webmcp
