Dois caminhos, uma mesma chegada: sua primeira fonte conectada e um caso de uso funcionando.
Conecte o MCP da Nekt à sua IA preferida e avance com contexto, aprovação e segurança em cada etapa.
ChatGPT
Claude
Gemini
Cursor
+ outras
Um guia interativo para organizar o catálogo, conectar fontes, validar dados e preparar o contexto do negócio.
Conecte o MCP da Nekt à sua IA compatível e use o prompt abaixo. O agente vai conhecer seu cenário, montar um plano e executar cada etapa com sua aprovação.
Na Nekt, abra Integrações → MCP Server, habilite o servidor e siga o fluxo para conectar sua IA. Se precisar, consulte o guia geral de configuração do MCP.
Abra uma nova conversa na sua IA, confirme que o MCP da Nekt está disponível e cole o texto:
Quero configurar meu workspace Nekt do zero com sua ajuda. Antes de executar qualquer ação: 1. pergunte se os dados são internos, de clientes ou híbridos; 2. ajude a definir o primeiro caso de uso e o resultado esperado; 3. proponha a estrutura de catálogos e layers Bronze, Silver e Gold; 4. liste as fontes e credenciais necessárias; 5. execute uma etapa por vez via MCP, pedindo minha aprovação antes de alterações; 6. valide a primeira carga, a primeira pergunta e o documento de contexto. Ao final de cada etapa, resuma o que foi feito, o que falta e qualquer decisão pendente.
A IA pode estruturar catálogos e layers, preparar fontes e transformações, validar os dados e criar contexto. Quando uma credencial for necessária, ela gera um link seguro para você concluir essa etapa diretamente na Nekt — nunca envie senhas ou tokens no chat.
Conecte uma fonte, valide a primeira carga e faça uma pergunta aos seus dados no Claude, ChatGPT ou outro cliente compatível com MCP. Reserve cerca de 15 - 25 minutos de trabalho ativo; a primeira carga pode seguir rodando em segundo plano.
Este roteiro começa com um workspace Nekt pronto. Se você ainda não criou a conta ou o workspace, faça primeiro a configuração do workspace. Você pode parar depois de qualquer passo: o progresso desta página fica salvo neste navegador.
Dentro da Nekt, clique em Help, no canto superior direito. O assistente consulta nossa base de conhecimento para orientar você durante todo o processo.
Abrir a Nekt ↗Esta é a primeira pergunta de toda implantação, porque a resposta define como o seu catálogo é organizado. Escolha abaixo: o passo 2 se adapta à sua escolha.
É a única decisão desta página que dá trabalho para desfazer. Trocar a estrutura depois significa refazer caminhos de tabela, permissões e o contexto que o agente usa para responder. Todo o resto é reversível em poucos cliques.
Com a estrutura decidida, crie as layers no Catálogo. Fazer isso antes evita que a primeira fonte caia num lugar provisório que você vai querer mudar depois. Comece simples: a organização pode evoluir conforme o uso.
O catálogo é o que o agente enxerga. Nome de layer e de tabela é contexto: uma pergunta
sobre receita é respondida muito melhor usando uma taxonomia como gold.receita_mensal do que em
raw.tbl_001.
A configuração de uma fonte segue seis passos: escolha do conector, credenciais, seleção dos streams, mapeamento para tabelas no Catálogo, trigger e descrição. Os pontos mais relevantes na configuração são esses abaixo, o restante pode manter as opções padrão.
crm_negocios ou financeiro_recebimentos, em vez de siglas difíceis de reconhecer.
É o motivo mais comum de parada. Peça ao responsável um acesso com as permissões exigidas pelo conector e retome este passo quando ele estiver disponível. Não use senha pessoal compartilhada como atalho.
A primeira execução começa automaticamente depois que a fonte é salva e pode levar de alguns minutos a algumas horas, conforme o volume extraído. Nas execuções seguintes, a atualização segue o tipo de sync configurado para o conector (por exemplo, completo, incremental ou baseado em logs). Você pode fechar a aba enquanto ela roda. Para acompanhar o progresso ou ler um erro, abra Runs na página de detalhes da fonte.
Configure alertas de falha para a fonte. Você pode ativá-los nela mesma ou, se for owner/admin, definir destinatários globais em Settings → Alerts. Assim, uma falha futura não depende de alguém abrir a Nekt para ser percebida.
Com os dados no Catálogo, habilite o MCP Server da Nekt e conecte seu agente. É aqui que você começa a interagir com os dados em linguagem natural. O MCP Server está disponível nos planos pagos.
A Nekt oferece guias para Claude, ChatGPT e Cursor, além de outros clientes compatíveis com MCP. O método de autenticação muda conforme o cliente: apps como Claude Desktop e Cursor usam OAuth; ferramentas de linha de comando e automação podem usar token. Em Integrações → MCP Server, habilite o servidor e siga o guia do seu cliente.
Comece pela pergunta mais óbvia que existe sobre o seu negócio, aquela cuja resposta você já sabe de cabeça. Conferir uma resposta que você consegue validar é o que cria confiança para as próximas.
São textos curtos que explicam o seu negócio para o agente. Crie o primeiro com a pessoa que conhece as métricas e regras do negócio; a IA pode ajudar a redigir, mas não deve decidir sozinha qual definição é a correta. É o passo mais subestimado — e o que mais muda a qualidade da resposta.
Criar um documento de contexto é como explicar o seu negócio para um novo colega. Ele não precisa saber tudo, mas precisa saber o suficiente para responder corretamente.
Sem contexto, o agente responde com o que consegue deduzir dos nomes das tabelas e colunas. Com contexto, ele responde com a definição que a sua empresa usa. Duas empresas com o mesmo schema e definições diferentes de "cliente ativo" precisam de respostas diferentes, e só o documento de contexto conta isso a ele. Para se aprofundar, veja o guia completo sobre context documents.
Complete os passos acima e esta área mostra o que fazer em seguida.
O objetivo deste guia é chegar à primeira resposta confiável, não modelar tudo de uma vez. Depois de validar uma pergunta, use as dúvidas recorrentes para priorizar Queries, Notebooks e camada semântica. Ao salvar uma Query na Nekt, você define a layer e o nome; a execução gera e atualiza a tabela de saída no Catálogo — não é preciso criar uma view manualmente. Comece pelo dado ou métrica que o time mais pergunta.
Antes de chamar o suporte, isole o ponto do problema. Isso reduz idas e vindas e permite que você avance sozinho quando for algo simples.