Lệnh của agent
Agent dựng app trên manh.run bằng các công cụ MCP; trang này liệt kê từng nhóm công cụ, hai bộ công cụ theo địa chỉ kết nối và thứ tự gọi trong một phiên làm app.
manh.run không tự viết code. Agent của bạn (Claude Code, ChatGPT, Gemini, Cursor…) kết nối tới https://mcp.manh.run, đọc tài liệu, ghi file vào app/, chạy check rồi deploy. Mỗi việc đó là một công cụ, giống lệnh CLI của các framework khác.
Các nhóm công cụ
| Nhóm | Công cụ | Việc |
|---|---|---|
| Project | list_projects · create_project · get_project | Liệt kê, tạo và xem project |
| File | list_files · read_files · write_files · delete_files | Đọc và ghi cây app/ |
| check | check | Tìm lỗi trước khi deploy |
| deploy | deploy | Đưa giao diện và API lên cùng lúc, rồi chạy bài kiểm tra |
| Kiểm thử | run_acceptance · create_test_accounts · remove_test_accounts | Bài kiểm tra nghiệp vụ, tài khoản thử theo vai |
| Checkpoint | checkpoint · restore_checkpoint | Lưu và khôi phục cây file |
| Database | db_query · db_exec | Đọc và ghi database của app |
| Log | logs | Request, log, lưu lượng, số liệu |
| Secret | env_set · env_list | Khoá API và token của dịch vụ ngoài |
| Khối tính năng | blocks · block_plan · block_add | Ghép tính năng đã kiểm thử vào app |
| Cron | cron_jobs · cron_runs · cron_control | Xem và điều khiển việc định kỳ |
| Dữ liệu ngoài | integrations · integration_sql | Supabase của chủ app |
| Ảnh | list_images · upload_image | Ảnh thật của chủ app cho website |
| Tài liệu | framework_docs | Tài liệu framework cho agent |
Mọi công cụ làm việc trên một project nhận tham số project: id của project, lấy từ list_projects. Agent chỉ thấy project của tài khoản đã đăng nhập khi kết nối.
Hai bộ công cụ
manh.run có hai địa chỉ MCP, khác nhau ở những công cụ ghi dữ liệu thật hoặc nhận khoá bí mật.
https://mcp.manh.run: bộ đầy đủ, dành cho Claude Code, Cursor, Codex và connector tự thêm.https://mcp.manh.run/directory: bộ dùng cho danh mục app của ChatGPT. Không cóenv_set,db_exec,integrations,integration_sql.write_fileskhông xoá file; việc xoá là công cụ riêngdelete_files.deploykhông cóforce.
Ở bộ thu gọn, bạn đặt secret trong dashboard (trang Secret của project) và sửa dữ liệu qua API của app hoặc tab Cơ sở dữ liệu.
Một phiên làm app
Agent thường gọi theo thứ tự này. Kết quả của write_files, check, deploy, get_project và create_project kết thúc bằng mục Progress và một dòng next: gợi ý bước kế tiếp, nên agent yếu cũng đi hết được.
1. framework_docs("process"), ("framework"), ("pro") đọc quy ước trước khi viết
2. list_projects / create_project chọn hoặc tạo project
3. write_files theo giai đoạn bảng + repository → handler → layout + trang
4. check({ typecheck: true }) sửa hết lỗi
5. deploy API trả 503 cho tới lần deploy đầu; kèm kết quả kiểm thử
6. run_acceptance sửa tới khi mọi bài trong spec/acceptance.json qua
7. remove_test_accounts, checkpoint dọn tài khoản thử, lưu một mốc có nhãnCần biết
- Ghi file không bao giờ deploy. App chạy thật chỉ đổi khi agent gọi
deployhoặc bạn bấm Deploy. - Bạn thấy từng lần ghi file ngay trong bản xem trước ở dashboard.
- Lỗi trả về có dạng
MÃ_LỖI: việc cần làm, để agent tự sửa mà không phải đoán.
Bước tiếp theo
- Deploy app: deploy làm gì và cái gì chạy thật.
- Quy tắc check: các lớp kiểm tra và luật chính.
- App đầu tiên: đi từ ý tưởng tới app chạy thật.