Integração | Configurando o MCP do AltoQi Visus Collab 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 ou Claude, fornecendo acesso controlado às informações de um projeto.

Com a integração do MCP do AltoQi Visus Collab, é possível consultar apontamentos, comentários, pontos de vista, imagens e documentos das obras que você coordena  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.

Assuntos tratados neste artigo:

• Como obter o endereço MCP do AltoQi Visus Collab
• Como configurar o MCP do Visus Collab no ChatGPT
• Como configurar o MCP do Visus Collab no Claude
• Tools (funções) contempladas pelo MCP Visus Collab
• Análises e Recursos
  

   

Como obter o endereço MCP do AltoQi Visus Collab

O endereço do servidor MCP do AltoQi Visus Collab é:

https://mcp.collab.altoqivisus.com.br/mcp 

Esse endereço deverá ser utilizado durante a configuração da integração na ferramenta de inteligência artificial.

Antes de iniciar, certifique-se de que:

• Possui uma conta ativa no AltoQi Visus Collab;
• Possui acesso à internet;
• Está utilizando uma ferramenta de IA compatível com servidores MCP, como ChatGPT, Claude ou VS Code com GitHub Copilot .

Como configurar o MCP do Visus Collab 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:

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.

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 e Adicionar ().
3. No campo Nome, informe um nome para o aplicativo, como MCP Collab.
4. No campo Conexão, informe o endereço:

https://mcp.collab.altoqivisus.com.br/mcp

1. Em Autenticação, selecione OAuth.
2. Marque a opção Entendi e quero continuar.
3. 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. Autorize o acesso ao servidor MCP.
3. Inicie uma nova conversa no ChatGPT.

Reconectando ou desconectando o aplicativo

Para reconectar ou desconectar o AltoQi Visus Collab

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

Como configurar o MCP do Visus Collab 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.

1. No campo Nome, informe MCP Collab.
2. No campo de URL do servidor MCP remoto, informe:

https://mcp.collab.altoqivisus.com.br/mcp

1. Clique em Continuar.
2. Em Autenticação selecione a opção Entrar agora.
3. Em Cliente OAuth selecione a opção Registrar automaticamente.
4. Clique em Vincular
5. Faça login utilizando sua conta do AltoQi Visus Collab.

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

Reconectando ou desconectando o conector

Para reconectar ou desconectar o Workflow no Claude:

1. Acesse a seção Conectores.
2. Localize o conector do Collab.
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 Visus Collab

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 Visus Collab.

Projetos

Tool	Função	Exemplos de uso
bcf_list_projects	Lista as obras que o usuário autenticado pode acessar, com paginação e busca por nome. Cada obra vem com o link do viewer 3D em visão federada.	• "Quais obras eu tenho acesso no Visus Collab?"                            • "Encontre a obra Residencial X."
bcf_get_project	Retorna os detalhes de uma obra específica, com o link do viewer.	• "Me dê os detalhes da obra X."
bcf_get_project_extensions	Retorna os valores controlados da obra: tipos de apontamento, status, prioridades, usuários, etiquetas, etapas e ações disponíveis.	• "Quais status e prioridades existem nessa obra?"                  • "Quais etiquetas estão disponíveis no projeto X?"
bcf_navigate	Abre o BCF Navigator, a interface interativa de navegação hierárquica. Sem parâmetro, lista as obras; com a obra informada, abre o detalhe dela.	• "Abra o BCF Navigator."                      • "Quero navegar pelos apontamentos do projeto X."

Apontamentos

Tool	Função	Exemplos de uso
bcf_list_projects	Lista os apontamentos da obra, com filtros por status, tipo, prioridade, responsável e etiqueta, com paginação. Cada item traz o link do viewer já posicionado no apontamento.	• "O que está com prazo vencido e ainda aberto nessa obra?"                                              • "Quais apontamentos urgentes estão sem responsável?"                                • "Liste os apontamentos abertos da disciplina hidráulica."
bcf_get_project	Retorna o detalhe completo de um apontamento, com o link do viewer.	• "Detalha o apontamento de interferência entre estrutura e hidráulica."                                     • "Qual a situação atual do apontamento Y?"

Comentários

Tool	Função	Exemplos de uso
bcf_list_comments	Retorna o histórico de discussão de um apontamento.	• "O que foi discutido nesse apontamento?" • "Mostra o histórico de comentários do apontamento Y."
bcf_get_comment	Retorna um comentário específico.	• "Mostre o comentário mais recente na íntegra."

Viwepoints e imagens

Tool	Função	Exemplos de uso
bcf_list_viewpoints	Lista os pontos de vista associados a um apontamento.	• "Quais pontos de vista esse apontamento tem?"
bcf_get_viewpoint	Retorna o ponto de vista completo: câmera, componentes, planos de corte e linhas.	• "Quais componentes estão destacados nesse ponto de vista?"
bcf_get_snapshot	Retorna os metadados da imagem capturada naquele ponto de vista.	• "Que imagens existem para esse apontamento?"
bcf_get_snapshot_image	Retorna a imagem em si, permitindo que o assistente consiga analisá-la. Em clientes compatíveis, renderiza em um visualizador dentro da conversa, com link para abrir no Visus Collab.	• "Me mostra a imagem desse apontamento."              • "O que aparece na imagem do apontamento mais crítico?"
bcf_get_snapshot_data_uri	Retorna a mesma imagem em formato embutível, para clientes que não suportam o visualizador dentro da conversa.	• "Inclua a imagem do apontamento no relatório."

Pessoas e documentos

Tool	Função	Exemplos de uso
bcf_list_project_users	Lista os usuários com acesso à obra.	• "Quem tem acesso a essa obra?"
bcf_list_related_documents	Lista os modelos IFC e documentos vinculados à obra, com o link para abrir cada modelo no viewer.	• "Quais modelos IFC estão vinculados à obra?"
bcf_get_related_document	Retorna os detalhes de um documento vinculado, com o link do viewer.	• "Detalha o documento Z e me dê o link do viewer."

Viewer 3D

Tool	Função	Exemplos de uso
bcf_compose_viewer_url	Gera um link direto para o viewer sob demanda: visão federada com todos os modelos ativos, ou um modelo específico, com posicionamento opcional em um apontamento.	• "Me dê o link para abrir o projeto X no viewer 3D."      • "Quero um link para ver o apontamento Y no modelo."                                 • "Liste os apontamentos com o link direto para cada um no viewer."

Análises e Recursos

Além das consultas em linguagem natural, o MCP do Visus Collab disponibiliza análises prontas e recursos para explorar as informações da obra de forma visual e interativa. 

Análises prontas

O servidor disponibiliza análises pré-configuradas que podem ser acionadas por comando. Basta informar a obra, e o assistente realiza as consultas necessárias e organiza o resultado de forma padronizada. Cada análise vem acompanhada de um painel interativo.

Comando	O que entrega
resumo_executivo_projeto	Visão geral da obra, com totais por status e prioridade, percentual de resolução, vencidos e avaliação de risco.
painel_prazos_criticos	Agrupa o que já venceu, o que vence nos próximos 7 dias e o que é de prioridade alta ou urgente mas está sem prazo.
relatorio_por_responsavel	Distribuição por responsável, com totais por status e apontamentos vencidos,  base para reunião de acompanhamento.

O que é possível analisar

Não é necessário utilizar os comandos para realizar análises. As consultas também podem ser feitas diretamente em linguagem natural.

Alguns exemplos:

• "Quais apontamentos urgentes estão sem responsável?"
• "Quais apontamentos estão sem movimentação recente?"
• "Quais apontamentos estão sem prazo ou prioridade?"
• "Como estão distribuídas as pendências entre os responsáveis?"

BCF Navigator

O BCF Navigator permite navegar pelas informações da obra diretamente na conversa, incluindo apontamentos, comentários, pontos de vista, documentos e usuários.

Por exemplo:

• "Abra o BCF Navigator."
• "Quero navegar pelos projetos."
• "Explore os apontamentos em aberto do projeto X."

Imagem do apontamento e Viewer 3D

O MCP também permite visualizar a imagem associada ao ponto de vista de um apontamento e obter links para acessar a obra ou uma situação específica diretamente no Viewer 3D do Visus Collab.

Por exemplo:

• "Me mostra a imagem desse apontamento."
• "O que aparece na imagem do apontamento mais crítico?"
• "Me dê o link para abrir o projeto X no Viewer 3D."
• "Quero ver o apontamento Y no modelo."

Visualizações sob demanda

As informações também podem ser apresentadas em tabelas, indicadores, gráficos e painéis interativos, de acordo com a análise solicitada.

Por exemplo:

• "Mostre um dashboard dos apontamentos por status e prioridade."
• "Crie um painel com os prazos críticos da obra."
• "Mostre os apontamentos por responsável em forma de gráfico."