Kubova 指南：从注册到 AI 集成

你无需账户即可试用计算器，但注册后可以保存装载方案、导出 PDF 并使用 API。免费即可开始。

1. 打开 kubova.com 并点击右上角的 Get started。
2. 输入你的邮箱和密码，然后提交。
3. 查收收件箱中的确认邮件，并点击链接完成验证。
4. 完成——你将进入自己的仪表板。

在仪表板或顶部菜单中打开 Calculator。向导会引导你完成几个简短步骤：

1. 添加你的货物：输入箱子的长、宽、高（单位 cm）、重量（kg）以及装运数量。给它起个名字并选个颜色，方便在 3D 视图中识别。
2. 设置堆叠和旋转规则：允许箱子被堆叠和旋转，除非你的货物不能这样（例如“此面朝上”的货物）。
3. 选择集装箱：20ft、40ft、40HC，或自定义你自己的尺寸。
4. 点击 Calculate——方案数秒内即可生成。

提示：尺寸指的是每个纸箱的大小，而非托盘。

结果页面会显示已装载集装箱的交互式 3D 模型以及关键数据：

1. 拖动可旋转，滚动可缩放，精确查看每一件货物的摆放位置。
2. 已装载件数：实际装下了多少个你的纸箱。
3. 容积利用率：集装箱空间的使用比例。
4. 重量：已装载总重量与集装箱载重上限的对比。
5. 如果有部分件数装不下，Kubova 会告诉你还剩多少，方便你决定是否使用第二个集装箱或采用不同的方案。

需要把不同尺寸的箱子一起装运？在计算前将每一种都作为单独的货物项添加。Kubova 会把它们作为一个合并装载方案进行装箱——这通常比单独规划每种产品装得更多。这正是它胜过简单的单产品计算器之处。

当你对某个方案满意后：

1. 点击 Save 将其保存到仪表板的 Saved packs 中。
2. 点击 Download PDF 获取整洁、可打印的装载方案——包含 3D 视图、件数、利用率和重量——可直接分享给你的团队或货运代理。
3. 之后随时重新打开任何已保存的方案以查看或再次导出。

需要反过来问——“一个集装箱能装下多少套完整的产品？”请使用 Capacity 工具。输入构成一套的纸箱以及一个集装箱；Kubova 会通过真实 3D 装箱返回能装下多少完整套数，并告诉你限制因素是空间还是重量。

Kubova 自带一个 MCP 服务器，因此 Claude、ChatGPT 和 Cursor 等 AI 助手可以用自然语言为你规划集装箱装载。有两种连接方式。

方案 A——通过 URL 连接（无需安装）

最简单的方式。用一个 URL 将 Kubova 添加为远程连接器；你的 AI 客户端会打开一个安全的登录页面以接入你的 Kubova 账户——无需 API 密钥，无需终端。

连接器 URL：

https://kubova.com/mcp

• Claude（claude.ai / Desktop）：Settings → Connectors → Add custom connector → 粘贴该 URL。
• ChatGPT：Settings → Apps & Connectors → 启用 Developer mode → Create → 粘贴该 URL。
• Cursor / VS Code：将该 URL 添加为远程 MCP 服务器，并在提示时登录。

方案 B——本地安装（npm）

更喜欢本地服务器（离线配置、CI、自动化工具）？从你的仪表板获取一个 API 密钥，然后将以下内容添加到你的 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

然后重启你的客户端，直接提问即可，例如：“把 20 个 50×40×30 cm 的箱子装进一个 40HC 集装箱——利用率是多少？”助手会调用 Kubova，完成装箱，并解释结果。

该 MCP 服务器在 GitHub 上开源： Kubova-com/kubova-mcp.

对于你自己的应用和脚本，同一套引擎可通过 REST API 使用——提供装箱、容量和 PDF 报告端点，使用 API 密钥进行身份验证。请参阅 API 参考文档了解请求和响应格式。