Tóm tắt nhanh:
ak-agentizebọc code đang chạy (module, hàm, API) thành CLI, MCP server hoặc cả hai để AI agent gọi được, mà không đổi hành vi cũ. Nó kiểm qua từng lối vào và chỉ phát hành khi bạn yêu cầu. Nó không viết server mới từ đầu: việc đó dành choak-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 có code đang chạy và muốn Claude Code, Cursor hay script CI gọi được nó như một lệnh hoặc một tool. Không cần khi chưa có code và muốn dựng MCP server mới từ đầu: dùng ak-mcp-builder.
flowchart LR
A["Code hoặc API sẵn có"] --> B["ak-agentize"]
B --> C["CLI"]
B --> D["MCP server"]
B --> E["Cả hai, chung một lõi"]
C --> F["Báo sẵn sàng"]
D --> F
E --> F
F --> G["Phát hành, chỉ khi bạn yêu cầu"]
H["Chưa có code, cần server mới"] --> I["ak-mcp-builder"]Bốn khái niệm nó dựa vào khi bọc code:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Bản đồ agent hoá | Thao tác nào được mở ra cho agent, và mỗi thao tác chạm tới gì? | Thao tác "tạo đơn": đầu vào là tên khách và danh sách món, có ghi vào DB, cần quyền nhân viên, kiểm bằng một lần gọi thử qua MCP. |
| Bề mặt | Ai sẽ gọi, và gọi từ đâu? | Agent trên máy bạn gọi qua stdio. Đồng đội dùng Claude Code gọi server từ xa qua Streamable HTTP, có đăng nhập. |
| Lõi và adapter | Logic nghiệp vụ nằm ở đâu? | Hàm tạo đơn giữ nguyên chỗ cũ. CLI và MCP chỉ dịch tham số, gọi hàm đó, rồi định dạng kết quả. |
| Sẵn sàng khác phát hành | Xong nghĩa là đã lên npm hay đã deploy chưa? | Prompt không nói phát hành: bạn nhận báo cáo sẵn sàng. Prompt nói "publish lên npm": nó kiểm tra gói cài được và có biên nhận phát hành. |
Khi thiết kế, nó gom nhiều bước thành một thao tác theo đúng việc agent cần, trả kết quả gọn, lỗi nói rõ nên thử gì tiếp. Thao tác ghi có chạy thử, thao tác xoá cần xác nhận rõ ràng.
Prompt mẫu cho MCP server chạy trên máy:
/ak-agentize src/inventory --mcp
Kết quả: Claude Code trên máy tôi gọi được tool tra tồn kho và đặt hàng bổ sung.
Ràng buộc: chạy cục bộ, không mở cổng ra ngoài.
Xong khi: gọi thử được cả hai tool từ Claude Code, lỗi đầu vào trả thông báo rõ.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--both, --mcp, --cli | Chọn bề mặt sẽ dựng | 1.0.0 |
--auto | Tự phân tích, tự quyết, tự làm | 1.0.0 |
--ask | Chất vấn bạn trước khi dựng | 1.0.0 |
--ultra | 5 bản quyết định độc lập, chọn bản tốt nhất | 2.13.0 |
--advice | Model mạnh hơn góp ý ở mốc quan trọng | 2.13.0 |
--yagni | Cắt phần không cần cho kết quả | 2.8.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, giải thích từng cờ, 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-agentize: bọc code sẵn có thành CLI, MCP 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-agentize". 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-agentize
