15. A IA no Revit (MCP)

Com o BIMit você conversa com a sua IA e ela usa o BIMit por você: «converta a tabela WBS do cliente numa configuração e grave-a no modelo», «exporte em PDF as folhas revisadas», «quais parâmetros de projeto estão vazios?». Funciona com qualquer app de IA que usa servidores MCP locais: Claude Desktop, Claude Code, Gemini CLI, Antigravity, o app desktop do ChatGPT (ou o Codex), GitHub Copilot no VS Code, Cursor, LM Studio ou outro (A sua IA). A IA vê as ferramentas dos pacotes ligados e as usa no modelo aberto, com a sua conta daquele app. Funciona também com vários Revit abertos ao mesmo tempo. É opcional: se você não o ativar, o BIMit funciona como sempre.

A IA não está incluída no BIMit: você usa o seu app de IA, com a sua conta, ou um modelo local.

Ligar e desligar#

Na aba BIMit, o painel IA tem dois botões:

BotãoO que faz
IA On / IA OffConecta ou desconecta a IA deste Revit. O símbolo é verde quando está ligado (IA On), vermelho quando está desligado (IA Off). Com todos os Revit desligados, a IA vê só as ferramentas bimit_stato, que explica como ligá-lo, e revit_istanze.
NívelO que a IA pode fazer neste Revit (abaixo).

O que antes ficava na janela Config MCP agora está em Configurações → A sua IA.

O botão Nível#

O nível diz até onde a IA pode ir neste Revit; os pacotes dizem quais ferramentas ela vê; durante a beta a sua conta inclui todas, exceto as prévias do desenvolvedor (Acesso na beta). O menu do botão mostra três níveis: Leitura, Escrita e Equipe.

NívelO que a IA pode fazer
LeituraLê o modelo, as vistas e os arquivos; seleciona, pede que você clique, abre um modelo desvinculado. Não altera nada.
EscritaTambém grava no modelo (transações do Revit, que se desfazem com Ctrl+Z) e nos arquivos deste PC. É o padrão.
EquipeTambém as ações de equipe: sincronizar com o central, liberar elementos e worksets, salvar como central. Cada uma pede a sua aprovação numa janela do Revit.
CódigoPrévia do desenvolvedor, em breve: também código C# e Python dentro do Revit, DLLs, comandos e botões do Revit. Na beta pública não está no menu.

Só você escolhe: nenhuma ferramenta da IA pode aumentá-lo. Equipe (e Código) valem pelo tempo que você escolher, depois volta-se ao padrão; a cada início do Revit começa-se do padrão.

A primeira vez#

  1. Instale o seu app de IA no computador e entre com a sua conta. É preciso o app para computador: a versão web não vê o Revit.
  2. No Revit abra um modelo, clique em Configurações → A sua IA e configure o seu app (A sua IA).
  3. Reinicie o app de IA: feche-o por completo (também pela barra de tarefas, perto do relógio) e abra-o de novo.
  4. No Revit clique em IA Off para que vire IA On (verde). Experimente perguntar à IA: «Que modelo está aberto no Revit?»

Nas vezes seguintes basta clicar em IA On no Revit. Se você ligar outro Revit com o app já aberto, normalmente a IA vê as novas ferramentas sozinha depois de alguns segundos; se não as vir, abra uma nova conversa ou reinicie o app.

A sua IA#

Em Configurações → A sua IA você vê os apps que o BIMit sabe configurar, cada um com o seu estado. O BIMit adiciona só o servidor dele (bimit) ao arquivo de configuração do app: os outros servidores que você já tem ficam como estão.

O estado de cada app é Conectado · 10:42 (usou o BIMit nas últimas 24 horas), Configurado, Não configurado ou Não instalado. Configurar adiciona o BIMit ao arquivo do app (a versão anterior fica ao lado, .bimit.bak); Testar abre o app com uma pergunta de teste já escrita (também a copia para a área de transferência, caso o app não a preencha); Remover tira só o BIMit.

Os botões Pedir à IA (aba BIMit, janela de todas as ferramentas) fazem o mesmo: abrem o primeiro app que já tem o BIMit (Claude Desktop, depois Claude Code, depois os outros), para que a resposta venha de uma IA que já chega ao Revit; se nenhum tem, configuram o primeiro instalado que o BIMit sabe configurar. Com o Claude o pedido já vem escrito; com os outros apps ele está na área de transferência e você o cola com Ctrl+V.

AppO que o BIMit configura
Claude DesktopO chat do Claude Desktop, como antes (Adicionar ao Claude Desktop).
Claude CodeO plugin do BIMit, com os seus comandos (no terminal ou na aba Code do Claude Desktop), ou o prompt de conexão. Remove-se com os comandos do próprio Claude Code: Remover os copia para a área de transferência.
App desktop do ChatGPT (ou o Codex)O arquivo ~/.codex/config.toml (%CODEX_HOME%\config.toml quando está definida), seção [mcp_servers.bimit]. O ChatGPT na web não vê o Revit.
GitHub Copilot no VS CodeO arquivo %APPDATA%\Code\User\mcp.json, item servers.
CursorO arquivo ~/.cursor/mcp.json.
Gemini CLIO arquivo ~/.gemini/settings.json, item mcpServers (as suas outras configurações ficam como estão). Depois abra um novo terminal, inicie gemini e digite /mcp: o bimit está na lista. O Gemini pede permissão antes de usar uma ferramenta: você pode permitir uma vez ou sempre.
AntigravityO arquivo ~/.gemini/config/mcp_config.json, para a IDE e para a linha de comando (agy). Feche e abra de novo o Antigravity: o bimit aparece entre os servidores MCP (no app, em Settings → Customizations).
LM StudioO arquivo ~/.lmstudio/mcp.json. Com um modelo local os pedidos não saem do PC.
Outro appCopiar configuração: a configuração para colar em qualquer app que usa servidores MCP locais.

Todos os apps veem as mesmas ferramentas, com as mesmas permissões: um pacote desligado na barra está desligado para todas as IAs.

As habilidades (skills). Além das ferramentas, o BIMit dá à sua IA habilidades: pastas de instruções que dizem a ela como trabalhar bem com o BIMit (modelar, conferir os dados BIM, exportar as folhas, escrever código seguro, manter a continuidade de um projeto, construir famílias a partir de uma ficha técnica…; as de código, de CAD → BIM e de famílias a partir de ficha técnica são da prévia do desenvolvedor). A IA as carrega sozinha quando o seu pedido tem a ver com elas. Com o Claude Code elas vêm com o plugin do BIMit; com o Gemini CLI e o Antigravity o BIMit as copia para as pastas de habilidades daquele app quando você clica em Configurar, e as atualiza junto com o BIMit. Remover tira só as que o BIMit escreveu: as suas pastas ficam onde estão.

Atividade da IA#

No quadro BIMit, Atividade da IA mostra as últimas ações da IA neste Revit. O registro completo indica também qual app fez cada ação.

O que a IA pode fazer#

As ferramentas dos pacotes, por área (em itálico as que modificam o modelo ou gravam arquivos):

ÁreaPacoteO que fazFerramentas
ModeloLerA IA lê o modelo: elementos, parâmetros, vistas e tabelas. Não altera nada. Sempre ligado.modello_info, categorie, elementi, parametri_elemento, selezione, seleziona, viste, leggi_tabella, livello_accesso, modello_mappa, vicino_a, vista_immagine
ModeloNíveisLista os níveis e leva um nível a uma nova cota com os elementos associados.livelli, sposta_livello_analizza, sposta_livello
ModeloDesafixarEncontra e desafixa os elementos fixados.sblocca_analizza, sblocca
ModeloAbrir modelosAbre outros modelos em segundo plano, desvinculados, para lê-los.modello_apri, job_stato, job_annulla
FolhasExportarExporta as folhas em PDF e DWG e prepara a lista de documentos.tavole_elenco, tavole_parametri, tavole_nomi_anteprima, tavole_apri, tavole_esporta, tavole_report, tavole_elenco_elaborati
FolhasFilaPrepara a fila de exportação e as seleções salvas.tavole_coda, tavole_coda_modifica, tavole_imposta_elementi, tavole_selezione_salva, tavole_selezione_elimina
FolhasPerfisGerencia perfis e predefinições de exportação, inclusive os da equipe.tavole_preset, tavole_salva_preset, tavole_collega_preset, tavole_profili, tavole_profilo_salva, tavole_profilo_applica, tavole_profilo_elimina, tavole_profilo_rinomina, tavole_profili_importa, tavole_profilo_predefinito
FolhasAgendarPrograma exportações recorrentes.tavole_pianificazioni, tavole_pianifica, tavole_pianificazione_gestisci
DadosWBSCodifica os elementos com a WBS segundo a norma e as regras do projeto.wbs_guida, wbs_configurazione, wbs_salva_configurazione, wbs_anteprima, wbs_scrivi, wbs_valori, wbs_dizionario_esporta, wbs_dizionario_carica
DadosParâmetrosLê e preenche os parâmetros do projeto e dos elementos.imposta_parametri, parametri_categorie_e_gruppi, parametri_progetto, parametri_progetto_elimina, parametri_progetto_csv
DadosCompartilhadosLê e adiciona parâmetros compartilhados.parametri_condivisi_leggi, parametri_condivisi_aggiungi
DadosFamíliasLista as famílias e limpa os parâmetros delas.famiglie_elenco, famiglie_parametri, famiglie_elimina_parametri
DadosExportar para IAExporta tabelas do modelo para analisar com a IA.esporta_per_ia_tabelle, esporta_per_ia, esporta_per_ia_leggi
ModelarParedes e pisosCria paredes, pisos e forros.crea_muri, crea_pavimento, crea_controsoffitto
ModelarModificarMove, copia, posiciona e exclui elementos; limpa o que não é usado.trasforma, posiziona_famiglia, elimina_elementi, elimina_inutilizzati
ModelarAnotarCotas e identificadores.quota, etichetta
ModelarInteraçãoA IA pede que você clique pontos ou elementos e acompanha a sessão de trabalho.chiedi_punto, chiedi_elementi, lavoro, lavoro_annulla
MEPLuvasEncontra as interferências entre instalações e estrutura e cria as luvas.interferenze, manicotti_opzioni, manicotti_salva_opzioni, manicotti_analizza, manicotti_crea
MEPInstalaçõesCria e conecta tubos e dutos.mep_modelli, crea_mep, collega_mep
MEPAmbientes e espaçosCria os espaços MEP a partir dos ambientes.locali_spazi_analizza, locali_spazi
CAD → BIMCAD → BIMPrévia do desenvolvedor, em breve. De uma planta DWG, DXF ou PDF a paredes, aberturas e ambientes no modelo.disegno_leggi, disegno_analizza, disegno_immagine, pianta_verifica, pianta_modifica, pianta_confronta, pianta_costruisci
ProjetoProjetoA memória do projeto: cria, vincula, retoma, pesquisa.commessa_elenco, commessa_attiva, commessa_crea, commessa_collega, commessa_riprendi, commessa_cerca
ProjetoDiárioNotas, tarefas e diário do projeto.commessa_annota, commessa_attivita, commessa_diario, commessa_ripeti
ProjetoArquivoArquiva e-mails e documentos no projeto.commessa_archivia, commessa_arrivi
ProjetoEquipeSincroniza com o central e libera elementos, sempre com a sua confirmação no Revit.sincronizza_centrale, rilascia_elementi, salva_come_centrale

Existem também os pacotes da área Desenvolvimento (Código C#, Python, API do Revit, Script, Comandos do Revit), que o nível Código usa, e o do administrador (Usuários), só para a conta dele. Os pacotes Em breve (Uniclass, Criar família) ainda não têm ferramentas.

Prévia do desenvolvedor. O nível Código (com a área Desenvolvimento), CAD → BIM e PDF → família (famiglia_costruisci, famiglia_lavoro: a família construída a partir de uma ficha técnica) chegam em breve. Na beta pública eles não aparecem nem na aba, nem no quadro, nem em Todas as ferramentas, e a IA não os vê. Com a versão do desenvolvedor, o Paulo oferece modelagem e consultoria.

Cada ferramenta aceita também o argumento opcional «documento»: o título, o nome do arquivo ou o caminho completo de um documento aberto naquele Revit. Assim a IA lê ou modifica um modelo aberto sem que você o torne ativo; sem ele, usa o documento ativo.

Vários Revit juntos#

Você pode ligar IA On em vários Revit abertos ao mesmo tempo, também de versões diferentes (por exemplo 2024 e 2027, ou dois 2025): a IA vê todos.

  • Quais são — «quais Revit estão abertos?»: a IA usa revit_istanze, que para cada Revit dá o identificador (ano e número do processo, por exemplo 2025-18244), as versões do Revit e do BIMit e os documentos abertos.
  • Qual usar — «use o Revit 2024» ou «trabalhe no modelo Hospital»: a IA usa revit_usa com o identificador, o número do processo, o ano (se houver um só Revit daquela versão) ou o título de um documento aberto. Dali em diante a IA trabalha naquele Revit.
  • Para um só pedido — com dois ou mais Revit cada ferramenta tem o argumento opcional «revit»: a IA manda o pedido para um Revit específico sem mudar o escolhido.
  • Todos juntos — com «revit» igual a «tutte» a ferramenta roda em cada Revit e a resposta tem uma seção para cada um: «em todos os Revit abertos, quantas portas existem?».
  • Com um só Revit ligado a IA usa esse. Com vários Revit e nenhuma escolha, a IA recebe a lista e escolhe, ou pergunta a você qual usar.

Bom saber#

  • A IA grava diretamente no modelo, sem pedir confirmação. Cada operação é uma transação do Revit: Ctrl+Z a desfaz.
  • Enquanto estiver aberta uma janela do Revit ou do BIMit que bloqueia o Revit (uma caixa de diálogo), a IA espera: feche-a e ela continua.
  • O que você pede à IA e os dados do modelo que ela lê passam pelo fornecedor do seu app de IA (por exemplo a Anthropic para o Claude), com a sua conta (veja a política de privacidade).
  • Para a WBS a IA parte da configuração associada ao modelo, a mesma da janela WBS: o que ela salva você encontra lá, e vice-versa.