Quanty › Documentação › Conectar à IA
Conectar o Quanty a uma inteligência artificial
O Quanty pode ser ligado ao Claude, ao ChatGPT e ao Power BI. Feita a ligação, você conversa em português e a IA lê e edita seus orçamentos, composições e memórias de cálculo direto na sua conta — sem exportar planilha.
Nesta página
1. O que dá para fazer
Não é um chat que dá palpite sobre engenharia. É acesso real à sua conta: a IA enxerga os seus orçamentos, as composições, os bancos de composições e as memórias de cálculo — e altera o que você pedir.
Na prática, dá para pedir coisas como:
- "Crie um orçamento chamado Ponte do Rio Claro e adicione a etapa de terraplenagem."
- "Nessa composição de concreto, troque o traço e me diga como fica o custo unitário."
- "Quais insumos respondem por 80% do custo deste orçamento?"
- "Compare o custo de alvenaria entre os dois orçamentos e aponte de onde vem a diferença."
O Power BI é de outra natureza: ele não conversa, apenas lê os dados para montar painéis. Está na seção 6.
2. Antes de começar
- Uma conta no Quanty em um plano que inclua integrações — os planos Builder e Enterprise. No plano Free essas opções não aparecem.
- Uma conta no assistente: Claude ou ChatGPT. A assinatura é sua, contratada direto com eles; o Quanty não revende nem cobra por isso. No caso do ChatGPT, criar um GPT personalizado exige ChatGPT Plus ou Teams.
- Cinco minutos. Tudo se resolve copiando e colando. Não é preciso instalar nada nem saber programar.
A IA enxerga apenas os dados da sua empresa no Quanty, com as mesmas permissões que você tem ao entrar pelo navegador. Ela não alcança dados de outras empresas.
3. Onde ficam as chaves
Tudo está numa tela só:
- Entre no Quanty.
- Clique no seu nome, no canto superior direito.
- Escolha Minha Conta.
Menu do usuário › Minha Conta
Role a página e você encontra três blocos: Conecte o Quanty ao Claude, Conecte o Quanty ao ChatGPT e Conector de dados (o do Power BI). Não há nada para preencher — a sua chave já é criada na primeira visita.
Eles ficam ocultos no plano Free. Fale com o responsável pela conta da sua empresa ou escreva para contato@b2builder.com.br.
4. Conectar ao Claude
É o caminho mais curto dos três. No bloco Conecte o Quanty ao Claude existe a URL do conector — um endereço longo que já vem com a sua chave embutida, e por isso conecta na hora, sem passo de login.
- Clique em Copiar na URL do conector.
- Abra claude.ai/settings/connectors e clique em Add custom connector.
- Cole a URL inteira no campo de URL e clique em Add.
- Abra uma conversa nova e peça para listar seus orçamentos.
Conversas que já estavam abertas continuam com a lista antiga de recursos e podem responder que não conseguem fazer algo que, numa conversa nova, funciona normalmente. Vale a mesma regra sempre que o Quanty ganhar recursos novos.
Dentro do mesmo bloco há também a chave MCP avulsa, num campo recolhido. Você só precisa dela em ferramentas que peçam a chave separada do endereço.
5. Conectar ao ChatGPT
No ChatGPT a ligação é feita criando um GPT personalizado que acessa o Quanty por Actions. São duas informações, as duas no bloco Conecte o Quanty ao ChatGPT: a URL da OpenAPI Spec e a sua chave de API.
- Abra chatgpt.com/gpts/mine e clique em Create a GPT.
- Na aba Configure, desça até Actions e clique em Create new action.
- Clique em Import from URL e cole a URL da OpenAPI Spec.
- Em Authentication, escolha API Key, cole a sua chave de API e, em Auth Type, selecione Bearer.
- Salve. Converse com o GPT para gerenciar seus orçamentos.
Repare na diferença: no Claude a chave viaja dentro do endereço; no ChatGPT ela é colada num campo separado, o de autenticação.
6. Conectar ao Power BI
No bloco Conector de dados você gera um token pessoal e, com ele, o Quanty monta os endereços de cada conjunto de dados. São cinco:
| Conjunto | O que traz |
|---|---|
| Planilhas | Os itens das planilhas orçamentárias, em detalhe. |
| Rótulos | Os rótulos usados para organizar os orçamentos. |
| Curva ABC | Os dados agregados da curva ABC. |
| BDI | As composições de BDI. |
| Composições | A estrutura de insumos das composições. |
- No bloco Conector de dados, gere o token (o botão de atualizar, ao lado do campo).
- Clique em COPIAR no conjunto que você quer.
- No Power BI, use Obter dados e escolha a origem Web.
- Cole o endereço e confirme. Repita para os outros conjuntos que quiser no mesmo painel.
Os dados são consultados ao vivo: ao atualizar o painel, ele busca a situação atual do Quanty. O mesmo token serve para puxar os dados no Excel.
7. O que pedir para a IA
Consultar
- "Qual o total deste orçamento com BDI e qual sem?"
- "Mostre os dez insumos mais caros e quanto cada um pesa no total."
- "Quais linhas estão usando o BDI diferenciado?"
Editar
- "Adicione um serviço de forma de madeira com 350 m² embaixo da etapa de estrutura."
- "Nesta composição, aumente a produtividade do pedreiro e recalcule."
- "Duplique este orçamento para eu usar como modelo na próxima obra."
Trabalhar com bases e com o BIM
- "Procure na base uma composição de concreto usinado e traga para este orçamento."
- "Liste as memórias de cálculo deste orçamento e a quais linhas elas estão vinculadas."
A IA altera os dados de verdade. Depois de uma alteração em massa, abra o orçamento e confira. Para experimentar sem risco, peça uma cópia do orçamento e trabalhe nela.
8. Segurança do acesso
A URL do conector contém a sua chave. Quem tiver esse endereço alcança os dados da sua empresa no Quanty sem precisar de senha. O mesmo vale para a chave de API do ChatGPT e para o token do Power BI. Trate os três como você trataria uma senha: nada de grupo de WhatsApp, documento compartilhado ou e-mail para fora da empresa.
Se algo vazar
- Token do Power BI: você mesmo resolve. No bloco Conector de dados, o botão de atualizar gera um token novo e derruba o anterior — depois disso, atualize os endereços nos seus painéis, que param de funcionar com o token velho.
- Chave da IA (Claude e ChatGPT): no bloco do Claude, ao lado de Copiar URL, existe o botão Rotacionar. Ele gera uma chave nova e derruba a anterior na hora. Por segurança são dois cliques: o primeiro mostra o aviso do que vai parar, o segundo confirma.
A mesma chave serve para o conector do Claude e para o GPT personalizado do ChatGPT. Ao rotacionar, os dois param até você reconectá-los com a chave nova — volte em Minha Conta, copie a URL nova para o Claude e a chave nova para o GPT. O token do Power BI não é afetado: ele é outro, e se troca à parte.
Ao gravar a chave em outro sistema — um GPT personalizado compartilhado com colegas, por exemplo — lembre que quem usa aquele GPT passa a enxergar os dados da sua conta.
9. Perguntas frequentes
Preciso saber programar para usar?
Não. Todo o trabalho é copiar informações de uma tela do Quanty e colar numa tela do assistente. Depois disso, a conversa é em português comum.
A IA pode estragar meu orçamento?
A ligação permite ler e editar, então uma alteração pedida é uma alteração feita de verdade. Peça mudanças grandes em partes, confira o resultado e, para experimentar sem risco, trabalhe numa cópia do orçamento.
Preciso pagar o Claude ou o ChatGPT à parte?
Sim. A assinatura do assistente é contratada por você, direto com o fornecedor dele. O Quanty apenas fornece a ligação, incluída nos planos Builder e Enterprise. Para criar um GPT personalizado, o ChatGPT exige Plus ou Teams.
Qual a diferença entre a URL do conector e a chave MCP avulsa?
São a mesma credencial em duas formas. A URL do conector já traz a chave dentro dela — é o que o Claude pede. A chave avulsa serve para ferramentas que peçam o endereço e a chave em campos separados, como o GPT personalizado do ChatGPT.
A IA enxerga os dados de outras empresas que usam o Quanty?
Não. O acesso é restrito à sua empresa, com as mesmas permissões que você tem ao entrar pelo navegador.
Conectei, mas o assistente diz que não consegue fazer nada no Quanty.
Quase sempre é a conversa antiga: abra uma conversa nova. Se continuar, volte em Minha Conta, copie a URL de novo e refaça a ligação.
Meu painel do Power BI parou de atualizar.
O motivo mais comum é alguém ter gerado um token novo no Conector de dados, o que derruba o anterior. Copie os endereços novos e atualize a conexão do painel. Rotacionar a chave da IA não mexe no Power BI — são credenciais separadas.
Como troco a chave se ela vazar?
No bloco do Claude, em Minha Conta, clique em Rotacionar e confirme. A chave antiga morre na hora. Como o Claude e o GPT do ChatGPT usam a mesma chave, os dois precisam ser reconectados depois; o token do Power BI é outro e não é afetado.
Ficou alguma dúvida? Escreva para contato@b2builder.com.br.