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

Este artigo cobre como configurar a conexão em Claude Web, Claude Desktop e Claude Code. 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.

Claude Web

Validado em claude.ai em novembro de 2026. O fluxo usa OAuth — você não precisa copiar nenhum token manualmente. O Claude Desktop tem exatamente as mesmas telas (veja a seção Claude Desktop).

Passo 1 — Abrir "Adicionar conector personalizado"

No menu lateral do Claude, clique em Personalização → aba Conectores → botão + Adicionar → Adicionar conector personalizado.

Atalho (Claude Web): este link já abre a janela de cadastro direto: https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors

Passo 2 — Preencher nome e URL

Na janela "Adicionar conector personalizado":

• Nome: Kondado (qualquer rótulo claro — é apenas cosmético).
• URL do servidor MCP: https://mcp.kondado.io/mcp (URL completa, com o /mcp no final).

Clique em Continuar.

Passo 3 — Tela de Autenticação: escolha "Entrar agora"

A janela passa a mostrar a tela de Autenticação com 3 opções. Selecione "Entrar agora":

• Entrar agora (recomendado) — você faz login na sua conta Kondado pelo fluxo OAuth antes de usar o conector.
• Fazer login quando necessário — também funciona: o Claude se conecta sem credenciais e pede o login ao executar a primeira consulta.
• Sem login — não selecione. O Claude costuma marcá-la como "Detectado" por padrão, mas a Via Kondado exige login para executar consultas; com "Sem login" nenhuma consulta funciona. Isso não expõe seus dados — a Via Kondado lê apenas o destino da sua conta e cada consulta exige a autenticação da sua conta.

Passo 4 — Cliente OAuth: mantenha o padrão

Ao selecionar "Entrar agora", aparece logo abaixo a seção Cliente OAuth. Mantenha a opção padrão "Usar a identidade publicada do Claude" (Recomendado) — não mude a opção e não preencha cabeçalhos.

Passo 5 — Adicionar

Clique em Adicionar.

Passo 6 — Vincular

O Claude mostra a mensagem "Você começou a se conectar a Kondado, mas não concluiu." com o botão Vincular. Clique em Vincular.

Passo 7 — Continuar conectando

Aparece a pergunta "Concluir a conexão de um conector?". Clique em Continuar conectando. Se você ainda não estiver logado na Kondado nesse navegador, a tela de login da Kondado (app.kondado.com.br) abre antes — faça login com seu e-mail e senha (ou login social).

Passo 8 — Autorizar acesso e escolher a Via Kondado

Abre a tela da Kondado "Autorizar acesso":

1. Confirme o aplicativo Claude e o escopo "Ler seus dados Via Kondado".
2. Verifique se o e-mail logado é o da sua conta Kondado.
3. No dropdown, escolha qual destino Via Kondado o Claude deve consultar (se você tem mais de uma Via Kondado, escolha aquela em que quer rodar as consultas).
4. Clique em Autorizar.

Passo 9 — Pronto

O conector aparece em Seus conectores como Kondado (com o botão Desvincular). A partir daí, abra um chat e peça algo como "Liste as tabelas do Kondado" ou "Quanto eu gastei em Google Ads no último mês?".

Na primeira consulta, o Claude pede permissão para usar a ferramenta ("Claude quer usar … de Kondado"). Clique em Sempre permitir se não quiser ver esse aviso a cada chamada.

Claude Desktop

O Claude Desktop (app para computador) usa o mesmo fluxo e as mesmas telas do Claude Web. Abra o app e siga:

1. Menu lateral: Personalização → aba Conectores → + Adicionar → Adicionar conector personalizado.
2. Nome: Kondado; URL do servidor MCP: https://mcp.kondado.io/mcp. Clique em Continuar.
3. Na tela de Autenticação, selecione "Entrar agora". "Fazer login quando necessário" também funciona; não selecione "Sem login", mesmo que o Claude a marque como "Detectado" — com ela nenhuma consulta funciona (e isso não expõe seus dados). Detalhes das 3 opções no Passo 3 do Claude Web.
4. Em Cliente OAuth, mantenha "Usar a identidade publicada do Claude" (Recomendado) e não preencha cabeçalhos.
5. Clique em Adicionar.
6. Em "Você começou a se conectar a Kondado, mas não concluiu.", clique em Vincular.
7. Em "Concluir a conexão de um conector?", clique em Continuar conectando (faça login na Kondado no navegador, se pedido).
8. Na tela da Kondado "Autorizar acesso", escolha o destino Via Kondado e clique em Autorizar (veja o Passo 8 do Claude Web).
9. Pronto: o conector aparece em Seus conectores como "Kondado". O Claude Desktop guarda a autorização — você não precisa repetir o login.

Claude Code (CLI)

O Claude Code é o CLI da Anthropic para terminal. Ele aceita MCP servers via configuração ou comando direto.

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"
    }
  }
}

Na primeira tool call que use a Kondado, o Claude Code abre o navegador no mesmo fluxo OAuth descrito nos passos 7 e 8 do Claude Web. Após autorizar, o token fica salvo localmente e é renovado automaticamente.

Outros clientes Claude

Conforme a Anthropic adiciona suporte a MCP em novos produtos da família Claude, 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.

Veja também: para conectar produtos da OpenAI (ChatGPT Web/Desktop e Codex CLI), veja o artigo ChatGPT.

Para clientes MCP de terceiros (não-Claude) ou integrações server-to-server que não suportam 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: abra Personalização → Conectores, remova o conector e adicione novamente. Refazendo o consent você pode escolher outra destination no dropdown.
• Token expirou: o Claude renova o token sozinho 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 Passo 8 do Claude Web.
• O Claude pede permissão a cada chamada: clique em Always allow na primeira vez para parar de ver o pop-up para aquela ferramenta específica.
• 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
• ChatGPT — como conectar ChatGPT (Web/Desktop) e Codex (CLI da OpenAI) à Via Kondado