MCP da Kondado: Como Conectar Seus Dados Empresariais ao ChatGPT, Claude, Codex e Claude Code

A Kondado replica dados de 80+ fontes para um destino SQL e expõe esse destino, via Model Context Protocol (MCP), para os principais clientes de IA do mercado. Isso significa que você abre o ChatGPT, o Claude, o Codex ou o Claude Code, faz uma pergunta em português sobre seus pedidos no Bling, seu custo no Meta Ads ou seu funil no RD Station CRM, e a IA responde lendo os dados que a Kondado já consolidou. Sem código, sem cópia manual, sem export de CSV.

Resumo

• Endpoint único: todos os clientes de IA conectam em https://mcp.kondado.io/mcp, com autenticação OAuth 2.1 automática.
• 2 apps com guias dedicados: ChatGPT (inclui Web, Desktop e Codex CLI da OpenAI) e Claude (inclui Web, Desktop e Claude Code CLI da Anthropic). Demais clientes compatíveis com o protocolo MCP também funcionam via token legado.
• Funciona porque a Kondado já consolidou os dados: o MCP consulta a Via Kondado, onde seus 80+ conectores já replicam para tabelas SQL prontas, na frequência que você escolher na integração.
• Limites honestos: o MCP é somente leitura, retorna no máximo 1.000 linhas por execução, e usa KSQL (linguagem de consulta JSON da Kondado, não SQL bruto).

O que é o MCP da Kondado?

O Model Context Protocol é um padrão aberto criado pela Anthropic em 2024 para permitir que clientes de IA, como ChatGPT e Claude, leiam dados de fontes externas sob demanda, sem que você precise programar uma integração customizada.

O MCP da Kondado é o servidor MCP oficial da plataforma. Ele expõe a sua Via Kondado (a área de destino onde seus dados já foram replicados) como uma fonte consultável por qualquer cliente de IA que fale o protocolo MCP.

A arquitetura é direta:

1. Seus conectores Kondado (Bling, RD Station, Google Ads, GA4, Omie, Shopify, VTEX, Meta Ads e outros 80+) extraem os dados das APIs originais.
2. A Kondado consolida tudo em tabelas SQL dentro da sua Via Kondado.
3. O servidor MCP transforma essa Via em uma fonte que ChatGPT, Claude, Codex e Claude Code conseguem consultar.
4. Você pergunta em linguagem natural; o cliente de IA gera a consulta KSQL, executa via MCP, e devolve a resposta.

Por que usar MCP em vez de chamar a API original direto?

Conectar um cliente de IA na API do Bling, no GA4 ou no Meta Ads parece tentador, mas falha em três pontos práticos que a Via Kondado resolve.

Quota e rate limit

APIs comerciais protegem o tráfego com cotas diárias e por hora. O GA4, por exemplo, libera 200 mil tokens por dia por propriedade, compartilhados entre todos os apps que consultam aquela conta. Se você deixar o ChatGPT consultar o GA4 direto, cada prompt consome cota, e seus relatórios oficiais começam a falhar. A Kondado replica uma vez por hora (frequência padrão) e o cliente de IA consulta o destino SQL, que não tem cota.

Latência por chamada

Quando o cliente de IA chama uma API REST direto, cada pergunta dispara autenticação, paginação e parsing. Em fontes lentas (ERPs brasileiros, Bling, Omie, Conta Azul), isso significa segundos de espera por prompt. Consultar a Via Kondado é uma consulta SQL, na casa dos milissegundos.

Cruzamento entre fontes

Esse é o ponto que decide o jogo. Você não consegue perguntar diretamente "qual campanha do Meta Ads gerou mais pedidos pagos no Bling no mês passado?" para nenhuma das duas APIs originais. Ninguém sabe responder isoladamente: nem o Meta, nem o Bling. A pergunta exige que os dois conjuntos de dados estejam no mesmo lugar. A Kondado consolida tudo na mesma Via, e o MCP permite que a IA cruze as fontes em uma única consulta.

Quais clientes de IA você pode conectar?

A Kondado documenta dois apps com guias dedicados — ChatGPT e Claude — e o servidor MCP atende a todas as suas interfaces com o mesmo endpoint.

ChatGPT, Desktop e Codex (OpenAI)

O guia da Kondado para a família OpenAI cobre três interfaces em um só artigo: chatgpt.com (Web), Desktop (Mac/Windows) e Codex CLI. Todas usam o mesmo endpoint https://mcp.kondado.io/mcp e o mesmo fluxo OAuth. A versão Web foi validada em conta Free/Personal; Desktop herda os conectores configurados na Web. A configuração leva menos de dois minutos: adicionar o endpoint, autorizar via OAuth, escolher sua Via Kondado.

Claude, Desktop e Claude Code (Anthropic)

O guia da Kondado para a família Anthropic cobre três interfaces em um só artigo: claude.ai (Web), Desktop e Claude Code CLI. O Claude Web e Desktop adicionam o MCP em Settings → Connectors → Add custom connector; o Claude Code usa o comando claude mcp add kondado ou um bloco JSON no settings.json. O fluxo OAuth descobre automaticamente as configurações pelo endpoint /mcp — você só precisa colar a URL.

Como configurar o MCP da Kondado em 3 passos?

Quem já tem conta na Kondado conecta o primeiro cliente de IA em menos de 5 minutos. Quem está começando, faz tudo em uma sessão.

1. Conecte uma fonte de dados na Kondado. Escolha entre os 80+ conectores (Bling, RD Station, Google Ads, GA4, Omie, Shopify, Meta Ads, e os demais). A Kondado autentica via OAuth, oferece replicação na frequência que você escolher na integração, e direciona o dado para a sua Via Kondado.
2. Configure a Via Kondado como destino. A Via é uma área SQL incluída na sua conta. Você pode também replicar para Postgres, BigQuery, Redshift, Looker Studio, Power BI e outros destinos.
3. Adicione o servidor MCP no seu cliente de IA. Cole a URL https://mcp.kondado.io/mcp em Settings → Connectors (ChatGPT, Claude) ou via comando CLI (Claude Code, Codex). O OAuth dispara automaticamente; você autoriza a conexão; pronto.

A partir daí, você pergunta em português, no chat ou no terminal, e o cliente de IA gera a consulta KSQL, executa pelo MCP e devolve a resposta com os dados da sua conta.

Combinações que valem a pena perguntar à IA

A força do MCP da Kondado aparece quando você cruza fontes que, separadas, não conseguem responder à pergunta. Alguns exemplos práticos para os perfis mais comuns.

E-commerce: GA4 + Bling

Pergunte ao Claude: "No último mês, quais campanhas trouxeram tráfego no GA4 e geraram pedidos pagos no Bling? Quero o ROAS por campanha." O cliente de IA cruza ga4_traffic_acquisition_daily (sessões e custo por origem) com a tabela de pedidos do Bling, retorna o ROAS real.

Agência de marketing: Meta Ads + Google Ads + RD Station CRM

Pergunte ao ChatGPT: "Compare o custo por lead do Meta Ads e do Google Ads na campanha X no mês passado, e me diga quantos desses leads viraram oportunidade no RD CRM." As três fontes consolidadas na mesma Via permitem que a IA gere uma resposta com números fechados.

SMB com ERP: Omie + GA4

Pergunte ao Claude Code: "Quero ver a margem por categoria de produto dos últimos 90 dias no Omie, e cruzar com as visitas do GA4 nas páginas dos produtos correspondentes." A IA monta a consulta, retorna a tabela com margem e demanda lado a lado.

Análise de funil: HubSpot ou Pipedrive + Meta Ads

Pergunte ao Codex: "Quais campanhas do Meta Ads geraram contatos que hoje estão em estágio de proposta no HubSpot?" O cliente de IA atravessa a jornada do lead, do anúncio à oportunidade aberta.

Quais são os limites honestos do MCP da Kondado?

Para que a documentação seja útil, e para você confiar no que está respondendo ao seu cliente, gestor ou board, vale ser transparente sobre as restrições atuais da versão 1 do MCP.

Somente leitura

O MCP da Kondado é read-only. Nenhuma operação de escrita, alteração ou exclusão é exposta. Você consulta dados, não publica neles. Isso é uma proteção: o cliente de IA não pode acidentalmente sobrescrever sua tabela de pedidos ou apagar um conector.

Máximo de 1.000 linhas por execução

Cada consulta retorna no máximo 1.000 registros, independentemente do limit que o cliente de IA pedir. O retorno inclui a flag row_cap: 1000 e truncated, para a IA saber que o resultado foi cortado. Para análises agregadas (somas, médias, top 10), 1.000 linhas costumam sobrar; para extrações brutas, planeje filtros antes da pergunta.

Linguagem KSQL, não SQL bruto

A consulta é gerada em KSQL, a linguagem da Kondado em formato JSON. Os clientes de IA suportados sabem gerar KSQL nativamente, então você não precisa aprender a sintaxe. Mas vale saber: se quiser auditar a query que a IA mandou, ela vem em JSON, não em SQL puro.

Uma Via Kondado por sessão

Cada sessão OAuth fica ligada a uma Via Kondado. Se você tem múltiplas Vias (por exemplo, uma por cliente em uma agência), conecte cada uma como uma sessão separada no cliente de IA.

Defasagem natural da fonte original

O MCP consulta o que a Kondado já replicou. Se a sua integração com o GA4 está configurada para rodar de hora em hora, o que a IA vê é o dado da última execução, dentro da defasagem natural da fonte original. O GA4, por exemplo, pode levar até 48 horas para fechar números finais. Isso é da plataforma, não da Kondado.

Para quem o MCP da Kondado faz mais diferença?

Três perfis colhem ganho imediato com o MCP.

• Times de marketing em agências: cruzar Meta Ads, Google Ads e CRM em prompt único, sem montar dashboard para cada cliente.
• Pequenas e médias empresas com ERP brasileiro: Bling, Omie, Conta Azul e Tiny ERP consultáveis em português direto pelo ChatGPT ou Claude, sem precisar de analista para abrir cada relatório.
• Times de produto e dados: Claude Code e Codex no terminal permitem perguntas sobre dados durante o próprio fluxo de desenvolvimento e análise.

Próximo passo

A Kondado entrega o servidor MCP em https://mcp.kondado.io/mcp já configurado, conecta com ChatGPT, Claude, Codex e Claude Code via OAuth 2.1, e leva sua base de 80+ fontes para dentro do chat da IA que você já usa. Comece pelo teste grátis da Kondado, conecte sua primeira fonte, aponte o cliente de IA para o endpoint do MCP, e faça a primeira pergunta. Suporte em português via chat na própria plataforma.