• LÓGICA
  • VALIDAÇÃO
  • CORREÇÕES
  • HUMANO

Como depurar consultas SQL com seu AI usando Cube.dev

Conecte o Cube.dev ao seu agente para visualizar as consultas brutas que ele escreve. Você consegue identificar erros de lógica antes que eles afetem seus dados de produção.

Pergunte à IA sobre esta página

Resposta rápida

Como depuro o SQL que meu agente de IA está escrevendo?

Seu agente utiliza o MCP do Cube.dev para extrair as strings SQL exatas que gera para suas solicitações de dados. Você pode inspecionar essas consultas para encontrar falhas na lógica e executá-las diretamente para validar os resultados. Este guia mostra como identificar e corrigir esses erros.

Resultados da depuração

Onde você assume o controle.

A IA faz o trabalho pesado de construir a consulta, mas você mantém o controle total da lógica.

LÓGICA

Identificar joins incorretos

A IA extrai o SQL bruto para você conferir se as tabelas estão sendo unidas corretamente ou se falta algum filtro. Você verá exatamente por que um número parece errado.

VALIDAÇÃO

Executar e verificar

Ao encontrar uma consulta suspeita, você pode executá-la para ver o resultado real dos dados. Isso confirma se a lógica da IA condiz com o que você espera.

CORREÇÕES

Corrigir o agente

Quando a IA escreve um SQL incorreto, você pode apontar o erro específico na consulta. Ela usa esse feedback para reescrever o comando corretamente.

HUMANO

Supervisão manual

A IA não consegue reescrever seus modelos de dados no Cube.dev. Você continua sendo o dono da camada semântica e deve corrigir problemas de esquema por conta própria.

O fluxo

O que seu AI faz ao receber uma consulta.

O agente passa da interpretação da sua pergunta para a geração e o teste do código.

  1. Extrair SQL

    O agente analisa seu pedido de dados e gera a string SQL correspondente para a camada semântica do Cube.dev.

    get_sql

  2. Inspecionar código

    O agente apresenta o SQL gerado para que você revise a lógica antes de qualquer dado ser extraído.

    get_sql

  3. Testar execução

    Se você quiser ver os dados reais, o agente executa a consulta diretamente na sua instância do Cube.dev.

    execute_cube_sql

  4. Verificar resultados

    O agente usa o retorno da execução para confirmar se os dados batem com a sua pergunta original.

    execute_cube_sql

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar a depuração de suas consultas de dados.

Pontos de partida

Substitua o texto entre colchetes pelas suas métricas ou dimensões reais do Cube.dev.

Cube.dev Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_umZADPejupUUQHrfZkQT0lvv7MlK4j1JkrhOJOMy/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Cube.dev capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "cubedev-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_umZADPejupUUQHrfZkQT0lvv7MlK4j1JkrhOJOMy/mcp"
    }
  }
}
Copie no chat04

  • Mostre o SQL que você gerou para a métrica [total revenue] no Cube.dev.

  • O SQL para [active users] parece errado. Pode me mostrar a consulta exata que você está usando?

  • Execute esta consulta SQL no Cube.dev e me diga o resultado para [last month]: [cole o sql aqui]

  • Por que você fez o join da tabela [orders] com [users] nessa última consulta? Mostre-me o SQL.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Cube.dev uma vez e pronto.

Basta fornecer suas credenciais uma única vez. Sua conexão é criptografada e permanece segura. Depois, você pode depurar consultas em qualquer cliente compatível com MCP.

Conectar Cube.dev ao seu AI

FAQ

Como funciona o processo de depuração.

  • 01

    A IA pode alterar meus modelos de dados no Cube.dev?

    Não. A IA apenas lê os modelos existentes e gera SQL com base neles. Você deve atualizar sua camada semântica manualmente.

  • 02

    A IA executa consultas automaticamente?

    Não. O agente só executa consultas quando você solicita especificamente que ele rode ou verifique os dados.

  • 03

    Posso ver o SQL antes de ele ser executado?

    Sim. Você pode pedir ao agente para mostrar o SQL gerado antes de autorizar a execução.

  • 04

    O que acontece se o SQL for inválido?

    O agente receberá um erro do Cube.dev e poderá usar essa mensagem de erro para tentar corrigir a consulta.

  • 05

    A IA pode deletar dados no meu banco de dados?

    Não. Este MCP possui apenas ferramentas para recuperar SQL e executar consultas. Ele não realiza operações de exclusão ou atualização.

  • Mais dúvidas sobre o Cube.dev? Veja tudo o que o conector Cube.dev pode fazer

Conecte Cube.dev ao Claude, Cursor, ChatGPT e outros