Hướng dẫn Kubova: từ đăng ký đến tích hợp AI

Bạn có thể dùng thử công cụ tính mà không cần tài khoản, nhưng đăng ký sẽ cho phép lưu sơ đồ, xuất PDF và dùng API. Bắt đầu miễn phí.

1. Mở kubova.com và nhấn Get started (góc trên bên phải).
2. Nhập email và mật khẩu, rồi gửi.
3. Kiểm tra hộp thư để nhận email xác nhận và nhấn vào liên kết để xác minh.
4. Xong — bạn sẽ vào thẳng bảng điều khiển (dashboard).

Từ dashboard hoặc menu trên cùng, mở Calculator. Trình hướng dẫn đưa bạn qua vài bước ngắn:

1. Thêm hàng hóa: nhập chiều dài, rộng, cao của thùng (theo cm), trọng lượng (kg), và số lượng xuất. Đặt tên và màu để dễ nhận ra trong 3D.
2. Đặt quy tắc xếp chồng và xoay: cho phép xếp chồng lên thùng và xoay thùng, trừ khi hàng không cho phép (ví dụ hàng 'this side up' — chỉ được dựng một chiều).
3. Chọn container: 20ft, 40ft, 40HC, hoặc tự định nghĩa kích thước riêng.
4. Nhấn Calculate — sơ đồ sẵn sàng trong vài giây.

Mẹo: kích thước là của từng thùng carton, không phải của pallet.

Màn hình kết quả hiển thị mô hình 3D tương tác của container đã xếp cùng các con số chính:

1. Kéo để xoay, lăn chuột để phóng to, và xem chính xác từng kiện nằm ở đâu.
2. Số kiện đã xếp: bao nhiêu thùng carton của bạn thực sự vừa.
3. Tỉ lệ tận dụng thể tích: bao nhiêu phần không gian container được dùng.
4. Trọng lượng: tổng tải đã xếp so với giới hạn tải của container.
5. Nếu một số kiện không vừa, Kubova cho biết còn dư bao nhiêu để bạn quyết định dùng container thứ hai hay cấu hình khác.

Xuất nhiều cỡ thùng cùng lúc? Hãy thêm từng loại thành một mục hàng riêng trước khi tính. Kubova xếp chúng thành một lô gộp duy nhất — thường vừa được nhiều hơn so với lên kế hoạch từng sản phẩm riêng lẻ. Đây là điểm Kubova vượt các công cụ chỉ tính một sản phẩm.

Khi đã hài lòng với một sơ đồ:

1. Nhấn Save để lưu vào dashboard, mục Saved packs.
2. Nhấn Download PDF để có sơ đồ xếp hàng sạch sẽ, in được — gồm hình 3D, số kiện, tỉ lệ tận dụng và trọng lượng — sẵn sàng gửi cho đội ngũ hoặc đơn vị giao nhận.
3. Mở lại bất kỳ sơ đồ đã lưu để xem hoặc xuất lại sau.

Cần câu hỏi ngược lại — 'một container chứa được bao nhiêu bộ sản phẩm hoàn chỉnh?' Hãy dùng công cụ Capacity. Nhập các thùng tạo thành một bộ và một container; Kubova trả về số bộ đầy đủ vừa được bằng phép xếp 3D thật, và cho biết yếu tố giới hạn là không gian hay trọng lượng.

Kubova có sẵn MCP server, nên các trợ lý AI như Claude, ChatGPT và Cursor có thể lên kế hoạch xếp container giúp bạn bằng ngôn ngữ tự nhiên. Có hai cách kết nối.

Cách A — Kết nối bằng URL (không cần cài đặt)

Cách dễ nhất. Thêm Kubova làm remote connector chỉ bằng một URL; trình AI của bạn sẽ mở một phiên đăng nhập an toàn vào tài khoản Kubova — không cần API key, không cần terminal.

URL kết nối:

https://kubova.com/mcp

• Claude (claude.ai / Desktop): Settings → Connectors → Add custom connector → dán URL.
• ChatGPT: Settings → Apps & Connectors → bật Developer mode → Create → dán URL.
• Cursor / VS Code: thêm URL làm remote MCP server và đăng nhập khi được hỏi.

Cách B — Cài cục bộ (npm)

Thích chạy server cục bộ (file cấu hình offline, CI, công cụ tự động hóa)? Lấy một API key từ dashboard, rồi thêm đoạn sau vào file cấu hình của trình MCP:

{
  "mcpServers": {
    "kubova": {
      "command": "npx",
      "args": ["-y", "@kubova/mcp@latest"],
      "env": {
        "KUBOVA_API_KEY": "kbv_..."
      }
    }
  }
}

Claude Desktop: claude_desktop_config.json · Cursor: ~/.cursor/mcp.json · Claude Code: ~/.claude/settings.json

Sau đó khởi động lại trình AI và chỉ cần hỏi, ví dụ: 'Xếp 20 thùng 50×40×30 cm vào container 40HC — tỉ lệ tận dụng bao nhiêu?' Trợ lý sẽ gọi Kubova, xếp hàng, và giải thích kết quả.

MCP server là mã nguồn mở trên GitHub: Kubova-com/kubova-mcp.

Cho ứng dụng và script của riêng bạn, cùng engine đó có sẵn qua REST API — các endpoint pack, capacity và báo cáo PDF, xác thực bằng API key. Xem tài liệu API để biết định dạng request và response.