O que é AEC Model Bridge?
O AEC Model Bridge, mantido por A. Sam Mohammad, permite que Claude, Codex, Cursor e outros clientes MCP leiam e editem o modelo aberto no Revit 2024 a 2027. Ele tem duas partes: um servidor MCP em Python que fala com o cliente por stdio e um add-in nativo em C# para Revit que escuta em 127.0.0.1 e executa ações na thread principal do Revit. Ferramentas só de leitura rodam na hora; por padrão, ferramentas que alteram o modelo ficam bloqueadas até que uma pessoa aprove um plano no painel do Revit ou na linha de comando. O mesmo servidor também lê arquivos IFC sem o Revit e controla Rhino, Grasshopper e Speckle.
O repositório foi criado em janeiro de 2026, tem cerca de 109 estrelas e 27 forks e lançou a v1.4.0 em 9 de outubro de 2026, com o último push em 28 de outubro de 2026. Ele tem licença GPL-3.0-or-later com uma Revit Linking Exception, ou uma licença comercial do mantenedor. O README diz com todas as letras que nada nele foi verificado ainda em uma sessão real do Revit.
Como instalar AEC Model Bridge
uvx --from git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit aec-model-bridgeAEC Model Bridge vale a pena?
O AEC Model Bridge pensou mais a fundo em deixar uma IA alterar um modelo BIM do que qualquer outro servidor de Revit que conhecemos, e ainda não provou que nada disso funciona. Seu próprio README diz que nada foi verificado em uma sessão real do Revit: o servidor Python é testado contra provedores simulados, e a CI compila o add-in para Revit 2024 a 2027 sem nunca abrir o Revit. Isso faz dele um projeto para pilotar em uma cópia de um modelo, não para apontar para um projeto real de cliente.
A arquitetura é convencional e sólida. Um hub em Python fala stdio com o cliente e encaminha cada chamada a um provedor; o provedor do Revit fala com um add-in nativo em C# em uma porta de loopback dinâmica, com um bearer token aleatório criado a cada sessão. Ele não usa pyRevit: existe um módulo de ponte para pyRevit, mas o lado do add-in que rodaria os scripts não está implementado. A configuração padrão lista 219 ferramentas, 103 delas para Revit, e o catálogo gerado marca 42 delas como leitura e 61 como escrita. O lado da escrita inclui revit_execute_python e revit_invoke_method, que alcançam toda a API pública do Revit, mas ambas são marcadas como mutáveis e por isso ficam atrás da barreira.
A barreira é o motivo para olhar este projeto. No modo padrão ask_first, o assistente redige um plano com plan_actions; approve_plan, reject_plan e rollback_plan nunca são oferecidas à IA, e uma pessoa aprova no painel do Revit ou com o comando aec-model-bridge-approve. Uma aprovação fica ligada a um hash do conteúdo do plano, e cada ação aprovada roda uma vez. O documento de segurança lista as lacunas com franqueza incomum. O painel não mostra as notas de revisão do assistente, então a visualização show da linha de comando é a única verificação completa. Valores anteriores só são capturados para revit_set_parameter_value. As aprovações não expiram nem se ligam a um documento, então um plano redigido em um Revit aberto pode rodar em outro. Qualquer processo rodando com seu usuário do Windows pode ler o token do painel e aprovar, então um cliente de IA com shell nessa conta derruba todo o esquema.
O desfazer é por ação. Cada edição de parâmetro ou de modelo roda em sua própria transação nomeada, então o Ctrl+Z desfaz uma ação por vez; salvamentos, sincronizações com o central e scripts não estão cobertos. Os dados do modelo que as ferramentas devolvem vão para o provedor de IA que estiver por trás do seu cliente, o que importa quando o modelo é um projeto confidencial de um cliente. O projeto em si não envia telemetria, e seus planos e arquivos de prova, que guardam nomes de elementos e valores de parâmetros, ficam em uma pasta de trabalho local.
A licença precisa ser lida antes que um escritório construa em cima dela. A GPL-3.0-or-later permite que um escritório o use e modifique internamente de graça, mas a Revit Linking Exception não permite o código dentro de um add-in proprietário; isso exige uma licença comercial. O campo é concorrido e jovem. O mcp-servers-for-revit/revit-mcp tem cerca de 475 estrelas, mas nenhum push desde fevereiro de 2026, e o Revit Public MCP Server da própria Autodesk é uma prévia técnica só para o Revit 2027.2, cuja página de ajuda pede que você revise as mudanças propostas e faça backup do modelo. O AEC Model Bridge cobre quatro anos de Revit e tem a resposta escrita mais forte para quem aprova uma mudança; o que falta é a evidência de que essa resposta se sustenta dentro do Revit.
Onde ele se destaca
Um coordenador de BIM em um escritório de arquitetura de 60 pessoas
Triar os avisos do modelo antes da reunião semanal de coordenação
Rode o servidor no modo look_only e peça ao assistente para agrupar a saída de revit_get_warnings por descrição e listar os IDs dos elementos afetados. Nada pode alterar o modelo nesse modo, então o risco se limita ao que os avisos revelam ao provedor de IA.
Um gerente de BIM limpando parâmetros em um projeto de hospital
Preencher valores de Comments ou Mark que faltam em centenas de paredes
Faça o agente redigir o lote com plan_actions, leia-o com aec-model-bridge-approve show, depois aprove e leia os valores de volta. Mantenha os planos em algumas centenas de ações e espere vários Ctrl+Z para desfazer um plano.
O gerente de projeto de uma construtora que recebe modelos de consultores
Verificar os pavimentos e as propriedades de um arquivo IFC sem abrir o Revit
Use ifc_get_spatial_structure, ifc_get_properties e ifc_validate, que leem IFC pelo IfcOpenShell em qualquer máquina. Nenhuma licença de Revit é necessária para essa parte, e as ferramentas não editam o arquivo.
Um líder de software em uma empresa de engenharia com ferramentas internas para Revit
Decidir se incorpora a ponte ao add-in próprio da empresa
Avalie primeiro a lista de ferramentas no modo simulado ou na imagem Docker. Distribuí-lo dentro de um add-in proprietário exige a licença comercial, cujos termos e preço são combinados com o mantenedor e não são publicados.
Antes de decidir
- Configuração
- Exige Windows 10 ou 11, um Revit 2024 a 2027 licenciado, Python 3.11 ou mais recente e uv. O instalador da v1.4.0 para Windows escolhe seus anos de Revit, não exige direitos de administrador e pode configurar o Claude Desktop e o VS Code depois de fazer backup das configurações deles; caso contrário, adicione a linha uvx ao cliente e rode install.ps1 para o add-in. Uma aba AEC Bridge na faixa de opções e uma verificação /health confirmam a conexão.
- Integrações
- 219 ferramentas na configuração padrão: 103 para Revit, mais IFC, Rhino e Grasshopper, Speckle, módulos de QA/QC por snapshot e um provedor de Navisworks em andamento. As ferramentas trazem anotações readOnlyHint e destructiveHint. A configuração é documentada para Claude Desktop, VS Code com GitHub Copilot, Cursor e Codex; outros clientes stdio não foram testados.
- Dados e privacidade
- Servidor e add-in rodam localmente e a ponte escuta só no loopback; o que as ferramentas leem do modelo vai para o seu provedor de IA, e o chat embutido do painel envia para a Anthropic. Sem telemetria. Planos e pacotes de prova guardam nomes de elementos e valores de parâmetros na pasta de trabalho, e o acesso a arquivos se limita a MCP_REVIT_ALLOWED_DIRECTORIES.
- Custo em escala
- O software é grátis sob a GPL. Os custos reais são uma assinatura do Revit para cada pessoa que o roda de verdade, o plano ou os tokens do cliente de IA e o contexto ocupado por uma lista de 219 ferramentas em toda sessão. Os preços da licença comercial não são publicados.
- Limites
- O comportamento no Revit real não foi verificado em nenhum ponto; o README descreve o branch dev, que pode estar à frente da última versão. A execução de planos fica mais lenta com o tamanho, então os planos devem ficar abaixo de algumas centenas de ações. O rollback_plan não tem botão no painel nem comando, e a entrada oficial no MCP Registry ainda lista a v1.0.1.
O que é bom
- Ferramentas de escrita bloqueadas até que uma pessoa aprove um plano com hash
- Ferramentas de aprovação nunca expostas à IA
- Cobre Revit 2024 a 2027, além de IFC sem Revit
- Limites de segurança documentados com detalhe incomum
O que não é
- Nunca verificado em uma sessão real do Revit, segundo o próprio projeto
- A aprovação pelo painel esconde as notas de revisão do assistente
- As aprovações não expiram nem se ligam a um documento
- A GPL impede incluí-lo em add-ins proprietários sem licença paga
Ideal para
Coordenadores de BIM e líderes de prática digital dispostos a pilotar um agente em cópias de modelos do Revit, onde a aprovação humana de cada mudança é um requisito.
AEC Model Bridge: perguntas frequentes
- AEC Model Bridge vale a pena?
- Um design de aprovação incomumente cuidadoso para colocar um agente dentro do Revit, de um mantenedor honesto o bastante para dizer que nada disso rodou ainda em uma sessão real do Revit. Damos nota 3.4 de 5.
- Quanto custa AEC Model Bridge?
- Grátis sob GPL-3.0-or-later com uma Revit Linking Exception, ou licença comercial sob consulta (preço não publicado). Exige um Revit 2024 a 2027 licenciado.
- Quais são as desvantagens de AEC Model Bridge?
- Nunca verificado em uma sessão real do Revit, segundo o próprio projeto; a aprovação pelo painel esconde as notas de revisão do assistente; as aprovações não expiram nem se ligam a um documento; a GPL impede incluí-lo em add-ins proprietários sem licença paga.
- Para quem AEC Model Bridge é indicado?
- Coordenadores de BIM e líderes de prática digital dispostos a pilotar um agente em cópias de modelos do Revit, onde a aprovação humana de cada mudança é um requisito.
- Quanto custa AEC Model Bridge para uma equipe ou em produção?
- O software é grátis sob a GPL. Os custos reais são uma assinatura do Revit para cada pessoa que o roda de verdade, o plano ou os tokens do cliente de IA e o contexto ocupado por uma lista de 219 ferramentas em toda sessão. Os preços da licença comercial não são publicados.
- AEC Model Bridge é seguro para dados da empresa?
- Servidor e add-in rodam localmente e a ponte escuta só no loopback; o que as ferramentas leem do modelo vai para o seu provedor de IA, e o chat embutido do painel envia para a Anthropic. Sem telemetria. Planos e pacotes de prova guardam nomes de elementos e valores de parâmetros na pasta de trabalho, e o acesso a arquivos se limita a MCP_REVIT_ALLOWED_DIRECTORIES.
Respostas verificadas em 31 de out. de 2026.