Cómo construí mi propio plugin para Claude Code que genera tableros desde Power BI
En resumen — Diseñé la arquitectura de un plugin para Claude Code que, con un solo comando, se conecta a cualquier modelo de Power BI vía MCP y genera un tablero interactivo completo — al tema, al color y al estilo que tú elijas. Sin escribir HTML. El proyecto está construido sobre el modelo de Contoso y lo comparto completo en GitHub.
Nota
¿Quieres ver el resultado antes de seguir leyendo? El dashboard que generó este plugin está disponible como demo en vivo — filtra por año, cambia métricas y explora el drill-through. → Ver demo en vivo →
No necesitas saber HTML para construir un tablero
Esta frase me la repetí muchas veces antes de creerla.
Soy analista de datos. Entiendo el negocio, sé construir modelos semánticos en Power BI, sé escribir DAX. Pero si alguien me pide un prototipo de tablero en HTML puro — con gráficos interactivos, dark mode, un chatbot integrado — históricamente eso me tomaría horas que no tenía, o necesitaría a alguien más.
La IA cambió eso. Pero no de la manera genérica que probablemente estás pensando.
La idea central: un plugin como fábrica de tableros
Lo que voy a mostrar no es pedirle a la IA que “haga un dashboard”. Eso funciona una vez, de forma diferente cada vez, sin consistencia.
Lo que construí es un plugin para Claude Code — una pieza de infraestructura reutilizable que yo controlo, que sigue mis estándares de diseño, que se conecta a mis datos, y que puedo invocar con un solo comando desde cualquier proyecto.
La diferencia es la misma que hay entre pedirle a alguien que dibuje algo… y tener una imprenta propia.
Cero
Conocimiento de HTML requerido
1
Comando para generar el tablero
< 5 min
Tiempo de generación
La anatomía del plugin
Un plugin para Claude Code tiene tres partes. Cuando las entiendes, puedes construir el tuyo para cualquier propósito.
1. El comando (commands/dashboard.md)
Es el punto de entrada. Le dice a Claude qué hacer cuando escribes /dashboard.
No contiene lógica — solo instrucciones: “Lee el skill, ejecuta las fases, guarda el output aquí.”
/dashboard ventas 2025
/dashboard contoso por región Q1
/dashboard <describe lo que quieres>2. El skill (skills/dashboard-builder.md)
Aquí vive la inteligencia del plugin. Contiene:
↳ Las instrucciones exactas para consultar el modelo de datos
↳ La estructura del tablero que quieres generar
↳ Las reglas de diseño: colores, tipografía, tema
↳ El sistema de KPIs, gráficos y dimensiones
Este es el archivo que personalizas. Cambias los colores — todo el tablero cambia. Cambias las métricas — el plugin genera otra cosa. La IA simplemente sigue las instrucciones que tú escribiste.
3. La plantilla (tools/dashboard/template.html)
El scaffold visual. Claude lo lee antes de generar cualquier cosa y lo usa como referencia estructural. No lo escribes desde cero — lo defines una vez y el plugin lo reutiliza en cada tablero.
Nota
Esta es la clave de la consistencia. Todos los tableros que genere este plugin van a verse iguales en estructura porque todos parten de la misma plantilla. Es exactamente como funciona un tema en Power BI, pero aplicado al HTML.
La conexión con Power BI vía MCP
Aquí está la parte que más me interesa explorar con este proyecto.
MCP (Model Context Protocol) es el protocolo que permite a Claude Code conectarse a herramientas externas. Microsoft publicó un MCP para Power BI que expone el modelo semántico directamente: tablas, columnas, relaciones, medidas.
El flujo es el siguiente:
| Paso | Qué ocurre |
|---|---|
| MCP conectado | Claude Code “ve” el modelo de Power BI — tablas, medidas, relaciones |
| /dashboard invocado | El skill le dice a Claude qué métricas consultar |
| Consultas en paralelo | Claude extrae los datos directamente del modelo |
| Plantilla + datos | El skill construye el HTML con los valores reales del modelo |
| Output | Un archivo HTML standalone con tus datos, tu diseño |
No hay exportaciones manuales. No hay copy-paste de números. El tablero refleja el estado actual del modelo en el momento en que corres el comando.
Lo que genera el plugin sobre Contoso
El tablero resultante incluye:
- 4 tarjetas de resumen — totales de ventas, unidades, margen y cantidad de productos
- 6 KPIs interactivos con sparklines de tendencia mensual
- Gráfico de tendencia que se actualiza al hacer clic en cada KPI
- Desglose por dimensión — por categoría de producto, por región, con pestañas intercambiables
- Chatbot integrado con respuestas específicas sobre el dataset de Contoso
- Dark mode automático según la preferencia del sistema operativo
Todo en un solo archivo que funciona sin servidor, sin internet, sin instalar nada.
Cómo personalizarlo para tu caso
El punto de este proyecto no es que uses exactamente este plugin. Es que entiendas cómo construir el tuyo.
Cambios que puedes hacer sin tocar una línea de HTML:
En el skill (dashboard-builder.md):
- Cambiar el nombre del MCP a tu fuente de datos
- Cambiar los KPIs que quieres calcular
- Cambiar las dimensiones de desglose
En la plantilla (template.html):
- Cambiar la paleta de colores — 6 variables CSS, una por acento
- Cambiar la tipografía
- Cambiar el layout (1, 2 o 3 columnas de KPIs)
En el comando (dashboard.md):
- Cambiar la carpeta de output
- Cambiar el nombre del comando
Nota
La barrera hoy no es el conocimiento técnico de HTML o JavaScript. Es saber con claridad qué quieres mostrar, qué métricas importan y cómo deben verses. Eso sí requiere criterio analítico — y eso es lo que tú aportas. La IA se encarga del resto.
El proyecto en GitHub
El plugin completo está disponible en GitHub con:
✅ Estructura de carpetas lista para copiar
✅ Skill con instrucciones para el modelo de Contoso
✅ Plantilla HTML con el sistema de diseño
✅ Guía de instalación paso a paso
✅ Instrucciones para conectar tu propio modelo vía MCP
El repositorio está en construcción activa — a medida que lo refine y pruebe con más escenarios, lo iré actualizando.
🔗 Repositorio: github.com/CSalcedoDataBI/powerbi-pbip-tools
Nota
El tablero que describe este artículo está desplegado y puedes explorarlo ahora mismo. → Abrir demo en vivo →
Reflexión
Lo más valioso de este ejercicio no fue el tablero que generé.
Fue darme cuenta de que el verdadero trabajo ya no es construir el visual — es diseñar las instrucciones que hacen que la IA lo construya correctamente cada vez.
Eso requiere criterio. Requiere entender el negocio. Requiere saber qué métricas importan y cómo presentarlas.
Lo que ya no requiere es saber HTML.
¿Tienes Claude Code con el MCP de Power BI configurado? Clona el repo, ajusta el skill a tu modelo, y cuéntame qué genera tu primera versión.
¿Te resultó útil este artículo?
Tu apoyo me permite seguir creando contenido de calidad.