Cómo conectar ChatGPT con Revit usando pyRevit y MCP: guía práctica paso a paso

Cómo conectar ChatGPT con Revit usando pyRevit y MCP

Quería comprobar algo muy concreto:

¿Puedo controlar Revit desde ChatGPT, incluso desde mi teléfono y sin estar frente a la computadora donde está abierto el proyecto?

La respuesta terminó siendo sí.

Después de varias pruebas conseguí establecer una conexión entre:

Revit → pyRevit → MCP → túnel → ChatGPT

Con esta configuración puedo preguntarle a ChatGPT qué vista tengo abierta, consultar información del modelo, localizar elementos y ejecutar determinadas acciones dentro de Revit.

Y como ChatGPT también está en mi teléfono, puedo enviar instrucciones al Revit de mi computadora desde prácticamente cualquier lugar, siempre que esa computadora permanezca encendida y conectada.

En esta guía voy a explicar el procedimiento que me funcionó.

Antes de empezar: versiones utilizadas

Este punto es importante.

La configuración de esta guía fue probada con:

Autodesk Revit: 2026.2
pyRevit: 6.5.5.26237
Windows: Windows 11
Tunnel Client: v0.0.16 para Windows x64
Servidor MCP: mcp-server-for-revit-python.extension
Gestor Python: uv

Las herramientas cambian.

Por eso esta guía documenta una configuración que funcionó, no garantiza que exactamente los mismos pasos funcionen sin ajustes en versiones futuras.

¿Qué vamos a conseguir?

Al terminar deberías poder abrir ChatGPT y escribir algo parecido a:

¿Qué vista tengo abierta actualmente en Revit?

Y recibir información procedente del Revit que está abierto en tu computadora.

El flujo que construiremos será:

ChatGPT

↓

Túnel

↓

Servidor MCP

↓

pyRevit

↓

Revit API

↓

Tu modelo

No intentes modificar elementos todavía.

Primero conseguiremos que todo el puente funcione.

1. Instala Revit

En esta prueba utilicé:

Autodesk Revit 2026.2

Abre Revit y comprueba que funciona correctamente antes de instalar cualquier otra pieza.

Después cierra Revit.

2. Instala pyRevit

La versión utilizada durante esta prueba fue:

pyRevit 6.5.5.26237

Una vez instalado:

1. Abre Revit.

2. Comprueba que aparece la pestaña de pyRevit.

3. Abre cualquier proyecto.

4. Comprueba que Revit se mantiene estable.

No avances hasta que esto funcione

Si Revit falla o pyRevit no carga correctamente, todavía no tiene sentido instalar MCP.

Primero necesitas:

Revit + pyRevit funcionando correctamente.

3. Instala el servidor MCP para pyRevit

El servidor utilizado quedó instalado como una extensión de pyRevit.

La estructura utilizada fue:

C:\Users\TU_USUARIO\AppData\Roaming\pyRevit\Extensions\mcp-server-for-revit-python.extension

Dentro de esa carpeta debe existir:

main.py

En mi computadora, por ejemplo, la extensión estaba dentro de:

AppData\Roaming\pyRevit\Extensions

No copies literalmente mi nombre de usuario.

Sustituye:

TU_USUARIO

por tu usuario de Windows.

4. Comprueba pyRevit Routes

Nuestro servidor utiliza pyRevit Routes para comunicarse con Revit.

Durante nuestras pruebas Routes quedó funcionando en:

http://localhost:48884

Esto es importante porque aquí aparece el primer puente:

Servidor MCP → pyRevit → Revit

Abre Revit y mantén un proyecto abierto.

Después comprueba que Routes esté funcionando.

No avances hasta que esto funcione

Si pyRevit Routes no responde, el problema todavía no tiene nada que ver con ChatGPT.

Primero debes conseguir que:

Revit ↔ pyRevit Routes

funcione correctamente.

5. Instala uv

El servidor MCP utiliza Python y lo ejecutaremos utilizando:

uv

Después de instalarlo, abre PowerShell y comprueba:

uv --version

Si devuelve una versión, uv está disponible.

En nuestra instalación el ejecutable terminó estando en una ruta similar a:

C:\Users\TU_USUARIO\.local\bin\uv.exe

6. Prueba el servidor MCP localmente

Abre PowerShell.

Entra en la carpeta de la extensión:

cd "C:\Users\TU_USUARIO\AppData\Roaming\pyRevit\Extensions\mcp-server-for-revit-python.extension"

Ahora ejecuta:

uv run main.py

El servidor debe iniciar.

En este momento tenemos:

Servidor MCP

↓

pyRevit Routes

↓

Revit

Todavía no interviene ChatGPT.

No avances hasta que esto funcione

Si main.py no inicia correctamente, soluciona este problema antes de crear el túnel.

7. ¿Por qué necesitamos un túnel?

Aquí aparece un problema importante.

Todo lo que tenemos hasta este momento ocurre dentro de tu computadora.

Direcciones como:

localhost

o:

127.0.0.1

solo existen localmente.

ChatGPT necesita una forma de comunicarse con ese servidor MCP.

Para eso utilizamos un túnel.

El flujo cambia de:

Revit ↔ pyRevit ↔ MCP

a:

ChatGPT ↔ túnel ↔ MCP ↔ pyRevit ↔ Revit

8. Instala Tunnel Client

Durante esta prueba utilicé:

tunnel-client v0.0.16 Windows AMD64

En mi computadora el ejecutable quedó en una carpeta similar a:

D:\Downloads\tunnel-client-v0.0.16-windows-amd64\

El archivo que necesitamos es:

tunnel-client.exe

Puedes guardarlo en otra ubicación.

Lo importante es conocer su ruta.

9. Crea el túnel

Cuando creas el túnel obtendrás un identificador parecido a:

tunnel_xxxxxxxxxxxxxxxxx

No copies el mío.

Cada instalación debe utilizar su propio túnel.

Para este ejemplo utilizaremos:

TU_TUNNEL_ID

10. Crea el perfil para Revit

Primero abre PowerShell dentro de la carpeta del servidor MCP:

cd "C:\Users\TU_USUARIO\AppData\Roaming\pyRevit\Extensions\mcp-server-for-revit-python.extension"

Después ejecuta el Tunnel Client.

La estructura que utilizamos fue:

tunnel-client.exe init --sample sample_mcp_stdio_local --profile revit-pyrevit --tunnel-id TU_TUNNEL_ID --mcp-command "uv run main.py"

Este comando crea un perfil llamado:

revit-pyrevit

En nuestra instalación el archivo terminó ubicado en:

C:\Users\TU_USUARIO\AppData\Roaming\tunnel-client\revit-pyrevit.yaml

Dentro de este perfil queda definida una idea fundamental:

mcp_target_kind: stdio

y el comando:

uv run main.py

Es decir:

cuando el túnel recibe una solicitud, sabe qué servidor MCP debe ejecutar.

11. Configura la autenticación

El Tunnel Client necesita una clave para comunicarse con el servicio.

No publiques esta clave.

No la pongas en capturas de pantalla.

No la subas a GitHub.

En PowerShell puedes cargarla temporalmente como variable de entorno:

$env:CONTROL_PLANE_API_KEY = "TU_CLAVE"

Después de cerrar esa ventana de PowerShell, esa variable temporal dejará de existir.

Esto es preferible a escribir tu clave directamente dentro de una guía o script público.

12. Diagnostica el túnel antes de arrancarlo

Este paso me parece especialmente importante porque nos ahorró bastante tiempo.

Antes de iniciar la conexión ejecuta:

tunnel-client.exe doctor --profile revit-pyrevit --explain

El diagnóstico debe comprobar elementos como:

• perfil;

• Tunnel ID;

• autenticación;

• servidor MCP;

• ejecutable;

• conexión.

Lo que quieres conseguir al final es un resultado equivalente a:

RESULT ok

No avances hasta que esto funcione

Si doctor falla, no abras ChatGPT intentando descubrir qué sucede.

El problema todavía está dentro de:

Tunnel Client / configuración / servidor MCP.

Corrígelo primero.

13. Arranca el túnel

Cuando el diagnóstico sea correcto, ejecuta:

tunnel-client.exe run --profile revit-pyrevit

En mi caso utilizaba la ruta completa:

& 'D:\Downloads\tunnel-client-v0.0.16-windows-amd64\tunnel-client.exe' run --profile revit-pyrevit

Deja esa ventana de PowerShell abierta.

Si la cierras:

el túnel se detiene.

Y ChatGPT dejará de tener acceso a Revit.

14. Comprueba el estado del Tunnel Client

En nuestra instalación el cliente exponía además un panel local en:

http://127.0.0.1:8080/ui

y su comprobación de salud estaba vinculada a:

http://127.0.0.1:8080

Esto resulta útil para comprobar que el Tunnel Client realmente está ejecutándose.

15. Conecta el túnel con ChatGPT

Ahora ChatGPT debe tener configurada la integración MCP correspondiente al túnel que acabas de crear.

En nuestra prueba la integración se llamó:

Revit pyRevit

con una descripción similar a:

Conexión con Revit mediante el servidor MCP local de pyRevit para consultar y modificar modelos.

Una vez asociada correctamente, ChatGPT podrá descubrir las herramientas proporcionadas por el servidor MCP.

16. La primera prueba

No empieces diciendo:

Modifica todos mis muros.

Empieza con algo inocuo.

Por ejemplo:

Consulta la vista activa de Revit. No modifiques nada.

Cuando nosotros terminamos la conexión, ChatGPT consiguió identificar correctamente la vista que estaba abierta en Revit.

Ese fue el momento en que supimos que toda la cadena funcionaba.

Porque la información había recorrido:

Revit

↓

pyRevit

↓

servidor MCP

↓

túnel

↓

ChatGPT

y había regresado con una respuesta.

17. Segunda prueba: consulta elementos

Después puedes probar algo como:

Consulta los elementos visibles en la vista activa. No modifiques nada.

O:

¿Qué worksets existen en el proyecto?

O:

Busca los conduits visibles en esta vista.

Todavía estamos en modo consulta.

Esto es intencional.

18. Tercera prueba: selecciona elementos

Después podemos avanzar un paso.

Por ejemplo:

Encuentra los elementos que cumplen esta condición y selecciónalos en Revit. No los modifiques.

Esta prueba ya demuestra algo mucho más interesante.

ChatGPT no solo puede consultar información.

También puede enviar una acción de regreso a Revit.

19. Primera modificación controlada

Solo después de comprobar todo lo anterior recomiendo intentar una modificación.

La metodología que estoy utilizando es:

CONSULTAR

↓

IDENTIFICAR

↓

SELECCIONAR

↓

REVISAR

↓

MODIFICAR

Por ejemplo:

Encuentra los elementos con esta condición.

Después:

Selecciónalos.

Comprueba el resultado en Revit.

Y únicamente después:

Modifica solamente esos elementos.

Este flujo reduce mucho las posibilidades de realizar cambios incorrectos.

20. Controlar Revit desde el celular

Aquí aparece una de las consecuencias más interesantes de todo el sistema.

Una vez establecido el túnel, el dispositivo desde el que utilizo ChatGPT ya no tiene que ser la computadora donde está instalado Revit.

Puedo abrir ChatGPT en mi teléfono y escribir:

¿Qué vista tengo abierta actualmente en Revit?

La solicitud viaja así:

Teléfono

↓

ChatGPT

↓

Internet

↓

Túnel

↓

Servidor MCP

↓

pyRevit

↓

Revit

Y la respuesta vuelve hasta el teléfono.

También puedo enviar acciones.

Por ejemplo:

Busca determinados elementos y selecciónalos.

Esto significa que puedo controlar Revit desde mi celular utilizando ChatGPT, aunque técnicamente Revit continúa ejecutándose en mi computadora.

¿Puedo controlar Revit desde cualquier lugar?

Sí, con una condición importante.

La computadora donde está instalado Revit debe permanecer:

• encendida;

• conectada a Internet;

• con Revit abierto;

• con pyRevit funcionando;

• con el túnel activo.

Cumpliendo esas condiciones, puedes utilizar ChatGPT desde otro dispositivo para enviar instrucciones.

No estamos instalando Revit en un teléfono.

Estamos utilizando el teléfono como interfaz remota en lenguaje natural.

21. Cómo arrancar todo después de reiniciar Windows

Este punto es fácil de olvidar.

Después de reiniciar la computadora necesitas levantar nuevamente el sistema.

El orden que utilizo es:

1. Abre Revit.

2. Abre el proyecto.

3. Comprueba que pyRevit esté cargado.

4. Carga tu API key en PowerShell:

$env:CONTROL_PLANE_API_KEY = "TU_CLAVE"

5. Inicia el túnel:

tunnel-client.exe run --profile revit-pyrevit

6. Deja PowerShell abierto.

7. Abre ChatGPT.

8. Prueba:

¿Qué vista tengo abierta en Revit?

Si responde correctamente:

el puente está funcionando.

Solución de problemas

En lugar de cambiar diez cosas a la vez, comprueba el sistema por capas.

Revit no abre correctamente

Detente.

Todavía no revises MCP.

Comprueba:

Revit → pyRevit

pyRevit funciona pero Routes no responde

El problema está entre:

pyRevit → Routes

Todavía no tiene sentido revisar ChatGPT.

Routes funciona pero el MCP no inicia

Comprueba:

uv run main.py

El problema está en:

servidor MCP → pyRevit

MCP funciona pero el túnel falla

Ejecuta:

tunnel-client.exe doctor --profile revit-pyrevit --explain

Comprueba perfil, credenciales y Tunnel ID.

Tunnel Client funciona pero ChatGPT no ve Revit

Entonces el problema probablemente está en:

ChatGPT → túnel

Comprueba que ChatGPT esté utilizando la integración correspondiente al túnel actual.

ChatGPT responde pero las operaciones tardan demasiado

Aquí encontramos una lección importante.

No conviene pedir demasiadas operaciones de Revit en una sola solicitud.

En lugar de:

Revisa todo el proyecto, corrige todas las instalaciones y documenta todos los planos.

Haz:

Consulta los conduits visibles.

Después:

Clasifícalos.

Después:

Selecciona estos.

Después:

Modifícalos.

Las operaciones pequeñas son más fáciles de comprobar y suelen ser mucho más estables.

No publiques estos datos

Si haces tu propia conexión, evita compartir públicamente:

• API keys;

• tokens;

• contraseñas;

• credenciales;

• archivos .yaml completos que contengan datos sensibles;

• información privada del túnel;

• configuraciones que incluyan secretos.

En una guía sustituye esos valores por:

TU_CLAVE

TU_TUNNEL_ID

TU_USUARIO

El resultado final

Después de completar estos pasos tenemos:

Revit 2026.2

↓

pyRevit 6.5.5.26237

↓

pyRevit Routes

↓

Servidor MCP

↓

Tunnel Client

↓

ChatGPT

↓

computadora o teléfono

Y podemos comenzar a utilizar lenguaje natural para interactuar con información de un modelo BIM.

¿Esto sustituye Dynamo o Python?

No.

Dynamo, Python, pyRevit y la API de Revit siguen siendo herramientas mucho más precisas para automatizaciones definidas.

Lo diferente aquí es la interfaz.

En lugar de conocer previamente exactamente qué script ejecutar, podemos comenzar diciendo:

Encuentra estos elementos.

Revísalos.

Selecciónalos.

Modifica únicamente estos.

ChatGPT se convierte en una capa en lenguaje natural sobre herramientas que realmente ejecutan operaciones mediante la API de Revit.

Preguntas frecuentes

¿Se puede conectar ChatGPT con Revit?

Sí. Esta guía documenta una conexión funcional utilizando pyRevit, MCP y un túnel entre ChatGPT y una computadora donde Revit está ejecutándose.

¿Se puede conectar ChatGPT con Revit mediante pyRevit?

Sí. pyRevit puede servir como una de las capas que permiten acceder a la API de Revit desde herramientas externas.

¿Se puede controlar Revit desde el celular?

Sí.

Revit continúa ejecutándose en la computadora, pero ChatGPT puede utilizarse desde el teléfono como interfaz remota para enviar instrucciones.

¿Puedo utilizar Revit desde el teléfono?

No estás instalando Revit en el teléfono.

Estás utilizando ChatGPT para comunicarse con una computadora donde Revit está abierto.

¿Puedo controlar Revit remotamente?

Sí, mientras la computadora permanezca encendida, conectada y mantenga activo el puente MCP.

¿ChatGPT puede modificar un proyecto de Revit?

Sí, si el servidor MCP proporciona herramientas que permitan ejecutar esas modificaciones.

Recomiendo primero consultar, después seleccionar y finalmente modificar.

¿Qué versión de Revit utilizaste?

Esta configuración fue probada con:

Autodesk Revit 2026.2

¿Qué versión de pyRevit utilizaste?

La configuración documentada utilizó:

pyRevit 6.5.5.26237

¿Necesito saber programar?

No necesariamente para replicar una configuración existente.

Pero conocimientos de Python, pyRevit y Revit API son muy útiles si quieres ampliar las herramientas disponibles.

Arquitectura + BIM + Inteligencia Artificial

Esta conexión empezó como un experimento.

Después de conseguir que funcionara, la pregunta dejó de ser:

¿puedo conectar ChatGPT con Revit?

Ahora sabemos que sí.

Incluso puedo enviar instrucciones desde mi teléfono al Revit que está abierto en mi computadora.

La pregunta realmente interesante ahora es:

¿qué partes del trabajo cotidiano de arquitectura y BIM podemos mejorar utilizando esta conexión?

Eso es lo que seguiré documentando en este blog.

Alhan Michel Arquitectura
www.AlhanMichelArquitectura.com