servidor MCP de consumo de Power BI (versión preliminar)

El servidor MCP de consumo de Power BI es un punto de conexión alojado de forma remota donde los agentes de IA interactúan con datos en modelos semánticos de Power BI mediante el uso de lenguaje natural. Basado en el Protocolo de contexto de modelo (MCP), traduce las solicitudes en operaciones de Power BI, generando consultas DAX y ejecutándolas al tiempo que respeta los permisos y las directivas de seguridad.

Para crear o cambiar modelos semánticos en lugar de consultarlos, consulte servidor MCP de creación de Power BI.

En este artículo aprenderá a:

  • Conexión al servidor remoto de MCP de Power BI en Visual Studio Code
  • Conexión de GitHub Copilot a los modelos semánticos de Power BI
  • Validación de la conexión con consultas de prueba

Important

Para el consumo de modelos semánticos, se recomienda usar el servidor MCP de Fabric IQ. Fabric IQ es el servidor MCP principal para llevar datos empresariales fiables y contexto de los modelos semánticos e informes de Power BI a los clientes de IA. En este artículo se trata el punto de conexión de consumo MCP anterior de Power BI, que está en versión preliminar.

Prerrequisitos

Configuración en VS Code

El servidor MCP remoto de Power BI está disponible en:

https://api.fabric.microsoft.com/v1/mcp/powerbi

La manera más fácil de configurar el servidor es mediante el instalador con un solo clic:

Install Power BI servidor MCP (remoto)

Este instalador configura automáticamente el servidor MCP en la configuración de VS Code.

Instalación manual

Para configurar manualmente el servidor, agregue el código siguiente al archivo de configuración de MCP:

{
    "servers": {
        "powerbi-remote": {
            "type": "http",
            "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
        }
    }
}

Más información:Servidores MCP en VS Code

Prueba de la conexión del servidor MCP de Power BI

Después de la configuración, compruebe que el programa de instalación funciona:

  1. Inicio del servidor MCP en VS Code

    • Abra el panel Servidores MCP.
    • Asegúrese de que el servidor MCP de Power BI se muestra como conectado

  2. Apertura de GitHub Copilot

    1. Inicio de la ventana de chat en VS Code
    2. Habilitación del modo de agente

  3. Proporcione el identificador del modelo semántico.

    1. Obtenga el identificador de modelo semántico del servicio Power BI (consulte Búsqueda del identificador de modelo semántico).
    2. Compartir el identificador con Copilot en la conversación

  4. Formular una pregunta

    • Ejemplo: "¿Qué tablas hay en este modelo semántico?"
    • Ejemplo: "Mostrarme los 10 productos principales por ventas"

  5. Autorización de la herramienta

    1. Cuando se le solicite, permita que Copilot use la herramienta de servidor MCP.
    2. Autenticación con las credenciales de Microsoft si se solicita

  6. Revisión de la respuesta

    • Copilot consulta el modelo y devuelve resultados

Sugerencia

Para obtener los mejores resultados de las consultas, prepare los modelos semánticos para la inteligencia artificial mediante la adición de instrucciones de IA y respuestas comprobadas.

Solución de problemas:Administración de servidores MCP en VS Code

Herramientas de servidor mcp de Power BI disponibles

El servidor MCP remoto Power BI proporciona las siguientes herramientas para que los agentes de IA invoquen: Ejecutar consulta, Obtener esquema de modelo semántico, Obtener metadatos de informe y Generar consulta. En las secciones siguientes se describe cada herramienta.

Herramienta para ejecutar consultas

La herramienta Ejecutar consulta ejecuta una consulta DAX en un modelo semántico de Power BI y devuelve los resultados al agente de IA.

Entradas necesarias:

  • ID de modelo semántico
  • Expresión de consulta DAX

Permisos:

  • Debe contar con al menos permisos de compilación sobre el modelo semántico
  • Las consultas se ejecutan en el contexto del usuario autenticado

Consideraciones de seguridad:

Consulte también:Execute Queries REST API

Obtener la herramienta de esquema de modelo semántico

La herramienta Obtener esquema de modelo semántico recupera metadatos completos para un modelo semántico de Power BI, incluidas tablas, columnas, medidas, relaciones y todos los metadatos optimizados para ia que configuró el autor del modelo. Use esta herramienta para basar la generación de consultas DAX en la estructura del modelo y mostrar orientaciones proporcionadas por el autor que mejoran la precisión de las consultas.

Entrada necesaria: Id. de modelo semántico

Lo que se incluye:

  • Tablas, columnas, medidas y relaciones
  • Tipos de datos y jerarquías
  • Metadatos de herramientas de Copilot, cuando se configuran, proporcionan más contexto sobre su modelo, ayudan a orientar a Copilot hacia los datos correctos del modelo y contribuyen a mejorar la calidad de la salida de Copilot.

Herramienta para obtener metadatos del informe

La herramienta Obtener metadatos de informe recupera el esquema de alto nivel de un informe de Power BI, incluida la información del área de trabajo, los detalles del modelo semántico, las páginas, la información visual y los filtros. Los informes revelan cómo un informe usa el modelo semántico en la práctica y puede aclarar el contexto, las relaciones y la lógica de filtrado previstos que deben guiar la generación de consultas DAX. Use esta herramienta para basar la generación de consultas DAX en la estructura del esquema del modelo que utiliza el informe y mostrar las indicaciones proporcionadas por el autor que mejoran la precisión de las consultas.

Entrada necesaria: Id. de informe

Lo que se incluye:

  • Páginas del informe, independientemente del estado oculto
  • Objetos visuales con referencias válidas al esquema del modelo, como gráficos, tablas, matrices, segmentaciones y tarjetas. La herramienta excluye objetos visuales que no son de datos, como botones de acción, formas, imágenes y rectángulos.
  • Columnas y medidas ocultas cuando los objetos visuales hacen referencia a ellas
  • Enlaces visuales que asignan campos a roles visuales como Category, Values, Legend y Tooltips
  • Contenido del cuadro de texto de cada página

Límites:

  • Se produce un error en las solicitudes cuando los metadatos del informe superan el tamaño máximo admitido.

Generar herramienta de consulta

La herramienta Generar consulta usa Copilot en Power BI para crear consultas DAX optimizadas a partir de mensajes de lenguaje natural. La herramienta usa el mismo motor de generación DAX que Copilot para Power BI para crear consultas que sigan los procedimientos recomendados.

Entradas necesarias:

  • ID de modelo semántico
  • Pregunta o instrucción de lenguaje natural
  • Contexto de esquema relevante que determina el agente (tablas, columnas, medidas)

Requisitos:

Note

Si prefiere no consumir capacidad de Copilot, deshabilite esta herramienta en la configuración del cliente MCP y confíe en el LLM del cliente para generar DAX directamente.

Encuentra tu identificador de modelo semántico

Para obtener un identificador de modelo semántico del servicio Power BI:

  1. Inicio de sesión en Power BI
  2. Vaya al área de trabajo que contiene el modelo semántico.
  3. Seleccione el modelo semántico para abrir su página de detalles.
  4. Copie el identificador del modelo semántico desde la dirección URL.

Las direcciones URL del modelo semántico siguen este formato:

https://app.powerbi.com/groups/{workspaceId}/datasets/{semanticModelId}

Sugerencia

  • Almacene los identificadores de modelo que use con frecuencia en lugares a los que su agente pueda acceder, como en un semantic-model-ids.json archivo local o en archivos de instrucciones del agente.
  • También puede recuperar identificadores de modelo semánticos mediante programación mediante la API REST de Power BI.

Limitaciones y consideraciones

Autenticación y seguridad

  • Seguridad de nivel de fila (RLS): Power BI no aplica RLS cuando se utiliza la autenticación de entidad de servicio. Cuando una entidad de servicio ejecuta consultas, puede acceder a todos los datos a los que esa entidad está autorizada a acceder. Revise detenidamente las implicaciones de seguridad antes de exponer agentes autenticados por la entidad de servicio a los usuarios finales.
  • Configuración del inquilino: Los administradores deben habilitar "Los usuarios pueden usar el punto de conexión del servidor del protocolo de contexto de modelo de Power BI (versión preliminar)" para su organización.

Generación de consultas

  • DAX complejo: Es posible que los cálculos muy complejos o la lógica anidada no se traduzcan perfectamente desde indicaciones en lenguaje natural.
  • Optimización del modelo: La calidad de la generación de consultas mejora significativamente al preparar los datos para la inteligencia artificial.

Performance

  • Impacto en el diseño del modelo: El rendimiento de la ejecución de consultas depende del diseño, el tamaño y la optimización del modelo semántico.
  • Esquemas grandes: Los modelos con cientos de tablas o miles de columnas pueden dar lugar a cargas de esquema grandes.
  • Complejidad de las consultas: Las consultas DAX complejas pueden tardar más tiempo en generarse y ejecutarse.

Contexto y conversación

  • Límites de la ventana de contexto: El modelo de IA que usa el cliente MCP limita la cantidad de contexto que puede mantener en los turnos de conversación.
  • Consultas sin estado: Cada consulta se ejecuta de forma independiente. El servidor no mantiene el estado de consulta entre las solicitudes.

Contenido relacionado

  • Se actualizó por última vez el