Cómo conectar Microsoft Power BI a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Microsoft Power BI, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Microsoft Power BI + Gemini

Power BI REST API, con inicio de sesión con tu cuenta profesional de Microsoft: áreas de trabajo, modelos semánticos, informes, paneles, flujos de datos, puertas de enlace y aplicaciones, consultas DAX contra un modelo, orígenes de datos, parámetros, historial y programación de actualizaciones, e iniciar o cancelar actualizaciones. Cambiar los parámetros del modelo viene desactivado al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Paso 1 — Obtener credenciales

La configuración lleva unos 10 minutos, una sola vez. Necesitas una cuenta profesional o educativa de Microsoft con licencia de Power BI (Free, Pro o Premium Per User) y un registro de aplicación gratuito en Microsoft Entra. En algunas organizaciones solo un administrador puede dar el consentimiento.

1. Abre https://entra.microsoft.com, luego Applications, App registrations, New registration. Se puede reutilizar el registro de aplicación de otro conector de Microsoft.
2. Tipos de cuenta admitidos: lo habitual es Accounts in this organizational directory only. Power BI solo funciona con cuentas profesionales o educativas, no con cuentas Microsoft personales.
3. URI de redirección: plataforma Web, https://cloud.anythingmcp.com/api/mcp-oauth/callback en AnythingMCP Cloud, o <your AnythingMCP URL>/api/mcp-oauth/callback si alojas AnythingMCP tú mismo. Debe coincidir carácter por carácter; si no, Microsoft responde AADSTS50011.
4. API permissions, Add a permission, Power BI Service, Delegated permissions: marca Workspace.Read.All, Dataset.ReadWrite.All, Report.Read.All, Dashboard.Read.All, Dataflow.ReadWrite.All, Gateway.Read.All y App.Read.All. Para un conector que solo deba leer, usa en su lugar Dataset.Read.All y Dataflow.Read.All. Después haz clic en Grant admin consent si en tu organización los usuarios no pueden dar el consentimiento por sí mismos.
5. Certificates & secrets, New client secret: copia el Value del secreto (se muestra una sola vez), no el Secret ID.
6. Pega el Application (client) ID en MICROSOFT_CLIENT_ID y el valor del secreto en MICROSOFT_CLIENT_SECRET. Define MICROSOFT_TENANT_ID con el Directory (tenant) ID, con tu dominio como contoso.onmicrosoft.com o con organizations para una aplicación multiinquilino; common y consumers no sirven. Instala el conector.
7. En la página del conector haz clic en Authorize with Provider e inicia sesión con un usuario que tenga licencia de Power BI. El refresh token se guarda cifrado y los access tokens se renuevan solos. Ejecuta power_bi_list_workspaces para comprobarlo.

Scope: el conector pide https://analysis.windows.net/powerbi/api/.default offline_access. .default concede los permisos de Power BI marcados en el paso 4 (añádelos o quítalos allí y vuelve a autorizar) y offline_access da el refresh token. No añadas scopes de Microsoft Graph a este conector: un token sirve a una sola API.

Con qué acceso: la IA ve exactamente lo que el usuario conectado puede ver en el servicio Power BI. Los modelos con seguridad de nivel de fila devuelven solo las filas que ese usuario puede ver.

Qué lee: las áreas de trabajo y quién tiene acceso con qué rol; por área de trabajo, los modelos semánticos (datasets), los informes y sus páginas, los paneles y sus iconos, los flujos de datos y las importaciones de archivos .pbix, .rdl, .xlsx o .json; el contenido de Mi área de trabajo del usuario, que no tiene id de área, con power_bi_list_my_datasets, power_bi_list_my_reports y power_bi_list_my_dashboards; las aplicaciones instaladas con sus informes y paneles; los orígenes de datos y parámetros de Power Query de un modelo; el historial de actualizaciones (una actualización fallida lleva su error en serviceExceptionJson), los detalles de una actualización mejorada y la programación; las transacciones de actualización y los orígenes de datos de los flujos de datos; las puertas de enlace locales que administra el usuario, sus orígenes de datos y si una puerta de enlace llega a uno de ellos.

Consultas DAX: power_bi_execute_dax_query responde preguntas con cifras de un modelo semántico. Requiere la opción de inquilino Dataset Execute Queries REST API (en portales de administración más recientes, Semantic model Execute Queries REST API; Admin portal, Tenant settings, Integration settings) y permisos Read y Build sobre el modelo. Los modelos alojados en Azure Analysis Services no se admiten. Una consulta por llamada, que empieza por EVALUATE (opcionalmente tras DEFINE), solo DAX. Para conocer un modelo, EVALUATE COLUMNSTATISTICS() lista sus tablas y columnas y EVALUATE TOPN(5, 'Table') muestra filas de ejemplo. La API no lista las medidas (las funciones INFO y las consultas DMV se rechazan), así que la IA te pregunta los nombres de las medidas o usa las que muestra el informe, y prefiere las medidas del modelo a sumar columnas en bruto. impersonated_user_name prueba la vista de otro usuario con seguridad de nivel de fila y requiere permiso de escritura sobre el modelo.

Qué escribe: power_bi_refresh_dataset, power_bi_cancel_refresh y power_bi_refresh_dataflow están activos al instalar. Una actualización carga los orígenes y cuenta para el límite diario, así que la IA te pide confirmación antes de iniciarla. La actualización de un dataset responde 202 sin cuerpo; la nueva ejecución aparece arriba en power_bi_get_refresh_history con estado Unknown mientras se ejecuta. La capacidad compartida (Pro) permite 8 actualizaciones al día por modelo, programadas incluidas, y solo notify_option. Opciones como type, objects o commit_mode la convierten en una actualización mejorada, que necesita capacidad Premium, PPU o Fabric y no debe enviar notify_option. Solo las actualizaciones mejoradas se pueden seguir con power_bi_get_refresh_details y cancelar con power_bi_cancel_refresh.

Desactivada al instalar: power_bi_update_dataset_parameters, que cambia parámetros de Power Query de un modelo (por ejemplo qué servidor o qué periodo carga) y surte efecto en la siguiente actualización. Actívala como herramienta individual solo si la IA debe hacerlo.

Formatos de datos: las listas llegan como {"value": [...]}. Los ids son GUID. Las horas son ISO 8601 en UTC. webUrl abre el elemento en el servicio Power BI. Los resultados DAX llegan en results[0].tables[0].rows, con claves de columna como Table[Column] y columnas calculadas como [Name].

Paginación y filtros: las herramientas de lista devuelven todo de una vez, salvo power_bi_list_workspaces y power_bi_list_workspace_users, que paginan con top y skip. Las áreas de trabajo se filtran con OData, por ejemplo contains(name,'Sales').

Límites: una consulta DAX devuelve una tabla con como máximo 100.000 filas o 1.000.000 de valores, lo que llegue antes, y 15 MB; cada usuario puede ejecutar 120 consultas por minuto. La Power BI REST API limita por usuario y por inquilino, y una respuesta 429 trae Retry-After. Las capacidades Premium ralentizan las actualizaciones cuando están sobrecargadas, y una actualización limitada durante más de una hora falla.

Errores habituales: 401 significa que la autorización caducó o fue revocada, o que el client secret caducó: pega un secreto nuevo si hace falta y vuelve a hacer clic en Authorize with Provider. 403 PowerBINotAuthorizedException o Unauthorized significa que el usuario no tiene acceso a esa área o elemento, que falta un permiso del paso 4 o, para DAX, que falta el permiso Build o la opción de inquilino. 404 ItemNotFound o PowerBIEntityNotFound significa un id incorrecto o un elemento en otra área de trabajo. 400 DatasetExecuteQueriesError significa que la consulta DAX no es válida; el mensaje del motor dice por qué. 400 en una actualización significa que se envió notify_option con opciones mejoradas, que se usaron opciones mejoradas en capacidad compartida o que ya hay una actualización en curso.

El conector no crea, edita ni borra informes, paneles o modelos, no sube archivos .pbix y no usa Microsoft Graph. No funciona con cuentas Microsoft personales.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Microsoft Power BI.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué modelos semánticos del área de trabajo Ventas fallaron en su última actualización y por qué?"
• "Según el modelo detrás del informe Resumen de ventas, ¿cuánto se facturó por región en el T3 de 2026?"
• "Muéstrame las tablas y columnas del modelo Finanzas y cinco filas de ejemplo de la tabla Pedidos."
• "Lista las páginas del informe Resumen ejecutivo y los iconos del panel de KPI."
• "Muestra el historial de actualizaciones de hoy del modelo Inventario y luego inicia una actualización cuando lo confirme."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot