Como Conectar a Kondado ao ChatGPT (Developer Mode Passo a Passo, Funciona no Free)

Conecte seus dados da Kondado diretamente ao ChatGPT e faça perguntas sobre vendas, marketing e operações em linguagem natural. Este tutorial completo mostra como ativar o Developer Mode e configurar o servidor MCP da Kondado em qualquer plano do ChatGPT, incluindo o gratuito.

Você vai conectar o ChatGPT aos seus dados da Kondado usando o endpoint MCP https://mcp.kondado.io/mcp, que funciona em planos Free, Plus, Pro e Team. O passo obrigatório é ativar o Developer Mode antes de criar o app, pois sem isso o botão de criação fica desabilitado em qualquer plano. Depois da configuração, basta perguntar em português ("quanto vendi ontem", "qual campanha converteu mais") e o ChatGPT consulta seus dados automaticamente. A mesma configuração serve para ChatGPT Web, Desktop e Codex CLI, e a integração entrega seus dashboards e respostas com a frequência que você escolher.

O Que Você Vai Precisar

Antes de começar, verifique se você tem:

1. Uma conta ativa na Kondado, com acesso ao painel da Kondado e pelo menos uma integração configurada.
2. Uma conta no ChatGPT em qualquer plano: Free, Plus, Pro ou Team. Validamos o passo a passo em uma conta Free.
3. Uma Via Kondado criada, que é o destino onde seus dados estão disponíveis para consulta via API.

Como Funciona o MCP da Kondado

O MCP (Model Context Protocol) é um protocolo aberto que permite que assistentes de IA como o ChatGPT acessem dados externos de forma segura. A Kondado implementou um servidor MCP que conecta diretamente à sua Via Kondado, o destino onde seus dados integrados ficam disponíveis para análise, dashboards e respostas em linguagem natural.

Como funciona na prática:

• Você faz uma pergunta em português para o ChatGPT.
• O ChatGPT reconhece que precisa consultar seus dados.
• Ele chama as ferramentas da Kondado automaticamente.
• Recebe a resposta com dados reais da sua operação.

Endpoint do servidor MCP da Kondado:

https://mcp.kondado.io/mcp

Como Ativar o Developer Mode no ChatGPT (Passo 1)

O Developer Mode é um pré-requisito obrigatório para criar apps MCP customizados. Sem ele, o botão "Create app" permanece desabilitado em qualquer plano do ChatGPT.

Passo 1.1: Acesse as Configurações

1. Abra o ChatGPT na web (chatgpt.com).
2. Clique no avatar da sua conta no canto superior direito.
3. Selecione Settings no menu dropdown.

Passo 1.2: Navegue até Apps

1. No menu lateral esquerdo de Settings, clique em Apps.
2. Role até o final da página.
3. Clique em Advanced settings.

Passo 1.3: Ative o Developer Mode

1. Localize o toggle Developer mode.
2. Clique para ativar.
3. Confirme o aviso de "ELEVATED RISK". Este é o comportamento esperado da OpenAI.

Importante: Quando o Developer Mode está ativo, a Memory fica desabilitada nos chats que usam apps customizados. Isso é uma limitação do ChatGPT, não da Kondado.

Como Adicionar o Servidor MCP da Kondado (Passo 2)

Com o Developer Mode ativado, você pode criar o app MCP que conecta ao servidor da Kondado.

Passo 2.1: Crie um Novo App

1. Ainda em Advanced settings (dentro de Apps).
2. Clique no botão Create app.
3. O modal New App será aberto.

Passo 2.2: Preencha as Configurações

No modal de criação, preencha:

• Name: Kondado (ou qualquer nome de sua preferência).
• MCP Server URL: https://mcp.kondado.io/mcp.
• Authentication: Deixe em OAuth, sem necessidade de abrir "Advanced OAuth settings".

Marque a caixa "I understand and want to continue" para confirmar que entende os riscos.

Por que usar OAuth? O ChatGPT descobre automaticamente o servidor de autenticação. Você só precisa fornecer a URL do endpoint MCP.

Passo 2.3: Confirme a Criação

Clique em Create. O app será criado e uma nova aba do navegador abrirá automaticamente para a tela de autorização da Kondado.

Como Autorizar e Testar a Conexão (Passo 3)

Esta etapa vincula o app do ChatGPT à sua Via Kondado específica.

Passo 3.1: Faça Login na Kondado

1. Na aba que abriu (app.kondado.com.br), faça login com sua conta Kondado, se ainda não estiver logado.
2. Verifique se o email mostrado é o seu.

Passo 3.2: Selecione Sua Via Kondado

1. No dropdown, escolha qual Via Kondado o ChatGPT poderá acessar.
2. Cada app fica vinculado a uma única Via Kondado por vez.
3. Clique em Autorizar.

Passo 3.3: Confirme a Conexão

A aba de consentimento fecha automaticamente. De volta ao ChatGPT, você verá:

• O app "Kondado" aparece na lista com badge DEV.
• As ferramentas da Kondado estão disponíveis para uso.

Como Usar no ChatGPT Web (Passo 4)

Agora você pode fazer perguntas sobre seus dados em linguagem natural.

Passo 4.1: Abra um Chat em Developer Mode

1. Clique em New chat.
2. Selecione o app Kondado na barra de ferramentas. Ele aparece como ícone ou na lista de GPTs.
3. A borda do campo de input ficará laranja, indicando que o Developer Mode está ativo.

Passo 4.2: Faça Sua Primeira Pergunta

Exemplos de perguntas que você pode fazer:

• "Me conta sobre minhas vendas da Omie."
• "Qual foi o faturamento do mês passado?"
• "Mostre os dados do meu Facebook Ads da última semana."
• "Quais produtos mais venderam ontem?"

Como funciona: O ChatGPT traduz sua pergunta para uma consulta KSQL, executa na sua Via Kondado e retorna os resultados formatados diretamente no chat.

Diferença importante: No ChatGPT, o consentimento é a nível de servidor. Após a autorização inicial do Passo 3, todas as chamadas seguintes são executadas automaticamente sem novas confirmações.

Como Usar no ChatGPT Desktop

A versão Desktop (Mac e Windows) usa os mesmos conectores configurados na Web. Os apps sincronizam automaticamente: conectores adicionados pela Web aparecem no Desktop. O fluxo OAuth abre no seu navegador padrão, e a configuração usa exatamente a mesma URL, https://mcp.kondado.io/mcp.

Se sua versão Desktop ainda não mostra a UI de conectores customizados, configure pela Web primeiro. A conexão será propagada automaticamente.

Como Usar no Codex (CLI da OpenAI)

O Codex é a interface de linha de comando da OpenAI para desenvolvedores.

Opção A: Comando Direto

No terminal, execute:

codex mcp add kondado --url https://mcp.kondado.io/mcp
codex mcp login kondado

O comando login abre o navegador para autorização OAuth. Após aprovar, o token é salvo localmente e renovado automaticamente.

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

Adicione ao seu ~/.codex/config.toml:

[mcp_servers.kondado]
url = "https://mcp.kondado.io/mcp"

Depois execute codex mcp login kondado uma vez para autorizar.

Comandos Úteis

• codex mcp list lista servidores MCP cadastrados.
• codex mcp logout kondado remove credenciais. Útil para trocar de Via Kondado.
• codex mcp remove kondado remove o servidor completamente.

Quais São as Diferenças entre Free, Plus, Pro e Team

Para os recursos relevantes neste tutorial, os planos se comportam assim:

1. Apps MCP customizados: disponíveis no Free e no Plus, Pro e Team.
2. Developer Mode: disponível no Free e no Plus, Pro e Team.
3. Limite de mensagens: restrito por hora no Free; quota maior no Plus, Pro e Team.
4. Acesso a GPT-4: não disponível no Free; disponível no Plus, Pro e Team.
5. Modelo usado em chamadas MCP: GPT-4o mini no Free; GPT-4o ou GPT-4 no Plus, Pro e Team.

O plano Free tem limitações de mensagens por hora, mas o acesso ao MCP funciona normalmente. Mesmo no Free, o ChatGPT usa GPT-4o mini para chamadas MCP, o que é suficiente para a maioria das consultas de dados.

Exemplo Prático: Analisando Vendas com ChatGPT e Kondado

Cenário: Você tem uma loja Shopify integrada na Kondado.

Pergunta: "Compare minhas vendas dessa semana com a semana passada."

O que acontece:

1. O ChatGPT identifica que precisa consultar a tabela de pedidos.
2. Monta uma consulta KSQL com filtro de datas.
3. Executa na sua Via Kondado.
4. Retorna: "Esta semana: R$ 12.450. Semana passada: R$ 9.830. Crescimento: +26,6%."

Próxima pergunta: "Qual foi o produto mais vendido?"

O ChatGPT mantém o contexto e consulta novamente, mostrando: "Camiseta Premium Listrada, 47 unidades vendidas."

Como Resolver Problemas Comuns

O botão "Create app" está desabilitado

Solução: Você esqueceu de ativar o Developer Mode. Volte ao Passo 1.3.

Não vejo todas as minhas tabelas

Solução: Verifique se selecionou a Via Kondado correta no momento da autorização. O app vê apenas as tabelas daquela destination específica.

Erro de autenticação após alguns dias

Solução: O token expirou. No ChatGPT Web ou Desktop, remova o app em Settings → Apps e adicione novamente. No Codex, execute codex mcp logout kondado e refaça o login.

Quero trocar para outra Via Kondado

Solução: Remova o app atual e adicione novamente. Durante a nova autorização, escolha a outra Via Kondado no dropdown.

O app não aparece no Desktop

Solução: Certifique-se de que configurou pela Web primeiro. Aguarde alguns minutos para sincronização ou reinicie o app Desktop.

FAQ sobre Kondado e ChatGPT

Preciso pagar pelo ChatGPT Plus para usar o MCP da Kondado?

Não. A conexão de servidores MCP customizados funciona em qualquer plano, incluindo o Free e o Personal. Validamos o passo a passo completo em uma conta Free. O único requisito é ativar o Developer Mode.

O que é o Developer Mode e por que precisa estar ativado?

Developer Mode é um toggle em Settings → Apps → Advanced settings que libera a criação de apps MCP customizados. Sem ele, o botão "Create app" fica desabilitado em todos os planos. O aviso de "ELEVATED RISK" e a desativação da Memory são comportamentos esperados da OpenAI.

Posso conectar mais de uma Via Kondado ao mesmo tempo?

Não diretamente. Cada app é vinculado a uma única Via Kondado. Para alternar entre destinations, remova o app atual e adicione novamente, escolhendo a outra Via Kondado na autorização.

O ChatGPT pede permissão a cada consulta?

Não. No ChatGPT, o consentimento é a nível de servidor. Você autoriza uma vez na criação do app e o ChatGPT executa todas as consultas subsequentes sem pedir confirmação.

Quais dados o ChatGPT pode acessar?

Apenas os dados das tabelas na Via Kondado selecionada durante a autorização. O MCP é somente leitura: não é possível alterar, criar ou excluir dados na Kondado pelo ChatGPT.

Funciona no celular?

O app móvel do ChatGPT pode refletir os conectores configurados na Web, mas a configuração inicial deve ser feita pelo navegador desktop para ativar o Developer Mode e criar o app.

É seguro usar OAuth?

Sim. O fluxo OAuth 2.1 com Dynamic Client Registration é o padrão de segurança moderno. Seu token é renovado automaticamente e você pode revogar o acesso a qualquer momento removendo o app em Settings → Apps.

Próximos Passos

Agora que você conectou o ChatGPT à Kondado, explore:

• Como conectar o Claude à Kondado, uma opção alternativa com interface diferente.
• Documentação da Via Kondado, para entender melhor como funciona o destino.
• Catálogo de conectores da Kondado, com mais fontes de dados para integrar.

Comece seu teste grátis de 14 dias na Kondado e conecte seus dados ao ChatGPT hoje mesmo.