MCP 연동

Kubova를 Claude, Cursor, Cline, ChatGPT 또는 모든 MCP 지원 AI 에이전트에 연결하세요. 단 한 번의 도구 호출로 컨테이너를 적재할 수 있습니다.

1URL로 연결(설치 불필요)

URL 하나로 Kubova를 원격 커넥터로 추가하세요. AI 클라이언트가 Kubova 계정으로 안전한 로그인을 엽니다 — API 키도, 터미널도 필요 없습니다.

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 서버로 추가하고 안내에 따라 로그인하세요.

도구 호출은 사용자의 플랜과 할당량으로 실행됩니다. 패킹과 리포트에는 Pro 또는 Team이 필요합니다(14일 체험 제공).

2대화하기

클라이언트를 재시작한 다음, 컨테이너 적재가 필요한 작업을 AI에게 요청해 보세요:

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

에이전트가 pack_containers 도구를 호출하고, 배치 결과를 렌더링하여 설명해 줍니다.

대안: 로컬 설치(npm)

로컬 stdio 서버(오프라인 설정, CI, n8n)를 선호하시나요? API 키와 함께 npm 패키지를 사용하세요.

API 키 발급받기 →

{
  "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

제공되는 도구

도구	목적
pack_containers	SKU 목록을 하나 이상의 컨테이너에 적재합니다. x, y, z 좌표 및 사용률이 포함된 컨테이너별 배치 정보를 반환합니다.
generate_report	이전 팩 결과에서 PDF 보고서 생성. 다운로드 URL을 반환합니다.
estimate_capacity	하나의 컨테이너에 제품의 완전한 세트(세트당 1개 이상의 카톤 유형)가 몇 개 들어가는지 — 실제 3D 적재, 컨테이너별 제한 요인 포함.
verify_key	API 키의 유효성을 검사합니다 — 신원, 범위 및 속도 제한을 반환합니다.

소스 코드

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