Project
Ba công cụ list_projects, create_project và get_project để agent liệt kê project của bạn, tạo project từ bộ khởi đầu hoặc app mẫu, và đọc trạng thái của một project.
Agent chỉ thấy project của tài khoản manh.run đã đăng nhập khi kết nối MCP.
list_projects
Liệt kê project của bạn, mới nhất trước.
- Tham số: không có.
- Trả về: mỗi project một dòng:
id,name,publicSite(địa chỉ<id>.manh.run),createdAt. - Khi nào gọi: đầu phiên, để lấy id truyền cho các công cụ khác.
create_project
Tạo project mới với một bộ khởi đầu hoặc chép một app mẫu đang chạy. Database của app được tạo ở lần deploy đầu.
- Tham số:
name(bắt buộc): tên project, 1–60 ký tự.starter:auth(mặc định) hoặcblank.template: chépapp/vàspec/của một app mẫu đang chạy, thay chostarter. Database của app mới bắt đầu trống. Chọn theo loại app, không theo ngành:crm(pipeline bán hàng),kho-ban-hang(bán hàng từ tồn kho),sua-chua(nhận máy, báo giá, sửa, trả máy),duyet(đề xuất qua nhiều cấp duyệt),booking(đặt lịch theo giờ),qr-order(gọi món tại bàn bằng mã QR).region: nơi đặt database:asia_pacific(mặc định),north_america_east,north_america_west,europe_west,europe_east,oceania. Không đổi được sau lần deploy đầu.
- Trả về:
id(cũng là tên miền con của app, không đổi được), bộ khởi đầu hoặc mẫu đã dùng, danh sách file, các địa chỉ (publicSite,workspace) và bướcnext. Không dùng mẫu thì có thêm hai gợi ý cho bước lập kế hoạch: màn hình nhân viên dựng bằng khốiresource, và cách làm website công khai bằng khốiweb. - Khi nào gọi: khi bạn bảo agent làm app mới.
Bộ auth có sẵn đăng nhập và đăng ký bằng email và mật khẩu, nút đăng nhập Google, bảng người dùng, trang quản lý người dùng, khung app với menu theo vai trò và một theme. Vai trò khai báo trong app/auth.ts. Bộ blank chỉ có một trang, hợp với công cụ công khai một màn hình.
get_project
Đọc mọi thứ agent cần biết về một project.
- Tham số:
project. - Trả về:
idea: điều bạn gõ khi tạo project trong dashboard (nullnếu không gõ).urls:publicSitekèmpublicSiteShowsnói địa chỉ đó đang hiện app đã deploy hay bản xem trước;apisau lần deploy đầu;workspacelà trang dashboard của bạn, không đưa cho người dùng app.deployed,lastDeployedAt,fileCount,checkpoints,blocksđã ghép.auth: vai trò, vai trò mặc định, có cho tự đăng ký không, các cách đăng nhập.routes: mọi route API, ai được gọi (public,userhoặc danh sách vai trò) và file sinh ra route đó.npmPackages: gói npm đã ghim phiên bản;domain,telegramnếu đã kết nối.handover: những chỗ app còn lộ tên nền tảng trước khi bàn giao cho khách của bạn (tên app trên tab, chữ trên trang, người gửi email…), mỗi mục có trạng thái và gợi ý sửa.progressvànext: danh sách việc còn lại.
- Khi nào gọi: khi bắt đầu làm tiếp một project, và sau mỗi giai đoạn để xem còn thiếu gì.
Bước tiếp theo
- Lệnh của agent: các nhóm công cụ và thứ tự gọi.
- File: đọc và ghi cây
app/. - Đăng nhập và phân quyền: vai trò và
app/auth.ts.
Cập nhật