Conectar o Claude ao seu Revit
O MAPA-IA usa o Claude, a inteligência artificial da Anthropic, pelo aplicativo Claude Desktop. Essa conexão se faz uma vez só, tem um passo mais "técnico", mas é copiar e colar. Vamos juntos, com calma.
O que você precisa
Antes de começar, confirme que você tem:
- O plugin MAPA-IA já instalado no Revit (a aba MAPA aparece na barra do Revit)
- Uma conta no Claude, crie grátis em
claude.ai(só precisa de e-mail) - 10 minutos de calma
Passo a passo
-
Instale o Claude Desktop
Baixe em
claude.ai/download, instale e entre com sua conta. A conta gratuita funciona; o plano pago tem mais limite de uso. -
Abra a configuração pelo próprio Claude
No Claude Desktop: Configurações (engrenagem) → na coluna da esquerda, Desenvolvedor. Em "Servidores MCP locais", clique em "Editar Config". Esse botão abre a pasta do config, funciona igual em qualquer versão do Claude (Microsoft Store ou clássica).
-
Abra o arquivo no Bloco de Notas
Na pasta que abriu, ache o
claude_desktop_config.json. Clique nele com o botão direito → Abrir com → Bloco de Notas. -
Cole a configuração
Apague o que estiver no arquivo e cole o bloco abaixo. Troque <SeuUsuário> pelo nome da sua pasta em
claude_desktop_config.jsonC:\Users\.{ "mcpServers": { "revit": { "command": "C:\\Users\\<SeuUsuário>\\AppData\\Roaming\\Autodesk\\ApplicationPlugins\\OC_MAPA-IA.bundle\\Contents\\bridge\\RevitMCPBridge.exe", "args": [] } } }Salve com Ctrl+S e feche o Bloco de Notas.
-
Abra o Revit ANTES de reiniciar o Claude
- Abra o Revit e deixe aberto. A conexão só funciona se o Revit já estiver aberto quando o Claude inicia.
- Encerre o Claude Desktop por completo. Fechar a janela ou clicar "Sair" pode não bastar, ele fica em segundo plano. Jeito garantido: Ctrl+Shift+Esc (Gerenciador de Tarefas) → ache o app Claude → Finalizar tarefa.
- Reabra o Claude Desktop.
-
Confirme a conexão
Vá em Configurações → Desenvolvedor → Servidores MCP locais. O revit deve aparecer com o selo "running" (azul).
Esperadorevit com o selo "running".
Teste pedindo algo pro Revit: "o que está selecionado no Revit?" ou "quantas paredes tem nesse projeto?"
Conversando com o Revit
Com o Revit aberto e o Claude conectado, é só pedir em português, como você pediria pra uma pessoa:
"cria uma parede de 3 metros no Nível 1"
"quantas portas tem nesse projeto?"
"posiciona os módulos aéreos dessa cozinha"
O Claude usa as ferramentas do método MAPA pra executar direto no seu modelo, e te explica o que fez.
Comece com pedidos pequenos e específicos. Quanto mais claro o pedido, melhor o resultado, igualzinho com gente.
Conferir a conexão a qualquer momento
No Claude Desktop: Configurações → Desenvolvedor → Servidores MCP locais. O revit deve estar com o selo "running". Se não estiver, confira se o Revit está aberto e reinicie o Claude pelo Gerenciador de Tarefas (Finalizar tarefa → abrir de novo).
Problemas comuns
| Aconteceu isso… | Faça isso |
|---|---|
| O revit não aparece em "Servidores MCP locais" | Abra de novo o "Editar Config" e confira o caminho: OC_MAPA-IA com underline, barras duplas (\\) e o <SeuUsuário> trocado pelo nome certo. Encerre o Claude pelo Gerenciador de Tarefas (Finalizar tarefa) e reabra com o Revit aberto. |
| Aparece "running" mas o Claude não mexe no Revit | O Revit precisa estar aberto quando o Claude inicia. Abra o Revit, espere carregar e reinicie o Claude pelo Gerenciador de Tarefas (Finalizar → abrir). |
| Não acho o menu "Desenvolvedor" no Claude | Atualize o Claude Desktop pra versão mais recente em claude.ai/download. O menu fica em Configurações. |
Não resolveu? No Revit: aba MAPA → Feedback, descreva o que aconteceu e o time da OC te ajuda.
Não resolveu?
Mande os detalhes que a gente ajuda.