Cómo usar el MCP de Power BI con Claude paso a paso
Integra Claude Desktop con tus modelos semánticos de Power BI mediante Model Context Protocol (MCP) para auditar medidas DAX, documentar tablas y refactorizar relaciones sin copiar y pegar metadatos manualmente.
Conectar Claude Desktop con el servidor MCP oficial de Power BI para inspeccionar el modelo semántico, documentar medidas DAX y aplicar refactorizaciones controladas.
- Comprender la arquitectura cliente-servidor de MCP y qué servidores oficiales ofrece Microsoft para Power BI.
- Comparar los modos de operación en solo lectura frente a edición y modelado directo.
- Configurar el archivo claude_desktop_config.json con la estructura mcpServers y validar la conexión.
- Ejecutar cinco prompts prácticos para documentar modelos, revisar DAX y detectar riesgos de permisos.
Progreso: 0 / 6 pasos
0%Ruta paso a paso
6 pasos- 01
Arquitectura MCP
Entiende cliente, servidor y opciones oficiales de Power BI.
- 02
Requisitos y modos
Compara solo lectura frente a modelado y edición.
- 03
Configurar Claude
Edita claude_desktop_config.json y verifica herramientas.
- 04
Casos de uso DAX
Documenta el modelo, crea medidas y audita rendimiento.
- 05
Seguridad y riesgos
Controla metadatos expuestos y escrituras en el modelo.
- 06
Limitaciones reales
Conoce qué no resuelve MCP y cómo mitigar fallos.
Lo que necesitas
PrerrequisitosVersión recomendada: Power BI Desktop actualizado en Windows y Claude Desktop vigente
- Power BI Desktop abierto con un archivo .pbix o proyecto PBIP/TMDL local de prueba.
- Claude Desktop instalado con sesión activa en una cuenta autorizada para herramientas locales.
- Binarios oficiales del servidor MCP de Power BI descargados siguiendo la documentación de Microsoft Learn.
- Copia de respaldo del archivo .pbix o repositorio Git antes de habilitar operaciones de escritura.
Mac y Web: Power BI Desktop y el servidor local de modelado requieren Windows para conectarse a instancias locales en ejecución. La configuración de claude_desktop_config.json en Claude Desktop sigue el estándar de Anthropic en Windows (%APPDATA%\Claude\claude_desktop_config.json), mientras que los endpoints remotos alojados por Microsoft apuntan a modelos publicados en Fabric/Power BI Service.
1. Qué es MCP y qué opciones existen para Power BI
Hasta hace poco, pedirle ayuda a un modelo de lenguaje para depurar un informe de Power BI implicaba copiar manualmente fórmulas DAX, tomar pantallazos de la vista de relaciones o exportar el esquema con herramientas externas. Ese flujo manual rompe el contexto cada vez que agregas una columna calculada o cambias la cardinalidad de una relación.
El Model Context Protocol (MCP), publicado por Anthropic como estándar abierto según modelcontextprotocol.io (consultado el 21 de noviembre de 2026), resuelve exactamente esa fricción. Define una interfaz común entre un cliente de IA (como Claude Desktop) y un servidor local o remoto que expone herramientas, recursos y esquemas estructurados.
En esta arquitectura, Claude no adivina tus tablas ni accede mágicamente a tu disco duro sin control: el cliente envía solicitudes tipadas al servidor MCP, y el servidor ejecuta acciones acotadas contra tu instancia local o tu espacio de trabajo, devolviendo metadatos o confirmaciones al chat.
Para Power BI, según la documentación oficial de Microsoft Learn (Power BI MCP server documentation, consultado el 21 de noviembre de 2026), existen dos grandes familias de servidores según el objetivo del usuario: el servidor orientado a modelado y autoría (Power BI Authoring MCP server, conocido también en flujos de desarrollo como Power BI Modeling MCP) y servidores orientados a consumo y preguntas de negocio sobre datos gobernados (como Fabric IQ).
El servidor de autoría y modelado permite a un agente inspeccionar y modificar tablas, columnas, medidas, relaciones, grupos de cálculo, perspectivas y roles de seguridad, además de validar consultas DAX y trabajar sobre archivos Power BI Project (PBIP) y TMDL. Por su parte, la modalidad local sobre stdio (disponible de forma general según Microsoft Learn, consultado el 21 de noviembre de 2026) se conecta directo a tu Power BI Desktop abierto, mientras que la modalidad alojada en la nube (en vista previa) apunta a modelos en workspaces de Fabric.
Como los nombres de binarios, banderas de arranque y canales de distribución evolucionan rápido, conviene revisar siempre la guía oficial de Power BI Authoring MCP server en Microsoft Learn para obtener el comando exacto vigente al 21 de noviembre de 2026 antes de automatizar instalaciones en equipos corporativos.
- Cliente MCP (Claude Desktop): gestiona la conversación, decide qué herramienta invocar y te pide aprobación antes de ejecutar acciones sensibles.
- Transporte stdio local: canal estándar de entrada y salida donde Claude Desktop levanta el proceso del servidor en tu mismo equipo Windows.
- Servidor Power BI Authoring / Modeling MCP: traduce las llamadas del protocolo a operaciones sobre el modelo tabular local o archivos PBIP/TMDL.
2. Requisitos previos y modos: solo lectura vs edición y modelado
Antes de escribir una sola línea de JSON, decide qué nivel de autonomía vas a darle a Claude sobre tu archivo de Power BI. No es lo mismo usar un asistente para documentar un modelo productivo complejo que permitirle crear medidas, renombrar columnas en masa o alterar relaciones en un archivo que todavía no respaldas.
Según la documentación oficial de Microsoft Learn sobre integración agéntica en Power BI (consultado el 21 de noviembre de 2026), el servidor de modelado abarca desde lectura del esquema y ejecución de consultas DAX de validación hasta refactorización completa de objetos del modelo semántico. En la práctica diaria, conviene separar mentalmente dos modos de trabajo: auditoría en solo lectura (o con aprobaciones estrictas) y modelado activo sobre una copia de desarrollo.
Si recién estás probando la integración en tu empresa, parte siempre con un archivo PBIX de laboratorio o una rama Git dedicada usando formato PBIP. Así evitas que un prompt ambiguo renombre treinta medidas con un prefijo no deseado o cambie la dirección de filtro cruzado sin revisión previa.
| Criterio | Modo auditoría y solo lectura | Modo edición y modelado directo |
|---|---|---|
| Objetivo principal | Documentar tablas, revisar DAX lento y entender relaciones heredadas. | Crear medidas, refactorizar nombres, ajustar formatos y grupos de cálculo. |
| Riesgo sobre el .pbix | Muy bajo: no modifica definiciones del modelo tabular. | Alto si no hay respaldo: altera medidas, relaciones y metadatos en vivo. |
| Aprobación en Claude | Aprobar únicamente herramientas de lectura de esquema y metadatos. | Revisar cada llamada de escritura antes de pulsar Permitir en el chat. |
| Entorno recomendado | Copia local del modelo o entorno de QA. | Archivo de prueba o proyecto PBIP versionado con Git. |
| Control de cambios | No requiere rollback porque el modelo permanece intacto. | Obligatorio respaldo previo del .pbix o commit limpio antes de iniciar. |
3. Instalación y configuración en Claude Desktop
Según la guía oficial de Model Context Protocol para Claude Desktop en modelcontextprotocol.io (consultado el 21 de noviembre de 2026), los servidores locales se declaran en un archivo JSON llamado claude_desktop_config.json. En Windows, este archivo vive en la ruta %APPDATA%\Claude\claude_desktop_config.json, y puedes abrirlo directamente desde el menú de Claude Desktop entrando a Settings > Developer > Edit Config.
En ese archivo debes definir el objeto raíz mcpServers, asignando un identificador claro (por ejemplo, powerbi-modeling) junto a las claves command y args. Es fundamental que la ruta del ejecutable oficial coincida exactamente con la ubicación donde instalaste el servidor MCP de Power BI desde la guía oficial de Microsoft Learn, escapando correctamente las barras invertidas en formato JSON.
Un error clásico en Windows es usar barras simples sin escapar o dejar comas sobrantes al final del último atributo del objeto JSON. Si el archivo tiene un error de sintaxis, Claude Desktop ignorará el servidor o mostrará una alerta de configuración al iniciar.
Después de guardar el archivo, cierra completamente Claude Desktop desde la bandeja del sistema (no basta con cerrar la ventana con la X) y vuelve a abrirlo. Al reiniciar, deberías ver el ícono de herramientas disponibles en la barra del chat indicando que el servidor MCP quedó registrado.
{ "mcpServers": { "powerbi-modeling": { "command": "C:\\RUTA\\AL\\SERVIDOR\\PowerBIModelingMCP.exe", "args": [] } }}Reemplaza C:\\RUTA\\AL\\SERVIDOR\\PowerBIModelingMCP.exe por la ruta exacta del ejecutable oficial instalado según Microsoft Learn (consultado el 21-nov-2026). Usa doble barra invertida en JSON.
Conéctate al modelo de Power BI abierto actualmente mediante el servidor MCP.
No modifiques ningún objeto todavía.
Devuelve únicamente:
1. Nombre de las tablas de hechos y dimensiones detectadas.
2. Cantidad total de medidas y relaciones activas/inactivas.
3. Si existe alguna tabla sin relaciones.Usa este primer prompt de solo lectura para confirmar que Claude lee el esquema real de tu Power BI Desktop.
4. Casos de uso prácticos: documentar el modelo, crear medidas y revisar DAX
Una vez establecida la conexión, el verdadero salto de productividad no está en pedirle gráficos a Claude, sino en delegarle tareas tediosas de ingeniería del modelo semántico. En proyectos corporativos chilenos es común heredar archivos .pbix con decenas de medidas sin descripción, nombres inconsistentes y cálculos con FILTER sobre tablas completas que degradan el rendimiento.
El primer caso de uso de alto retorno es la documentación automática del modelo. Claude puede leer las expresiones DAX de todas tus medidas, entender sus dependencias y redactar descripciones funcionales claras en español para que luego las incorpores en la propiedad Description de cada medida o en un diccionario Markdown para el equipo de negocio.
El segundo caso de uso es la auditoría y refactorización de medidas DAX. Al tener acceso al esquema completo (incluyendo cardinalidades y tipos de datos), Claude detecta errores frecuentes como divisiones sin DIVIDE, uso innecesario de CALCULATE sin cambio de contexto de filtro, o filtros de tabla entera dentro de iteradores.
El tercer caso de uso es la creación controlada de nuevas medidas (por ejemplo, variaciones interanuales o acumulados YTD) indicando explícitamente en qué tabla de medidas deben quedar alojadas, qué formato numérico usar y qué pruebas DAX ejecutar para validar que el resultado no devuelva valores en blanco inesperados.
Inspecciona el modelo semántico conectado sin realizar cambios.
Genera una tabla en Markdown con todas las medidas de la tabla "_Medidas" que incluya:
- Nombre de la medida
- Carpeta de visualización (si tiene)
- Fórmula DAX resumida
- Descripción funcional en lenguaje de negocio (máximo 20 palabras)
- Dependencias principales (tablas o medidas base que utiliza)Revisa todas las medidas del modelo conectado y busca antipatrones DAX:
1. Uso de operador "/" en lugar de DIVIDE().
2. Uso de FILTER(Tabla, ...) en lugar de filtros booleanos simples dentro de CALCULATE().
3. Columnas calculadas que podrían reemplazarse por medidas.
No apliques cambios todavía. Lista cada hallazgo con: nombre de medida, problema detectado, impacto y propuesta de código corregido.En la tabla "_Medidas" del modelo conectado, crea dos medidas nuevas:
1. "Venta Neta YTD": acumulado anual de [Venta Neta] usando la columna 'Dim_Calendario'[Fecha]. Formato moneda sin decimales ($#,##0).
2. "Variación YoY %": variación porcentual de [Venta Neta] respecto al mismo período del año anterior usando SAMEPERIODLASTYEAR('Dim_Calendario'[Fecha]), protegida con DIVIDE(). Formato 0,0%.
Después de crearlas, ejecuta una consulta DAX de validación por año para comprobar que ambas devuelven valores coherentes.5. Seguridad, permisos y riesgos de escritura directa
Conectar un asistente agéntico a Power BI introduce riesgos operacionales distintos a los de un chat tradicional. Cuando trabajas con MCP, el servidor envía al cliente los nombres de tablas, columnas, medidas DAX, expresiones de seguridad a nivel de fila (RLS) y, si ejecutas consultas de validación, muestras agregadas o filas de resultados.
Por eso es obligatorio revisar las políticas de privacidad y retención de datos de tu plan de Claude (según support.claude.com, consultado el 21 de noviembre de 2026, los planes comerciales y empresariales tienen tratamientos distintos respecto al entrenamiento frente a cuentas personales gratuitas). Nunca conectes modelos que contengan datos confidenciales de remuneraciones, RUT de clientes o información financiera reservada desde una cuenta personal no autorizada.
El segundo frente de riesgo es la escritura directa sobre el modelo tabular. En Claude Desktop, cada vez que una herramienta MCP intenta modificar el modelo, el cliente solicita confirmación manual. El error humano más común es aprobar en automático sin leer qué parámetros está pasando el agente.
- No apruebes llamadas de escritura en masa sin haber guardado una copia del archivo .pbix o un commit limpio en Git.
- Evita exponer tablas con datos personales en consultas DAX de prueba: pide agregaciones por categoría o año en lugar de TOPN de registros individuales.
- Desactiva o comenta el servidor MCP en claude_desktop_config.json cuando trabajes con archivos confidenciales que no deben interactuar con IA.
Antes de ejecutar cualquier herramienta de escritura en el modelo:
1. Enumera exactamente qué objetos (tablas, columnas, medidas o relaciones) vas a crear, modificar o eliminar.
2. Indica si alguna visual existente del informe podría romperse por cambios de nombre.
3. Espera mi confirmación explícita en el siguiente mensaje antes de invocar la herramienta de modificación.6. Limitaciones actuales que debes tener en cuenta
Aunque la integración vía MCP acelera enormemente la documentación y el modelado tabular, no reemplaza el criterio de arquitectura ni cubre todo el ciclo de vida de Power BI. Conocer sus límites evita frustraciones en entregas con plazos ajustados.
En primer lugar, el servidor de autoría y modelado trabaja sobre el modelo semántico (tablas, relaciones, DAX, TMDL), no sobre el diseño visual completo de las páginas del informe como posicionamiento milimétrico de tarjetas, paletas de tema o interacciones visuales complejas.
En segundo lugar, las ventanas de contexto de los modelos de lenguaje tienen un límite práctico. En modelos corporativos gigantes con cientos de tablas y miles de medidas, pedirle a Claude que analice todo de una sola vez puede saturar la conversación o generar respuestas incompletas; conviene trabajar por carpetas de medidas o áreas funcionales.
Finalmente, la conectividad local depende de Windows y de que Power BI Desktop esté ejecutándose con el modelo cargado en memoria (o apuntando a archivos PBIP locales). Si trabajas en macOS, no podrás levantar Power BI Desktop de forma nativa para usar el flujo local.
Errores comunes y cómo resolverlos
Diagnóstico rápidoClaude Desktop no muestra el servidor MCP después de editar el JSON
Causa
Error de sintaxis en claude_desktop_config.json (comas finales, barras invertidas sin duplicar) o no haber cerrado completamente Claude desde la bandeja del sistema.
Cómo resolverlo
Valida el JSON en un editor como VS Code, asegúrate de usar \\ en rutas de Windows y cierra Claude Desktop completamente desde el Administrador de tareas o la bandeja antes de reabrirlo.
El servidor arranca pero no detecta el archivo .pbix abierto
Causa
Power BI Desktop no estaba abierto al momento de consultar, o existen múltiples ventanas de Power BI Desktop abiertas y el agente no sabe a cuál conectarse.
Cómo resolverlo
Deja abierta una sola instancia de Power BI Desktop con el modelo objetivo cargado antes de pedirle a Claude que inspeccione el esquema.
Medidas creadas por Claude devuelven error de sintaxis o valores en blanco
Causa
El modelo de IA asumió nombres de columnas o relaciones que no existen, o usó una función de inteligencia de tiempo sin una tabla de fechas marcada correctamente.
Cómo resolverlo
Pídele primero a Claude que liste las tablas y relaciones reales del modelo y ejecuta siempre una consulta DAX de validación tras crear cada medida.
El chat se vuelve lento o pierde foco en modelos muy grandes
Causa
Intentar volcar cientos de tablas y medidas completas en un único turno de conversación.
Cómo resolverlo
Acota tus prompts por tabla de hechos o carpeta de medidas, y abre conversaciones nuevas para cada módulo funcional del modelo.
Checklist de auditoría y configuración MCP para Power BI
Próximamente: plantilla descargable con el archivo base claude_desktop_config.json comentado y lista de verificación de seguridad para equipos de BI.
Preguntas frecuentes
¿Necesito pagar una suscripción para usar MCP con Claude Desktop y Power BI?
Claude Desktop permite configurar servidores MCP locales en su aplicación de escritorio; sin embargo, los límites de uso, acceso a modelos avanzados y políticas de privacidad empresarial dependen del plan vigente de Claude que utilices (según support.claude.com, consultado el 21 de noviembre de 2026).
¿El servidor MCP de Power BI es oficial de Microsoft?
Sí. Microsoft documenta oficialmente en Microsoft Learn el Power BI Authoring MCP server (también referido como Power BI Modeling MCP) para tareas de modelado y autoría, además de opciones orientadas a consumo de datos gobernados.
¿Puede Claude ver las filas de mis tablas de clientes o sueldos?
Por defecto las herramientas de modelado inspeccionan metadatos (tablas, columnas, medidas y relaciones). Sin embargo, si el servidor dispone de herramientas para ejecutar consultas DAX y tú o el agente las invocan, los resultados devueltos por la consulta sí entran en el contexto de la conversación. Evita consultar datos sensibles.
¿Funciona en Mac usando Power BI en la nube?
Power BI Desktop y el flujo local conectado a instancias de Desktop requieren Windows. Para trabajar desde modelos publicados en Fabric/Power BI Service, Microsoft ofrece una modalidad de endpoint alojado en vista previa documentada en Microsoft Learn.
¿Qué pasa si Claude modifica una medida o relación y rompe mi informe?
Si no guardaste el archivo .pbix aún, puedes cerrar sin guardar o deshacer según corresponda; pero la práctica segura es mantener siempre una copia de respaldo previa o trabajar sobre un proyecto PBIP controlado con Git.
Fuentes oficiales y recursos
- Power BI MCP server documentation(Microsoft Learn)
- Power BI Authoring MCP server guide(Microsoft Learn)
- Model Context Protocol — Connect to local MCP servers(Model Context Protocol)
- Centro de ayuda de Claude(Anthropic Support)
- Cómo usar Claude para análisis de datosAprende a estructurar prompts analíticos y proteger datos sensibles en Claude.
- Claude vs ChatGPT para análisis de datosComparativa práctica para elegir la mejor IA en tareas de BI, código y SQL.
- Curso de Claude aplicado a datos y productividadDomina flujos avanzados con Claude, Projects, artefactos y MCP.
Progreso: 0 / 6 pasos
0%