Introducción
En muchos sitios presentan conectar IA con Revit como un proceso largo, caro o «solo posible con Claude». No es así. Este lab demuestra que, con herramientas gratuitas —Python, pyRevit, Cursor (plan Hobby o prueba) y modelos de IA gratuitos o locales— y Revit en periodo de prueba si aún no tienes licencia, puedes hablar con tu modelo en pocos minutos.
Utilizando el protocolo MCP (Model Context Protocol), pyRevit y Cursor, combinas esas piezas para conversar con el modelo, auditar parámetros, automatizar el modelado y crear scripts al vuelo sin salir del chat. No hace falta ser experto: con conocimientos básicos y esta guía paso a paso basta.
Si ya tienes los requisitos instalados (Python, Revit 2027 y Cursor), la guía paso a paso suele llevar unos 20 minutos hasta el primer prompt. Si aún faltan herramientas, reserva tiempo extra para las descargas e instalaciones.
Esta guía te lleva desde la instalación hasta el primer prompt de IA interactuando en tiempo real con Revit. Cada paso explica qué hacer y por qué.
Necesitas Python 3.12 global en Windows: el protocolo MCP lo usa como servidor intermediario. Este tutorial se ha desarrollado con la versión 3.12.7.
- Descarga el instalador desde python.org/downloads (elige la serie 3.12).
- En el asistente, marca Add python.exe to PATH antes de instalar.
- Cierra y vuelve a abrir la terminal (CMD o PowerShell) y comprueba:
python --versionDeberías ver algo como Python 3.12.x. Si no reconoce el comando, prueba py --version.
- Instala las librerías base:
pip install mcp httpxSolo funciona con Revit 2027 en Windows. Revit no tiene versión nativa para Mac (haría falta una máquina virtual con Windows, fuera del alcance de esta guía). Si no tienes licencia de pago, el periodo de prueba de Autodesk basta para seguir todo el tutorial.
- Confirma que tienes instalado Revit 2027 (no 2025 ni 2026).
- Trabaja en un PC con Windows y una licencia o trial válida.
- Abre un proyecto o familia — no dejes Revit en la pantalla de inicio ("Home").
- Mantén ese documento abierto mientras sigues la guía: el servidor MCP lo necesita activo.
Necesitas el editor Cursor. Cursor ya no es «gratis sin límites» como en sus inicios, pero este tutorial se puede seguir sin pagar.
- Descárgalo desde cursor.com/download e instálalo en Windows.
- Crea una cuenta (Hobby no pide tarjeta).
- En el paso 5 lo conectarás a Revit mediante MCP.
Planes y coste
- Hobby (gratis): Agent y Tab con cupos mensuales bajos. Suficiente para probar y completar esta guía con uso puntual; se agota si lo usas todo el día.
- Prueba Pro: al crear una cuenta nueva suelen dar 7–14 días de funciones Pro.
- Pro ($20/mes): alternativa sólida para uso diario — Tab ilimitado, Auto Mode generoso (Cursor elige el modelo) y ~$20/mes de créditos para modelos frontier (Claude, GPT, etc.).
- Sin suscripción Pro: API propia (BYOK) de OpenAI, Anthropic, DeepSeek u OpenRouter — pagas solo el consumo a tarifa de API — o un modelo local con Ollama / LM Studio (gratis e ilimitado; el rendimiento depende de tu PC/GPU).
En Pro, el Auto Mode no quema la bolsa de créditos al ritmo de los modelos frontier elegidos a mano: esos créditos se consumen cuando seleccionas un modelo concreto o activas Max Mode. Detalle oficial: cursor.com/pricing.
Para esta guía basta Hobby o la prueba Pro. Si te quedas sin cuota a mitad de mes, cambia a Auto Mode, espera el reinicio del ciclo, o usa BYOK / Ollama.
Descarga el instalador de pyRevit desde su repositorio oficial en GitHub: github.com/pyrevitlabs/pyRevit. Entra en la sección Lanzamientos (Releases), abre la última versión y descarga el instalador Admin / All Users.
Al abrir Revit por primera vez tras la instalación, asegúrate de indicarle que siempre cargue este complemento.
Usa el instalador "Admin / All Users" para evitar problemas de permisos.
Ve a la pestaña pyRevit → Settings.
- En el panel izquierdo, busca Routes.
- Activa el interruptor Routes Server (Beta).
- Marca la casilla pyrevit-core/.
- Haz clic en Save Settings and Reload para aplicar los cambios.
Tu panel debería quedar similar a esto:
Ve a la pestaña pyRevit → Extensions.
Busca e instala la extensión llamada mcp-server-for-revit-python. Una vez instalada, comprueba que su estado sea Enabled y recarga Revit o pyRevit de nuevo.
¡Crítico! Abre un proyecto o una familia en Revit. El servidor no funcionará si estás en la pantalla de inicio ("Home").
Abre tu navegador y visita:
http://localhost:48884/revit_mcp/status/Si todo está correcto deberías ver una respuesta JSON como esta:
{
"revit_available": true,
"health": "healthy",
"api_name": "revit_mcp",
"status": "active"
}Si aún no tienes Cursor, descárgalo desde cursor.com/download. Dentro de Cursor, abre Settings → Tools & MCPs y haz clic en + New MCP Server.
Configúralo como "command" con el siguiente JSON (cambia tu_usuario por tu usuario real de Windows):
{
"mcp-server-for-revit-python": {
"command": "python",
"args": [
"C:\\Users\\tu_usuario\\AppData\\Roaming\\pyRevit\\Extensions\\mcp-server-for-revit-python.extension\\main.py"
]
}
}La ruta de args es la de instalación por defecto de la extensión. Si instalaste el plugin en otra carpeta, apunta args a ese main.py. En Windows usa dobles barras invertidas (\\) en la ruta del JSON; si no, Cursor no encontrará el archivo.
Verifica que aparezca el punto verde junto al nombre del servidor: indica que Cursor ha hecho el "handshake" correctamente con pyRevit.
Abre el chat de Cursor en modo Agent con el modelo Auto y envía este prompt para comprobar la conexión:
Prompt de ejemplo"Consulta el estado de Revit 2027 y dime el nombre del documento activo y el nombre de la vista activa."
Verás cómo Cursor invoca automáticamente la herramienta get_revit_status, extrae la información de tu modelo y te la redacta en lenguaje natural. Auto basta para esta prueba; también puedes elegir modelos de pago más potentes o modelos gratis locales con Ollama / LM Studio, como se indica en Requisitos previos.
En Cursor, usa el modo Pregunta (Ask) para consultas sobre el modelo sin modificar nada, y el modo Agente (Agent) cuando quieras aplicar cambios o modificaciones al modelo.
Casos de uso y tools
El servidor MCP expone alrededor de 20 herramientas que la IA de Cursor puede usar de forma autónoma según lo que le pidas.
Los prompts de esta sección son ilustrativos: sirven de ejemplo y punto de partida. El resultado depende del modelo de IA que uses y del contenido del modelo Revit (.rvt / .rfa) en el que estés trabajando; adáptalos, explora variaciones y prueba qué funciona en tu propio entorno.
Extrae información valiosa sin crear tablas de planificación temporales.
Prompt de ejemplo"Enumera todos los muros visibles en la vista actual, agrúpalos por tipo de familia y dime el valor del parámetro 'Volumen' total de cada grupo."
get_current_view_elementslist_category_parametersget_revit_model_info
Delega la colocación repetitiva de elementos o la estructuración del proyecto.
Prompt de ejemplo"Busca la familia 'Mesa de Reuniones' en el modelo y coloca una en el Nivel 1, exactamente en las coordenadas X:10, Y:5, Z:0."
place_familylist_levelslist_families
Aplica overrides de color al instante para resaltar errores o clasificar elementos.
Prompt de ejemplo"Pinta de color rojo brillante todos los elementos de la categoría 'Puertas' en esta vista para poder ubicarlos rápidamente. Cuando termine de revisarlo, límpialos."
color_splashclear_colorslist_revit_views
Si no existe una herramienta predefinida, Cursor puede escribir y ejecutar un script de la API de Revit al vuelo.
Prompt de ejemplo"Escribe y ejecuta un script de Python en Revit que seleccione todos los muros del proyecto y copie el texto del parámetro 'Marca de Tipo' hacia el parámetro 'Comentarios'."
execute_revit_code