[NOVO RECURSO] Configurando o MCP do AltoQi Eberick 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, como o ChatGPT, fornecendo acesso controlado às informações de um projeto.

Com a integração do MCP do AltoQi Eberick, é possível consultar dados do projeto diretamente em ferramentas de IA utilizando linguagem natural. Dessa forma, o assistente pode responder perguntas com base nas informações disponibilizadas pelo servidor MCP, tornando a consulta e a análise dos projetos mais rápidas e intuitivas.

Este artigo apresenta como conectar o AltoQi Eberick ao servidor MCP e configurá-lo em ferramentas de inteligência artificial, como ChatGPT e Claude, para consultar informações dos projetos.

• Como obter o endereço MCP AltoQi Eberick

• Como configurar o MCP do AltoQi Eberick no ChatGPT

• Como configurar o MCP do AltoQi Eberick no Claude

• Tools (funções) contempladas pelo MCP AltoQi Eberick

• Exemplos de perguntas que podem ser realizadas

• Exemplos de Skills para utilizar com o AltoQi Eberick

• Perguntas frequentes

Como obter o endereço MCP AltoQi Eberick

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

• No AltoQi Eberick, com um croqui de projeto aberto, acesse a aba Colaboração.
• No grupo Integrações com IA, clique em AltoQi Axis MCP.

• Na janela exibida, clique em Conectar.

• Após estabelecer a conexão, copie o Link de conexão exibido na janela.

O botão AltoQi Axis MCP também está disponível na barra de acesso rápido e permanece habilitado mesmo quando não há um projeto aberto. 

Como configurar o MCP do AltoQi Eberick no 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:

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

Criando o aplicativo no ChatGPT

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

• Ainda em Configurações, acesse Plugins e clique em Explorar plugins.

• Em seguida, clique no botão +.

• Siga o fluxo apresentado para criar um novo aplicativo.
• No campo Nome, informe um nome para o aplicativo, como MCP AltoQi Eberick.
• No campo Conexão, cole o Link de conexão copiado anteriormente no AltoQi Eberick
  • https://mcp.altoqi.com.br/eberick/mcp
• Em Autenticação, selecione OAuth.
• Acesse Configurações avançadas de OAuth e altere o método de registro para Cliente OAuth definido pelo usuário.
• No campo ID do cliente OAuth, informe altoqi-connect.
• No campo Segredo do cliente OAuth, informe altoqi-connect.

• Selecione Entendi e quero continuar e clique em Criar.

• Faça login na sua conta AltoQi e selecione a conta desejada.

Configurando as permissões

Após concluir a conexão com o aplicativo, configure as permissões de acesso:

• Conceda a permissão Permitir todas as ações.

Reconectando ou desconectando o aplicativo 

• Acesse Configurações.
• Selecione Plugins.
• Localize o plugin desejado.
• Clique sobre o plugin e, em seguida, no ícone de reticências.
• Selecione Reconectar ou Desconectar, conforme necessário.

Como configurar o MCP do AltoQi Eberick no Claude

Criando o conector no Claude

Para configurar o MCP no Claude:

1. Acesse Personalizar na barra lateral.
2. Clique em Conectores.
3. Clique em Adicionar > Adicionar conector personalizado.

• No campo Nome, informe um nome para identificar a conexão, como MCP AltoQi Eberick.
• No campo URL do servidor MCP remoto, cole o Link de conexão copiado anteriormente no AltoQi Eberick e clique em Continuar.

 

• No campo ID do cliente OAuth, informe altoqi-connect.
• Clique em Adicionar.

• Na tela de autenticação, faça login com sua conta AltoQi.
• Após o login, atualize a Lista de Ferramentas.

• Conceda permissão para as ferramentas.

Reconectando ou desconectando o conector 

Caso seja necessário atualizar ou remover a conexão:

• No Claude, acesse Personalizar > Conectores.
• Localize o conector do MCP AltoQi Eberick.
• Clique no ícone de reticências (...) ao lado do conector.
• Para reconectar, selecione Atualizar lista de ferramentas.
• Para remover a conexão, selecione Excluir.

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

As Tools podem ser entendidas como funções ou comandos disponíveis no MCP. Cada função permite realizar uma consulta específica no AltoQi Eberick. A seguir, apresentamos as Tools disponíveis no MCP do AltoQi Eberick.

Projeto

Tool	O que faz	Exemplos de pedido
eberick-get_floors	Retorna os pavimentos do projeto aberto no Eberick, com índice, nome, altura e cota.	• “Quais pavimentos do meu projeto?”

Relatórios

Tool	O que faz	Exemplos de pedido
eberick-get_report_project_criteria	Retorna o relatório de critérios de projeto estrutural, incluindo dados do projeto, durabilidade, materiais, ações, combinações, cargas, incêndio, análise e dimensionamento.	• “Com que critérios de durabilidade e materiais esse projeto foi calculado?”
eberick-get_report_structure_diagnostics	Retorna o diagnóstico global da estrutura, com indicadores de cargas, estabilidade, deslocamentos, dinâmica, consumo, custos e dimensionamento.	• “Me dê um resumo diagnóstico global dessa estrutura.”
eberick-get_report_adopted_combinations	Retorna as combinações de carregamento adotadas para a análise e o dimensionamento da estrutura.	• “Quais combinações de carregamento foram usadas na análise?”
eberick- get_report_gamma_z _stability_verification	Retorna o relatório da estabilidade global da estrutura, com o coeficiente Gama-Z e a indicação dos efeitos de segunda ordem.	• “Qual o Gama-Z dessa estrutura e ela precisa considerar efeitos de segunda ordem?”
eberick-get_report_p_delta_analysis	Retorna os deslocamentos adicionais e as forças horizontais causadas pelos efeitos de segunda ordem (P-Delta).	• “Como estão os efeitos de segunda ordem do projeto?”
eberick-get_report_global_imperfections	Retorna as imperfeições geométricas globais, incluindo cargas de desaprumo, cargas por pavimento e deslocamentos associados.	• “Quais as cargas de desaprumo por pavimento nesse projeto?”
eberick- get_report_horizontal _wind_displacements	Retorna os deslocamentos horizontais causados pelo vento, com verificação dos limites normativos.	• “Os deslocamentos por vento estão dentro do limite da norma?”
eberick- get_report_horizontal _seismic_displacements	Retorna os deslocamentos horizontais sob ação sísmica, com verificação dos limites normativos.	• “A estrutura atende aos limites de deslocamento sob ação sísmica?”
eberick-get_report_dynamics_analysis	Retorna a análise dinâmica, incluindo frequências naturais, participações modais e verificação do conforto humano sob ação do vento.	• “Essa estrutura atende ao conforto humano frente à ação do vento?”
eberick- get_report_wind_forces	Retorna as forças de vento estático e dinâmico, com resultados por pavimento.	• “Quais as forças de vento por pavimento nesse projeto?”
eberick-get_report_seismic_forces	Retorna as forças sísmicas e os esforços cortantes por pavimento, conforme as combinações modais e direcionais adotadas.	• “Quais os esforços cortantes por pavimento causados pela ação sísmica?”
eberick-get_report_foundation_loads	Retorna as cargas nas fundações, com valores verticais por caso de carregamento e a carga máxima.	• “Qual a carga máxima transmitida às fundações desse projeto?”
eberick-get_report_foundation_forces	Retorna os esforços nas fundações, incluindo cargas axiais, momentos, cortantes e torções, por caso ou combinação de carregamento.	• “Quais os esforços na fundação F12 na combinação mais crítica?”
eberick-get_report_analysis_messages	Retorna as mensagens geradas durante o processamento estrutural, incluindo avisos, erros e resultados da análise.	• “Existem avisos ou erros no último processamento desse projeto?”
eberick-get_report_full_calculation	Retorna o Relatório de Cálculo completo, reunindo os relatórios disponíveis no programa em um único documento.	• “Me dê um resumo do relatório de cálculo completo desse projeto.”

Exemplos de perguntas que podem ser realizadas

• Ver o panorama do projeto direto na conversa: consulte pavimentos, critérios de projeto e relatórios de cálculo sem navegar manualmente pelo software.
• Auditar a estrutura em segundos: acesse diagnóstico global, estabilidade (Gama-Z), deslocamentos por vento e ação sísmica, efeitos de segunda ordem, análise dinâmica, cargas nas fundações e o Relatório de Cálculo completo — tudo direto do modelo processado.
• Verificar a uniformização das fundações: relatório visual da taxa de compressão (ni) das sapatas/blocos, com destaque para as fundações fora do padrão.

Exemplos de Skills para utilizar com o AltoQi Eberick

As Skills são roteiros prontos que orientam o assistente de IA na utilização das Tools, organizando as consultas e os resultados para uma finalidade específica. Clique em baixar skill para obter o arquivo e carregue-o no seu assistente antes de iniciar a análise. 

Para utilizar uma Skill no Claude:

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

Skills disponíveis

Skill	O que faz	Exemplos de pedido
eberick-taxa-compressao-pilares	Gera um relatório visual em SVG sobre a uniformização da taxa de compressão (ni) das fundações, como sapatas ou blocos, a partir da tabela-resumo do pavimento de fundação. Destaca quais fundações estão fora de 1 desvio-padrão da média.	• “Quero ver a uniformização da taxa de compressão das fundações desse projeto.” • “Tem alguma sapata com ni muito fora do padrão das demais?”

Baixar Skill

Perguntas Frequentes

Não encontro o botão "AltoQi Axis MCP" na barra de acesso rápido. O que fazer?

O MCP do AltoQi Eberick está disponível a partir da atualização 2026-08 para clientes com assinatura inscritos no programa Beta. Para registrar seu interesse em se tornar um usuário beta tester do AltoQi Eberick, acesse Programa Beta | AltoQi Eberick.

Se você já participa do programa, confirme que está utilizando a versão mais atualizada do AltoQi Eberick.

A conexão com o MCP caiu durante o uso. O que fazer?

Fechar o AltoQi Eberick, atualizar para uma nova versão ou uma instabilidade podem encerrar a conexão MCP ativa. Nesse caso, conecte novamente o MCP no AltoQi Eberick e inicie uma nova conversa com o assistente de IA.

O assistente de IA diz que não consegue acessar o AltoQi Eberick. O que fazer?

A sessão MCP pode ter expirado. Verifique se a conexão com o MCP está ativa no AltoQi Eberick e reconecte o servidor nas configurações da ferramenta de IA utilizada.

O MCP aparece na ferramenta de IA, mas não retorna dados. O que fazer?

Confirme que concluiu o login na sua conta AltoQi durante a configuração do conector e selecionou a conta correta. Se necessário, reconecte o MCP e faça login novamente.

O assistente retorna resultados parciais ou informa que não encontrou dados. O que fazer?

Verifique se a consulta realizada está dentro do escopo dos dados disponíveis no projeto aberto no AltoQi Eberick.