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 → 개발자 모드를 활성화 → 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

그런 다음 클라이언트를 재시작하고 예를 들어 이렇게 물어보세요: '50×40×30 cm 박스 20개를 40HC 컨테이너에 패킹해 줘 — 활용률은 얼마야?' 어시스턴트가 Kubova를 호출하여 적재를 패킹하고 결과를 설명해 줍니다.

MCP 서버는 GitHub에서 오픈 소스로 공개되어 있습니다: Kubova-com/kubova-mcp.

자체 앱과 스크립트를 위해, 동일한 엔진을 REST API로 사용할 수 있습니다 — pack, capacity, PDF 리포트 엔드포인트를 API 키로 인증하여 호출합니다. 요청 및 응답 형식은 API 레퍼런스를 참고하세요.