Integração MCP

Conecte o Kubova ao Claude, Cursor, Cline, ChatGPT ou qualquer agente de IA compatível com MCP. Embale contêineres com uma única chamada de ferramenta.

1Conectar por URL (sem instalação)

Adicione o Kubova como conector remoto com uma única URL. Seu cliente de IA abre um login seguro na sua conta Kubova — sem chave de API, sem terminal.

https://kubova.com/mcp

Claude (claude.ai / Desktop): Settings → Connectors → Add custom connector → cole a URL.
ChatGPT: Settings → Apps & Connectors → ative o modo desenvolvedor → Create → cole a URL.
Cursor · VS Code: Adicione a URL como servidor MCP remoto; faça login quando solicitado.

As ferramentas executam com seu plano e cotas. Pro ou Team necessário para packing e relatórios (teste de 14 dias).

2Fale com ele

Reinicie seu cliente e pergunte à IA qualquer coisa que precise de embalagem de contêiner:

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

O agente chamará a ferramenta pack_containers tool, renderizará os posicionamentos e explicará o resultado.

Alternativa: instalação local (npm)

Prefere um servidor stdio local (configs offline, CI, n8n)? Use o pacote npm com uma chave de API.

Obter uma chave de 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

Ferramentas expostas

Ferramenta	Objetivo
pack_containers	Embala uma lista de SKUs em um ou mais contêineres. Retorna os posicionamentos por contêiner com x,y,z e utilização.
generate_report	Gerar um relatório PDF a partir de um resultado de pack anterior. Retorna uma URL de download.
estimate_capacity	Quantos conjuntos completos de um produto (1+ tipos de caixa por conjunto) cabem em um contêiner — empacotamento 3D real, com o fator limitante por contêiner.
verify_key	Verificação de integridade da chave de API — retorna identidade, escopos e limite de taxa.

Código-fonte

O servidor MCP é de código aberto no GitHub: Kubova-com/kubova-mcp.