Tóm tắt nhanh:
ak-mcp-builderdựng server MCP để AI dùng được service hoặc API của bạn: làm trọn một tool, gọi thử bằng client thật, rồi mới thêm tool. Nó chỉ đăng lên MCP Registry khi bạn yêu cầu. Nó không cấu hình client và không gọi server có sẵn.
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ó một service hoặc API và muốn AI dùng nó qua MCP, khi cần nâng server cũ lên SDK v2, review bộ tool, đo xem AI dùng tool tốt không, hoặc đăng server lên MCP Registry. Không cần khi bạn chỉ muốn cấu hình client hay gọi tool của một server MCP có sẵn.
flowchart LR
A["Service hoặc API cần cho AI dùng"] --> B["ak-mcp-builder"]
B --> C["Server MCP, tool đã gọi thử thật"]
C --> D["Thêm tool khi quy trình cần"]
C --> E["MCP Registry, chỉ khi bạn yêu cầu"]
C --> F["Dừng, báo phần chưa kiểm"]Những điều cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Hợp đồng của tool đầu tiên | Tool nhận gì, trả gì, có tác dụng phụ không, cần quyền gì? | crm_search_contacts nhận query, limit, offset; trả một trang có has_more; chỉ đọc; API key lấy từ biến môi trường |
| Transport | Server chạy cho một người trên máy, hay cho nhiều người qua mạng? | Local một người dùng stdio; remote nhiều người dùng Streamable HTTP; không dùng HTTP+SSE cũ |
| Annotation chỉ là gợi ý | Ai thật sự chặn một hành động phá huỷ? | readOnlyHint, destructiveHint chỉ giúp giao diện host; server tự kiểm quyền và hỏi xác nhận trước khi xoá |
| Hai lớp kiểm tra | Bằng chứng nào cho thấy server dùng được? | Gọi thật bằng MCP Inspector hoặc SDK client; rồi bộ câu hỏi chỉ đọc chạy qua script chấm |
Project đang dùng SDK v1 thì skill giữ nguyên, chỉ nâng lên v2 khi bạn yêu cầu hoặc khi tính năng cần làm đòi v2. Đăng ký được tool hay tools/list sạch chưa tính là xong.
Prompt mẫu cho một server mới:
/ak-mcp-builder <tên service>
Kết quả: AI tìm được khách hàng theo tên hoặc email qua tool MCP.
Ràng buộc: chạy local trên máy tôi, API key đọc từ biến môi trường <TÊN_BIẾN>.
Không làm: tool sửa hoặc xoá dữ liệu.
Xong khi: gọi tool bằng MCP Inspector ra kết quả đúng.Skill này không có cờ. Sau tên lệnh, bạn ghi service hoặc API cần tích hợp, rồi ghi tiếp kết quả, ràng buộc, xong khi nào trong cùng prompt.
Phần dưới đây là bản chi tiết: luồng chạy, 6 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-mcp-builder: dựng server MCP cho AI gọi service của bạn" 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-mcp-builder". 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-mcp-builder
