Tích hợp MCP

Cắm Kubova vào Claude, Cursor, Cline, ChatGPT, hoặc bất kỳ AI agent MCP nào. Xếp container bằng 1 tool call.

1Kết nối bằng URL (không cần cài đặt)

Thêm Kubova làm remote connector chỉ với một URL. AI client sẽ mở đăng nhập an toàn vào tài khoản Kubova của bạn — không cần API key, không cần terminal.

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; đăng nhập khi được hỏi.

Tool chạy theo gói và hạn mức của bạn. Cần Pro hoặc Team cho packing và báo cáo (có trial 14 ngày).

2Trò chuyện

Restart client, hỏi AI bất cứ thứ gì cần xếp container:

> Pack 20 boxes of 50x40x30 cm into a 40HC container.
> What's the utilization?

Agent sẽ gọi tool pack_containers, render placements, giải thích kết quả.

Cách khác: cài local (npm)

Muốn dùng stdio server local (file config offline, CI, n8n)? Dùng npm package với API key.

Lấy API key →

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

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

Tools available

Tool	Mục đích
pack_containers	Xếp danh sách SKU vào 1 hoặc nhiều container. Trả placements (x,y,z) per container + utilization.
generate_report	Tạo báo cáo PDF từ kết quả pack trước đó. Trả về URL tải xuống.
estimate_capacity	Bao nhiêu bộ sản phẩm trọn vẹn (1+ loại carton mỗi bộ) xếp vừa một container — xếp 3D thật, kèm yếu tố giới hạn của từng container.
verify_key	Sanity check API key — trả identity, scopes, rate limit.

Source

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