Pular para o conteúdo
Área do cliente
  • Não há sugestões porque o campo de pesquisa está em branco.

[NOVO RECURSO] Configurando o MCP do AltoQi Builder para consulta de dados do projeto em ferramenta de Inteligência artificial

 O MCP (Model Context Protocol) é um protocolo que permite integrar aplicações a plataformas de inteligência artificial compatíveis, fornecendo acesso controlado às informações de um projeto.

Com a integração do MCP do AltoQi Builder, é possível consultar dados do projeto diretamente em ferramentas de IA, utilizando linguagem natural. Dessa forma, o assistente pode responder perguntas sobre as informações disponibilizadas pelo servidor MCP, tornando a análise dos projetos mais rápida e intuitiva.

Este artigo apresenta o processo de configuração do MCP do AltoQi Visus Cost Management e sua integração com o IA, permitindo a consulta das informações dos projetos por meio de inteligência artificial. 

Com a integração do MCP do AltoQi Builder, é possível consultar dados do projeto diretamente em ferramentas de IA, reduzindo a necessidade de exportar, copiar ou transcrever dados manualmente. Por meio de consultas em linguagem natural, o assistente pode te responder perguntas sobre elementos e resultados do projeto, tornando o acesso às informações do projeto mais rápido e intuitivo, aumentando a produtividade de fluxos de trabalho que envolvem a análise e o desenvolvimento de projetos.

Neste artigo, você aprenderá a configurar o MCP do AltoQi Builder e conectá-lo a uma plataforma de inteligência artificial compatível, permitindo consultar e analisar informações dos seus projetos com o auxílio da IA.

🧪 Recurso Beta: o MCP do AltoQi Axis está em fase beta, disponível a partir da atualização 2026-08 para clientes da modalidade Assinatura inscritos no programa. Para registrar seu interesse em se tornar um usuário beta tester do AltoQi Builder, acesse Programa Beta | AltoQi Builder.

O que pode ser feito com o MCP em seus projetos

Com o MCP, o assistente de inteligência artificial passa a consultar informações diretamente do projeto aberto no AltoQi Builder. Dessa forma, não é necessário copiar manualmente propriedades, resultados ou outras informações do modelo para realizar determinadas consultas.
A partir dessa conexão, o assistente pode utilizar o contexto da edificação e das disciplinas do projeto para auxiliar em análises, consultas e identificação de elementos.
Entre as informações e recursos que podem ser acessados por meio do MCP estão:

  • Contexto da edificação: consulta às informações gerais e à estrutura do projeto;

  • Elementos do projeto: busca por elementos das diferentes disciplinas e consulta às suas propriedades;

  • Quadros e circuitos elétricos: acesso a informações específicas dos elementos do projeto elétrico;

  • Verificação de condutos: identificação e consulta de condutos que apresentam situações de dimensionamento a serem verificadas;

  • Localização de elementos: possibilidade de localizar e destacar no croqui os elementos identificados durante uma consulta;

  • Resultados do projeto: utilização das informações disponibilizadas pelo Builder para apoiar análises realizadas pelo assistente.

Como localizar o endereço MCP no AltoQi Builder

Para localizar o endereço do MCP (Model Context Protocol) do AltoQi Builder, siga os passos abaixo:

  1. Abra o projeto que deseja utilizar no AltoQi Builder;
  2. Com o projeto aberto, na barra de acesso rápido clique ícone QiBuilder_8dBNME2XhQ para acessar o comando AltoQi Axis MCP.
  3. Na janela que se abrirá, clique em Conectar. Copie o link de endereço para utilizá-lo na próxima etapa.


Observação: Sempre que o AltoQi Builder for aberto novamente, será necessário ativar novamente a conexão MCP. A configuração realizada na plataforma de IA pode permanecer cadastrada, mas a conexão no Builder precisa estar ativa para permitir a comunicação com o projeto.

Como conectar o MCP ao ChatGPT 

Habilitando o Modo desenvolvedor no ChatGPT

Para permitir a integração com o servidor MCP, é necessário habilitar o Modo desenvolvedor no ChatGPT.

Siga os passos abaixo:

  1. Acesse Configurações, clicando no seu nome ou foto de perfil.
  2. Selecione Segurança e login.
  3. Habilite a opção Modo desenvolvedor.

Em espaços de trabalho de Equipe, Empresarial ou Educacional, somente proprietários e administradores podem configurar servidores MCP.

Criando o plugin no ChatGPT

Após habilitar o Modo desenvolvedor, siga os passos abaixo:

  1. Ainda em Configurações, acesse Plugins.
  2. Clique em Explorar Plugins.
  3. Clique em no ícone + para Adicionar novo plugin.
  4. Preencha os campos solicitados pelo ChatGPT com as informações do servidor MCP:
     
    Nome MCP AltoQi Axis (Sugestão)
    URL 

    https://mcp.altoqi.com.br/builder/
    ID do cliente OAuth altoqi-connect
  5. Em Autenticação, selecione OAuth.
  6. Marque a opção Entendi e quero continuar.
  7. Clique em Criar para concluir a configuração.

Conectando-se ao plugin criado

Após criar o aplicativo, siga os passos abaixo:

  1. Faça login utilizando sua conta AltoQi.
  2. Selecione a conta do AltoQi Builder que deseja utilizar.
  3. Autorize o acesso ao servidor MCP.
  4. Inicie uma nova conversa no ChatGPT.

Reconectando ou desconectando o aplicativo

Para reconectar ou desconectar o AltoQi Builder:

  1. Acesse Configurações.
  2. Selecione Plugins.
  3. Localize o plugin do Builder.
  4. Clique sobre o plugin e, em seguida, no ícone de reticências.
  5. Selecione Reconectar ou Desconectar, conforme necessário.
    chrome_MaZ1y4AN9Y

Como conectar o MCP ao Claude

Criando o conector no Claude

Para configurar o MCP no Claude:

  1. Abra o agente de IA Claude pelo navegador ou aplicativo para computador. A esquerda, no canto inferior esquerdo, acesse as Configurações. 
  2. Com a página de Configurações aberta, no grupo Personalizar clique em Conectores.
  3. Clique em Adicionar > Adicionar conector personalizado
  4. Preencha os campos solicitados pelo Claude com as informações do servidor MCP: 
    Nome

    MCP AltoQi Axis (Sugestão)
    URL 

    https://mcp.altoqi.com.br/builder/
  5. Clique Continuar, na seção Cliente OAuth selecione a opção Use seu próprio cliente OAuth e informe o ID altoqi-connect.
  6. Por fim, após preencher os campos com as informações, clique em “Adicionar” no final da página.

Após concluir a configuração, o Claude poderá consultar as informações disponíveis no Builder.

Atualizando a Lista de Ferramentas (Caso Necessário)

OBSERVAÇÃO: Se ao tentar usar o conector você receber a mensagem "Não há ferramentas disponíveis", será necessário atualizar a lista manualmente:

  1. Acesse Configurações > Conectores.

  2. Clique no conector configurado (ex: MCP Builder).

  3. No canto superior direito da janela do conector, clique no ícone (⋮).

  4. Selecione Atualizar lista de ferramentas.

  5. Uma notificação no rodapé confirmará: "Lista de ferramentas atualizada".

Na imagem a seguir, veja os passos descritos:

claude_IYf1TADOuj

Autorização de Uso de Ferramentas (Primeira Interação)

Na primeira vez em que você fizer uma pergunta ou solicitar uma ação que utilize as ferramentas do conector, o Claude exibirá uma solicitação de permissão:

  • Permitir uma vez: Autoriza a execução da ferramenta apenas para a consulta atual (indicador 2 na tela).

  • Sempre permitir: Autoriza o Claude a executar automaticamente ferramentas desse conector sem pedir confirmações futuras (indicador 1 na tela).

  • Negar: Cancela a execução da ferramenta.

Na imagem a seguir, confira a permissão:

claude_zcDEhwPePU

Reconectando ou desconectando o conector

Para reconectar ou desconectar o Workflow no Claude:

  1. Acesse a seção Conectores.
  2. Localize o conector do Builder.
  3. Clique no ícone de reticências.
  4. Selecione Atualizar lista de ferramentas para atualizar a conexão.
  5. Para remover a conexão, clique em Excluir.

Tools (funções) contempladas pelo MCP AltoQi Builder

As Tools podem ser entendidas como funções ou comandos disponíveis no MCP. Cada função permite realizar uma consulta específica nas informações do AltoQi Builder.

Observação: o MCP do AltoQi Builder está em constante evolução. Novas funcionalidades estão previstas para as próximas atualizações, incluindo recursos para mais disciplinas e operações no programa.

Informações Gerais de Projeto

Tool Função
builder-get_project_context Consulta informações gerais do projeto, como dados da edificação, pavimentos e disciplinas modeladas.
builder-get_discipline_properties Consulta os parâmetros de cálculo utilizados em uma disciplina do projeto.

Elementos do projeto

Tool Função
builder-search_elements Busca elementos do projeto, permitindo filtrar por características como tipo, pavimento, disciplina, rede e situação de dimensionamento.
builder-get_element_properties Consulta as propriedades e os resultados de cálculo de um elemento específico do projeto.

Condutos

Tool Função
builder-search_ducts_problematic Busca condutos que apresentam problemas de dimensionamento, considerando o pavimento e a disciplina.
builder-get_duct_sizing_report Consulta o relatório de dimensionamento de um conduto específico para obter detalhes sobre seu cálculo.

Projeto elétrico

Tool Função
builder-search_electric_panels

Busca os quadros elétricos do projeto e permite filtrá-los por características e situação de dimensionamento.
builder-get_panel_properties Consulta as propriedades e os dados de dimensionamento de um quadro elétrico específico.
builder-get_panel_load_schedule Consulta o quadro de cargas, incluindo os circuitos associados a um quadro elétrico.
builder-search_electric_circuits Busca os circuitos associados a um quadro elétrico, permitindo filtrá-los por características e situação de dimensionamento.
builder-get_circuit_properties Consulta as propriedades e os dados de dimensionamento de um circuito elétrico específico.

Exemplos de Skills para utilizar com o AltoQi Builder

As Skills são conjuntos de instruções que orientam o assistente de IA na execução de tarefas ou análises específicas e tornam o assistente de IA especialista em um determinado assunto ou processo. Elas definem como utilizar as Tools disponíveis no MCP para consultar e relacionar informações do projeto de acordo com o objetivo desejado.

Para utilizar uma Skill no Claude:

  1. Acesse Personalizar.
  2. Clique em Habilidades.
  3. Clique em Adicionar > Fazer upload de uma habilidade.

A seguir, disponibilizamos exemplos de Skills que podem ser utilizados ou adaptados para diferentes cenários no AltoQi Builder.

Skill Função Exemplo de pedido
builder-nbr5410-analise Realiza uma análise complementar do projeto elétrico, considerando critérios da NBR 5410, dimensionamentos e boas práticas. Ao final, gera um relatório com os resultados e sugestões de ajustes. "Meu projeto tem alguma não conformidade com a NBR 5410 ou ponto possível de otimização?"
builder-nbr5626-analise Realiza uma análise complementar do projeto hidráulico, considerando critérios da NBR 5626, dimensionamentos e boas práticas. Ao final, gera um relatório com os resultados e sugestões de ajustes. "Valide se o dimensionamento de água fria e água quente está conforme a norma."
builder-memorial-descritivo Auxilia na criação do memorial descritivo a partir das informações do projeto consultadas pelo MCP, considerando as disciplinas e o conteúdo solicitado pelo usuário. "Gere o memorial descritivo do projeto elétrico."

Baixar skills