Skip to Content

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ómCông cụViệc
Projectlist_projects · create_project · get_projectLiệt kê, tạo và xem project
Filelist_files · read_files · write_files · delete_filesĐọc và ghi cây app/
checkcheckTìm lỗi trước khi deploy
deploydeployĐư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_accountsBài kiểm tra nghiệp vụ, tài khoản thử theo vai
Checkpointcheckpoint · restore_checkpointLưu và khôi phục cây file
Databasedb_query · db_execĐọc và ghi database của app
LoglogsRequest, log, lưu lượng, số liệu
Secretenv_set · env_listKhoá API và token của dịch vụ ngoài
Khối tính năngblocks · block_plan · block_addGhép tính năng đã kiểm thử vào app
Croncron_jobs · cron_runs · cron_controlXem và điều khiển việc định kỳ
Dữ liệu ngoàiintegrations · integration_sqlSupabase của chủ app
Ảnhlist_images · upload_imageẢnh thật của chủ app cho website
Tài liệuframework_docsTà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_files không xoá file; việc xoá là công cụ riêng delete_files. deploy khô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ãn

Cần biết

  • Ghi file không bao giờ deploy. App chạy thật chỉ đổi khi agent gọi deploy hoặ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

Cập nhật