MCP 연동

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

1API 키 발급받기

MCP 액세스에는 REST API와 동일한 Pro API key가 필요합니다. 14일 무료 체험을 이용하실 수 있습니다.

2클라이언트 설정

이를 MCP 클라이언트의 설정 파일에 추가하세요. npx 명령은 첫 실행 시 @kubova/mcp 패키지를 다운로드합니다.

Claude Code · Claude Desktop · Cursor · Cline:

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

3대화하기

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

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

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

제공되는 도구

도구	목적
pack_containers	SKU 목록을 하나 이상의 컨테이너에 적재합니다. x, y, z 좌표 및 사용률이 포함된 컨테이너별 배치 정보를 반환합니다.
verify_key	API 키의 유효성을 검사합니다 — 신원, 범위 및 속도 제한을 반환합니다.

소스 코드

MCP 서버 소스는 Kubova 모노레포의 다음 경로에 있습니다: services/mcp-server.