O MCP (Model Context Protocol) da Via Kondado permite conectar o ChatGPT — em qualquer um de seus produtos — diretamente aos seus dados integrados na Kondado. Depois de conectar, você pode pedir ao ChatGPT para listar tabelas, descrever campos e rodar consultas em linguagem natural, sem sair do chat.

Este artigo cobre como configurar a conexão em ChatGPT (Web e Desktop) e no Codex (CLI da OpenAI). Para o conceito geral de MCP na Via Kondado e o caminho alternativo via token, veja a seção MCP no artigo principal Via Kondado. Para conectar com a família Claude (Anthropic), veja o artigo Claude.

ChatGPT (Web)

O passo a passo abaixo foi validado em uma conta Free / Personal. Os mesmos passos funcionam em planos pagos.

Passo 1. Abra o ChatGPT Web e clique no nome da sua conta, na barra inferior esquerda → Settings. No menu lateral, clique em Plugins e role a lista até o final, onde fica o item Developer mode.

Passo 2. Clique em Developer mode — o ChatGPT leva você à seção Security and login, onde vive o toggle. Ative-o e confirme o aviso de risco. Sem este passo, o botão "Create" do passo 4 não aparece habilitado. Atalho direto: chatgpt.com/#settings/Security.

Passo 3. Volte a Settings → Plugins e clique em Browse plugins (ou acesse diretamente chatgpt.com/plugins). Na tela de plugins, clique no botão "+" ao lado do campo de busca para abrir o modal de criar um novo conector. Atalho: este link já abre o modal direto.

Passo 4. No modal New Plugin, preencha:

• Name: Kondado (ou outro nome de sua escolha)
• Connection: mantenha selecionado Server URL (não Tunnel) e cole https://mcp.kondado.io/mcp
• Authentication: deixe em OAuth — não é necessário abrir Advanced OAuth settings; o ChatGPT descobre o servidor de autenticação automaticamente.
• Marque a caixa "I understand and want to continue" (reconhecimento do aviso de risco).

Passo 5. Ao clicar em Create, o ChatGPT abre uma nova aba em app.kondado.com.br com a tela "Autorizar acesso MCP". Confirme que o e-mail conectado é o seu, escolha a Via Kondado de destino no dropdown e clique em Autorizar.

Passo 6. A aba do consent fecha sozinha e o app aparece conectado dentro do ChatGPT, com badge DEV. As ferramentas Kondado já ficam disponíveis para uso.

Passo 7. Para usar o conector, abra um chat em Developer mode. A borda do input aparece em laranja indicando o modo, e a Memory fica desabilitada para esse tipo de chat.

Pronto. Faça uma pergunta sobre seus dados — por exemplo, "me conta sobre minhas vendas da omie". O ChatGPT chama as ferramentas Kondado, executa as consultas e retorna o resultado direto no chat.

ChatGPT (Desktop)

A versão Desktop do ChatGPT (Mac e Windows) usa a mesma conta e os mesmos conectores configurados na Web:

• Conectores adicionados pela Web aparecem automaticamente no Desktop (e vice-versa).
• O fluxo de OAuth (login na Kondado + escolha do destination + Approve) também é feito no navegador padrão do sistema.
• Se sua versão do Desktop tiver um menu próprio de Connectors, o cadastro é idêntico ao da Web (mesmo Name + mesma URL https://mcp.kondado.io/mcp).

Caso a versão do seu app Desktop ainda não exponha a UI de conectores customizados, configure pela Web e a conexão será propagada para o app.

Codex (OpenAI CLI)

O Codex é a CLI da OpenAI para terminal (análoga ao Claude Code da Anthropic). Ele aceita servidores MCP via comando direto ou via arquivo ~/.codex/config.toml.

Opção A — comando direto

No terminal:

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

O comando codex mcp login kondado abre o navegador na tela de login da Kondado e na sequência na tela "Authorize MCP access". Após escolher a Via Kondado de destino e clicar em Approve, o token é salvo localmente pelo Codex 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"

Em seguida, rode codex mcp login kondado para fazer o consent OAuth uma vez. A partir daí, o Codex usa as credenciais armazenadas em todas as chamadas seguintes.

Comandos úteis

• codex mcp list — lista os servidores MCP cadastrados.
• codex mcp logout kondado — remove as credenciais OAuth (útil para trocar de Via Kondado de destino).
• codex mcp remove kondado — remove o servidor cadastrado.

Outros clientes OpenAI

Conforme a OpenAI adiciona suporte a MCP em novos produtos (SDK, Apps, etc.), o padrão é sempre o mesmo:

• Cadastre o servidor MCP com a URL https://mcp.kondado.io/mcp.
• Na primeira chamada, o cliente abre a tela de consent da Kondado em app.kondado.com.br.
• Você escolhe a Via Kondado de destino e autoriza.

Para clientes MCP de terceiros ou integrações server-to-server que não suportem OAuth, é possível usar o token legado da Via Kondado — veja a seção MCP no artigo Via Kondado.

Dicas e troubleshooting

• Trocar de Via Kondado: remova o conector no ChatGPT (ou rode codex mcp logout kondado) e adicione novamente. Refazendo o consent você pode escolher outra destination no dropdown.
• Token expirou: o ChatGPT e o Codex renovam o token sozinhos via refresh token. Se mesmo assim aparecer erro de autenticação, refaça a conexão (remover + adicionar).
• Não vejo todas as minhas tabelas: o conector vê apenas as tabelas da destination que você escolheu na tela de autorização. Verifique se selecionou a destination correta no consent.
• Botão "Create" desabilitado: ative o Developer mode em Settings → Plugins → Developer mode. Sem ele o botão fica esmaecido em qualquer plano. Em workspaces Business / Enterprise, peça ao administrador para liberar o Developer mode se a opção estiver bloqueada.
• Limitações da v1: o MCP é read-only (apenas consultas) e usa KSQL. Não é possível fazer escrita, alteração ou deleção de dados na Via Kondado pelo MCP.

Próximos passos

• Via Kondado — visão geral do destino
• Seção MCP no artigo Via Kondado — diferenças entre OAuth e token legado
• Claude — como conectar a família Claude (Web, Desktop, Code) à Via Kondado