Guia do Kubova: do cadastro à integração com IA

Você pode experimentar a calculadora sem uma conta, mas o cadastro permite salvar planos de carregamento, exportar PDFs e usar a API. Começar é gratuito.

1. Acesse kubova.com e clique em Get started (canto superior direito).
2. Informe seu e-mail e uma senha e, em seguida, envie.
3. Verifique sua caixa de entrada para o e-mail de confirmação e clique no link para validar.
4. Pronto — você cairá direto no seu painel.

No painel ou no menu superior, abra a Calculator. O assistente conduz você por alguns passos rápidos:

1. Adicione sua carga: informe o comprimento, a largura e a altura da caixa (em cm), o peso (kg) e quantas você está enviando. Dê um nome e uma cor para que seja fácil identificá-la em 3D.
2. Defina as regras de empilhamento e rotação: permita que a caixa seja empilhada e girada, a menos que sua carga não possa (por exemplo, mercadorias do tipo 'este lado para cima').
3. Escolha um contêiner: 20ft, 40ft, 40HC ou defina suas próprias dimensões personalizadas.
4. Clique em Calculate — o plano fica pronto em segundos.

Dica: as dimensões são o tamanho de cada caixa, não do pallet.

A tela de resultado exibe um modelo 3D interativo do contêiner carregado, além dos números-chave:

1. Arraste para girar, role para dar zoom e inspecione exatamente onde cada unidade fica.
2. Unidades carregadas: quantas das suas caixas realmente cabem.
3. Aproveitamento do volume: quanto do espaço do contêiner é utilizado.
4. Peso: peso total carregado em relação ao limite de carga útil do contêiner.
5. Se algumas unidades não couberem, o Kubova informa quantas sobraram para que você possa decidir por um segundo contêiner ou uma configuração diferente.

Vai enviar caixas de tamanhos diferentes juntas? Adicione cada uma como um item de carga separado antes de calcular. O Kubova as empacota como uma única carga combinada — o que normalmente comporta mais do que planejar cada produto isoladamente. É aqui que ele supera as calculadoras simples de produto único.

Quando estiver satisfeito com um plano:

1. Clique em Save para guardá-lo no seu painel, em Saved packs.
2. Clique em Download PDF para gerar um plano de carregamento limpo e pronto para impressão — vistas 3D, contagem de unidades, aproveitamento e peso — pronto para compartilhar com sua equipe ou seu agente de carga.
3. Reabra qualquer pacote salvo depois para revisá-lo ou exportá-lo novamente.

Precisa da pergunta inversa — 'quantos conjuntos completos do meu produto cabem em um contêiner?' Use a ferramenta Capacity. Informe as caixas que compõem um conjunto e um contêiner; o Kubova retorna quantos conjuntos completos cabem com empacotamento 3D real e diz se o fator limitante é o espaço ou o peso.

O Kubova vem com um servidor MCP, para que assistentes de IA como Claude, ChatGPT e Cursor possam planejar carregamentos de contêiner para você em linguagem natural. Há duas formas de conectar.

Opção A — Conectar por URL (sem instalação)

A forma mais fácil. Adicione o Kubova como um conector remoto com uma única URL; seu cliente de IA abre um login seguro na sua conta do Kubova — sem API key, sem terminal.

URL do conector:

https://kubova.com/mcp

• Claude (claude.ai / Desktop): Settings → Connectors → Add custom connector → cole a URL.
• ChatGPT: Settings → Apps & Connectors → ative o Developer mode → Create → cole a URL.
• Cursor / VS Code: adicione a URL como um servidor MCP remoto e faça login quando solicitado.

Opção B — Instalação local (npm)

Prefere um servidor local (configuração offline, CI, ferramentas de automação)? Obtenha uma API key no seu painel e, em seguida, adicione isto ao arquivo de configuração do seu cliente 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

Depois reinicie seu cliente e simplesmente pergunte, por exemplo: 'Empacote 20 caixas de 50×40×30 cm em um contêiner 40HC — qual é o aproveitamento?' O assistente chama o Kubova, empacota a carga e explica o resultado.

O servidor MCP é open source no GitHub: Kubova-com/kubova-mcp.

Para seus próprios aplicativos e scripts, o mesmo mecanismo está disponível por meio de uma REST API — endpoints de empacotamento, capacidade e relatório em PDF, autenticados com uma API key. Consulte a referência da API para os formatos de requisição e resposta.