Como Conectar a Kondado ao Claude (Web, Desktop, Claude Code)

O Claude da Anthropic se transforma em um analista de dados conversacional quando conectado à Kondado. Com o Model Context Protocol (MCP), você consulta em linguagem natural os dados das 80+ fontes integradas na Kondado — ERPs, CRMs, e-commerce e marketing — sem sair do chat. Este guia cobre as três formas de conectar: Claude Web (via navegador), Claude Desktop (aplicativo) e Claude Code (linha de comando).

Endpoint único https://mcp.kondado.io/mcp funciona para Claude Web, Desktop e Code. Autenticação OAuth 2.1 automática — você só cadastra a URL e faz login na Kondado. Três modalidades: Web (mais rápido), Desktop (uso diário), Code (desenvolvedores e agentes). Bônus: Cursor IDE também aceita MCP. Primeira pergunta: "Quais tabelas eu tenho na Kondado?" para confirmar a conexão.

Para Quem é Este Guia

Este tutorial é ideal se você:

• É desenvolvedor ou analista de dados que quer explorar dados sem SQL manual
• Usa o Claude Desktop ou Claude Code no fluxo de trabalho diário
• É early adopter de ferramentas de IA e quer integrar dados empresariais
• Quer criar agentes automatizados que consultam dados via Claude Code
• Busca uma alternativa mais analítica ao ChatGPT para dados

Como Funciona a Conexão MCP

O MCP (Model Context Protocol) é um canal autenticado que liga o Claude diretamente aos dados da sua Via Kondado — o destino SQL da Kondado onde suas 80+ fontes são replicadas.

Fluxo de dados:

Fonte de dados (Bling, Meta Ads, etc.)
         ↓
    Kondado (replicação)
         ↓
  Via Kondado (SQL pronto)
         ↓
Claude + MCP (consultas em linguagem natural)

O Claude não acessa suas fontes diretamente. Ele consulta as tabelas já preparadas pela Kondado — atualizadas na frequência que você configurou na integração (diária, horária, etc.). Endpoint MCP da Via Kondado:

https://mcp.kondado.io/mcp

Método 1: Claude Web (Via Navegador)

O Claude Web é a forma mais rápida de começar — funciona em qualquer navegador, sem instalar nada.

Passo 1: Abrir Settings → Connectors

Acesse Settings → Connectors na barra lateral esquerda do Claude Web. Role até o final e clique em "Add custom connector".

Passo 2: Configurar o Conector

No modal "Add custom connector", preencha:

• Name: Kondado (ou Via Kondado — é apenas um rótulo)
• Remote MCP server URL: https://mcp.kondado.io/mcp (com o /mcp no final)
• Advanced settings: deixe os defaults — o OAuth é descoberto automaticamente

Clique em Add. O Claude valida que o servidor responde.

Passo 3: Disparar a Primeira Chamada

Abra um chat novo e peça algo que use a Kondado:

• "Quais ferramentas você tem disponíveis da Via Kondado?"
• "Liste as tabelas do Kondado."
• "Quanto eu gastei em Google Ads no último mês?"

Na primeira chamada, o Claude exibe um card "Authentication required to use this tool" com botão Connect. Clique em Connect.

Passo 4: Login na Kondado

Uma janela pop-up abre na tela de login da Kondado (app.kondado.com.br). Faça login com seu email e senha.

Passo 5: Autorizar e Escolher a Via Kondado

Aparece a tela "Authorize MCP access":

1. Confirme que você é o usuário correto ("Logged in as ...") 2. No dropdown Choose a Via Kondado destination, selecione qual Via Kondado o Claude deve consultar 3. Clique em Approve

Passo 6: Confirmação

A janela mostra "Authentication complete" e fecha automaticamente.

Passo 7: Permitir as Tool Calls

De volta no Claude, a ferramenta que estava aguardando autenticação executa automaticamente. A partir daí, em cada chamada o Claude pede permissão ("Claude wants to use Run query from Kondado") com botões Always allow / Deny.

Clique em Always allow se quiser parar de ver este pop-up para esta ferramenta.

Método 2: Claude Desktop (Aplicativo)

O Claude Desktop oferece a melhor experiência para uso diário — integra-se ao seu fluxo de trabalho com notificações nativas.

Configuração

1. Abra o Claude Desktop → Settings → Connectors 2. Clique em "Add custom connector" 3. Preencha: - Name: Kondado - Remote MCP server URL: https://mcp.kondado.io/mcp 4. Confirme

Autenticação

Na primeira chamada que use a Kondado, o Claude Desktop abre seu navegador padrão na mesma tela de consentimento dos Passos 4 a 6 do Claude Web. Após autorizar, o token fica salvo localmente e renova automaticamente.

Nota sobre versões: A Anthropic evolui a interface do Claude Desktop. Se sua versão exigir arquivo de configuração JSON ao invés do menu Settings, use o formato da seção Claude Code abaixo (mesma URL, mesma autenticação automática).

Método 3: Claude Code (CLI para Desenvolvedores)

O Claude Code é o CLI da Anthropic para terminal — ideal para desenvolvedores, scripts e automações.

Opção A: Comando Direto

claude mcp add kondado --transport http --url https://mcp.kondado.io/mcp

Opção B: Arquivo de Configuração

Adicione ao seu settings.json do Claude Code:

{
  "mcpServers": {
    "kondado": {
      "type": "http",
      "url": "https://mcp.kondado.io/mcp"
    }
  }
}

Autenticação no CLI

Na primeira tool call que use a Kondado, o Claude Code abre o navegador no mesmo fluxo OAuth dos Passos 4 a 6 do Claude Web. Após autorizar, o token fica salvo localmente e é renovado automaticamente.

Bônus: Cursor IDE (VS Code com IA)

O Cursor é um IDE baseado no VS Code com IA integrada que também suporta MCP. Se você desenvolve e quer consultar dados sem sair do editor, siga os passos:

Configuração no Cursor

1. Abra Cursor → Settings (Ctrl+, ou Cmd+,) 2. Busque por "MCP" ou vá em Features → MCP 3. Clique em "Add MCP Server" 4. Configure: - Name: kondado - URL: https://mcp.kondado.io/mcp - Transport: HTTP 5. Salve

Usando no Cursor

No chat do Cursor (Ctrl+L ou Cmd+L), você pode perguntar:

• "Mostre os últimos 10 pedidos do meu Shopify"
• "Qual o ROI das minhas campanhas do Meta Ads?"
• "Crie uma função Python que consulte vendas por categoria da Kondado"

O Cursor combina o contexto do seu código com os dados da Kondado — útil para gerar relatórios, validar hipóteses ou criar dashboards programáticos.

Exemplo Prático: Primeira Query nos Seus Dados

Após configurar em qualquer uma das três modalidades, teste com estas perguntas:

1. Explorar Estrutura

Quais tabelas eu tenho disponíveis na Via Kondado?

2. Análise de Vendas

Quanto faturei no Bling nos últimos 30 dias, por categoria de produto?

3. Marketing vs Vendas

Compare meu gasto no Google Ads com minha receita do Shopify no último mês.

4. Alerta de Estoque

Quais produtos no Tiny ERP estão com estoque abaixo de 10 unidades?

O Claude converte sua pergunta em KSQL (a linguagem JSON da Kondado), executa na Via Kondado e apresenta a resposta em linguagem natural — com tabelas formatadas, análises e sugestões.

Limitações e Cuidados Importantes

Limitações da v1

• Somente leitura: O MCP permite apenas consultas — nenhuma escrita, alteração ou exclusão
• KSQL obrigatório: As consultas usam sintaxe Kondado (JSON), não SQL bruto
• 1.000 linhas máximo: Cada execução retorna até 1.000 registros
• Uma Via por sessão: Cada sessão OAuth vincula a uma única Via Kondado

Boas Práticas

1. Troca de Via Kondado: Para alternar entre destinations, vá em Settings → Connectors, remova o conector e adicione novamente — escolhendo outra Via no consent.

2. Token expirou: O Claude renova automaticamente via refresh token. Se aparecer erro de autenticação, refaça a conexão (remover + adicionar).

3. Tabelas não aparecem: Verifique se selecionou a Via Kondado correta na tela de autorização. O conector só vê as tabelas daquela destination específica.

4. Permissão a cada chamada: Clique em Always allow na primeira vez para cada ferramenta e parar de ver o pop-up.

5. Pop-up bloqueado: Desative bloqueadores de pop-up para a aba do Claude — a tela de consent abre em janela secundária.

FAQ: Perguntas Frequentes

O que é o Kondado MCP no Claude?

É um canal autenticado que liga o Claude diretamente aos dados da sua Via Kondado. Depois de configurado, você faz perguntas em linguagem natural ("liste minhas tabelas", "quanto gastei em Google Ads") e o Claude monta as consultas KSQL automaticamente.

Preciso pagar no Claude para usar MCP?

A configuração de servidores MCP customizados depende da política atual da Anthropic. Quem vê Settings → Connectors → Add custom connector no Claude Web pode adicionar a Via Kondado. Claude Desktop e Claude Code aceitam a mesma configuração em qualquer conta Anthropic. Consulte sua conta para verificar disponibilidade.

Posso conectar mais de uma Via Kondado?

Cada sessão OAuth vincula a uma Via Kondado. Para alternar, remova o conector em Settings → Connectors e adicione novamente, escolhendo outra Via no consent.

O Claude vê todos os meus dados? É seguro?

O Claude só executa as consultas que você solicita e recebe os resultados via MCP. O acesso é autenticado por OAuth e limitado à Via Kondado que você escolheu. O MCP é somente leitura — nenhuma operação de escrita é permitida. Mantenha seu token em local seguro.

Funciona no celular?

O Claude Web funciona em navegadores mobile. O Claude Desktop é aplicativo desktop. O Claude Code requer terminal.

Posso usar com outras IDEs além do Cursor?

Qualquer IDE ou ferramenta que suporte MCP pode ser configurada com a URL https://mcp.kondado.io/mcp e autenticação OAuth ou token legado.

O que é KSQL?

KSQL é a linguagem de consulta JSON da Kondado. Ao invés de escrever SQL tradicional, você descreve a consulta em formato JSON — e o Claude faz isso automaticamente quando você pergunta em linguagem natural.

Próximos Passos

Agora que seu Claude está conectado à Kondado, explore:

• Artigo principal do Via Kondado — entenda o destino SQL por trás do MCP
• Guia do MCP — detalhes sobre OAuth vs token legado
• ChatGPT + Kondado — compare com a alternativa da OpenAI
• Conectores disponíveis — veja as 80+ fontes de dados suportadas

Inicie seu teste grátis de 14 dias na Kondado, conecte suas fontes de dados e transforme o Claude em seu analista de negócios pessoal — sem escrever uma linha de código.

Começar Teste Grátis →

---