Skip to Content

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ặc blank.
    • template: chép app/ và spec/ của một app mẫu đang chạy, thay cho starter. 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ước next. 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ối resource, và cách làm website công khai bằng khối web.
  • 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 (null nếu không gõ).
    • urls: publicSite kèm publicSiteShows nói địa chỉ đó đang hiện app đã deploy hay bản xem trước; api sau lần deploy đầu; workspace là 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, user hoặc danh sách vai trò) và file sinh ra route đó.
    • npmPackages: gói npm đã ghim phiên bản; domain, telegram nế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.
    • progress và 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

Cập nhật