Primeiro a cena, depois a sigla
Caminho um: só chat. Você escreve «revisa as paredes do nível 3 e me diz quais não têm tipo». O modelo reconhece o tipo de problema, lembra como se fala de paredes e redige uma lista. Pode até avisar que falta o arquivo. Isso serve para pensar, não para trabalhar. Ninguém abriu o modelo. Ninguém filtrou por nível. Ninguém leu um parâmetro. Se você cola essa lista num relatório, está assinando uma conversa.
Caminho dois: alguém que de fato pode tocar o Revit. O mesmo pedido chega no app onde você já escreve para a IA — Claude Desktop, Cursor ou Cline — mas desta vez há um intermediário encaixado, como um garçom entre a sua mesa e a cozinha. O app em que você escreve mostra o que esse intermediário pode fazer. A IA escolhe uma ação dessa lista. O intermediário entra no Revit e executa. Volta um resultado com unidades, com IDs, ou um erro de verdade: «o modelo não está aberto», «esse nível não existe».
Aí se vê a diferença. Se o intermediário não está conectado, um chat inventa. Um sistema sério para e diz. Essa é a linha entre uma demo bonita e algo que você pode usar num projeto.
A peça que torna o caminho dois possível tem nome: MCP. Model Context Protocol. Não é um app. Não é um plugin. Não é um modelo mais esperto. É a tomada — ou, se preferir, o controle remoto: não cozinha o prato, mas leva o pedido a quem pode tocá-lo.
Esta nota faz parte da série sobre o harness de IA para engenharia civil. Aqui está H-03 Ferramentas (tools): as mãos delimitadas. O que segue é uma demo de mesa, não um caso de cliente. Se algo falhar, precisa se ver falhar.
O que é MCP, sem Silicon Valley
MCP é um acordo de como se fala entre o app em que você usa a IA e um programa como o Revit. Antes, cada app tinha de inventar o próprio jeito de falar com cada programa. Cinco apps e dez programas eram cinquenta conversas distintas para manter.
MCP propõe uma tomada comum. O app em que você escreve pergunta: «o que você consegue fazer?». A tomada responde com a lista. Não precisa de um tradutor diferente para cada par.
Por esse cabo viajam três tipos de coisa. No jargão de software se chamam tools, resources e prompts; no escritório se entendem assim:
Ações (tools). Uma ação com regras claras. Criar uma parede. Filtrar por nível. Exportar um quantitativo. Diz o que entra e o que sai. A IA não digita às cegas dentro do Revit: escolhe um nome da lista e a tomada executa dentro do programa.
Dados (resources). Um dado, não uma ação. O modelo aberto. Uma planta. Um quantitativo. A IA lê; não inventa.
Receitas (prompts). Um jeito sugerido de pedir algo. Não é o cálculo. Não é a assinatura.
Se você ficar com uma só imagem: o app é a mesa em que você pediu; a tomada é o garçom que de fato entra na cozinha (Revit); a IA só escolhe o próximo passo do cardápio. O número, a parede ou o erro não saíram da conversa. Saíram do Revit.
A primeira vez que você ouvir «cliente» e «servidor» nesse tema, traduza assim: cliente = o app em que você escreve; servidor = a tomada que de fato pode abrir e mexer coisas dentro do Revit.
O que existe hoje, e quanto pesa
A pergunta que aparece na hora: isso é da Autodesk? Já posso instalar?
Hoje, o que existe e se pode experimentar é comunitário e gratuito. Não é oficial.
Há um projeto chamado revit-mcp. Um fork mantido, LuDattilo/revit-mcp-server, lista 138 tools e cobre Revit 2023 a 2027. Inclui um painel de chat que se acopla dentro do Revit. Outro, Demolinator/revit-mcp-server, usa pyRevit e lista 48 tools. Os números são os que esses repositórios publicam; não os auditei um a um.
A Autodesk fala de MCP. O servidor oficial para Revit figura como coming soon, sem detalhes públicos no dia de escrever. Não vou vender como se já estivesse na sua instalação.
Fora do Revit há mais mãos, com a mesma lógica e maturidade diferente. mcp-calculix conecta Gmsh e CalculiX. A ODA anuncia servidores MCP para DWG, STEP e IFC. O Civil 3D tem pontes comunitárias, não oficiais. Nenhum desses é um agente de engenharia. São mãos. Mãos que se encaixam.
Se você instala numa tarde e vê o modelo responder, isso é real. Se conclui que já tem um engenheiro automático, isso não é.
Cinco coisas que a tomada não te dá
Instalar um MCP não transforma você num escritório com IA. Deixa encaixar uma mão. Há cinco confusões que aparecem no mesmo dia.
Primeira. «Instalei um MCP, já tenho um agente.» Não. Você tem uma tomada. Faltam permissões, memória, parada e assinatura. Isso é o harness.
Segunda. «O MCP abre o meu modelo sozinho.» Não. Alguém precisa ter o Revit aberto, a tomada ligada e o app conectado. Se faltar qualquer um dos três, não há mão.
Terceira. «Se a tool falha, o modelo completa o dado.» Isso é exatamente o que não deve acontecer. Se a tool falha, o sistema para. Se o modelo preenche a lacuna, você voltou ao caminho um.
Quarta. «Um MCP de código serve para estruturas.» Uma tomada de arquivos não é um motor de análise. Um MCP de Revit não é OpenSees. Cada mão faz uma família de coisas. Não misture.
Quinta. «O servidor assina.» O servidor não assina. A IA propõe. Você assina. Se não consegue apontar qual arquivo, qual versão e qual tool produziu o número, não copie para o relatório.
Nenhuma das cinco é detalhe. São a diferença entre uma tarde de curiosidade e um erro numa planta.
Conclusão
Fique com esta frase: você pede no app; a tomada é a mão; você assina.
MCP não é o agente. É a tomada que deixa a IA falar com o Revit. A oficina — permissões, memória, parada, evidência — é o harness. Se você se pergunta quem manda quando a IA já pode tocar os seus arquivos, esse é o artigo anterior. E se já leu, a pergunta desta semana é qual mão você vai encaixar.
Faça as três linhas sobre uma cópia. E se a demo não sair na sua máquina, não force: anote onde parou. Isso também é o ofício.
Fontes
- Model Context Protocol — Introduction
- revit-mcp (projeto original)
- LuDattilo/revit-mcp-server
- Demolinator/revit-mcp-server
- Casys AI — mcp-calculix
- ODA — MCP Servers
Avaliação e limitações
Trate as notas abaixo como contexto de avaliação, não como um cálculo ou uma verificação comprovados.
Avalie MCP como H-03 do harness: ferramentas com contrato, permissões e evidência — não como um interruptor mágico do Revit.