Registrar el servidor mcp remoto Power BI con clientes MCP externos (versión preliminar)

El servidor MCP de Power BI remoto funciona de forma predeterminada con clientes MCP que se incluyen con una aplicación de Microsoft Entra registrada previamente, como Visual Studio Code y la CLI de GitHub Copilot. Otros clientes MCP, como Claude Desktop y ChatGPT , requieren el registro de un identificador de cliente de OAuth. Microsoft Entra ID no admite actualmente el registro de cliente, por lo que estos clientes no pueden obtener automáticamente un identificador de cliente para el servidor MCP de Power BI.

Para solucionarlo, registre una aplicación de Microsoft Entra usted mismo y proporcione su identificador de aplicación (cliente) al cliente MCP como identificador de cliente de OAuth.

En este artículo aprenderá a:

  • Creación y configuración de un registro de aplicación de Microsoft Entra para un cliente MCP externo
  • Registrar el servidor MCP de Power BI remoto en el cliente externo mediante el identificador de la aplicación Entra

Prerrequisitos

Antes de comenzar, asegúrese de que tiene:

  • Aprobación del administrador - El administrador de Power BI debe habilitar la siguiente configuración de inquilino: Los usuarios pueden usar el punto de conexión del servidor del Protocolo de Contexto de Modelo de Power BI (versión preliminar).
  • Permisos para registrar una aplicación - Puede registrar aplicaciones en su inquilino de Microsoft Entra o trabajar con un administrador del inquilino que pueda registrar la aplicación por usted.

Paso 1: Crear un registro de aplicaciones de Microsoft Entra

Cree un nuevo registro de aplicaciones en el mismo inquilino de Microsoft Entra que hospeda el entorno de Power BI.

  1. Inicie sesión en el Centro de administración Microsoft Entra como usuario que pueda registrar aplicaciones.
  2. Vaya a Registros de aplicaciones y seleccione Nuevo registro.
  3. Escriba un nombre descriptivo, por ejemplo, Power BI MCP - Claude Desktop.
  4. En Tipos de cuenta admitidos, seleccione Cuentas solo en este directorio organizativo (inquilino único).
  5. Deje el URI de redirección vacío por ahora. Lo configuras en el siguiente paso.
  6. Seleccione Registrar.
  7. En la página Información general de la aplicación, copie el identificador de aplicación (cliente). Se usa más adelante cuando configure el cliente MCP.

Paso 2: Configurar el URI de redirección

Los clientes MCP externos actúan como clientes públicos, por lo que debe agregar un URI de redirección de tipo Cliente público o nativo (móvil y escritorio).

  1. En el registro de la aplicación, seleccione Autenticación>Agregar URI de redirección>Aplicaciones móviles y de escritorio.

  2. Agregue el URI de redirección proporcionado por el cliente MCP. Por ejemplo:

    Cliente MCP URI de redirección
    Escritorio Claude https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Otros clientes Utilice la URL de retorno de OAuth documentada por el cliente

  3. Seleccione Configurar para guardar la configuración de la plataforma.

  4. En la página Autenticación , en Configuración avanzada, confirme que Permitir flujos de cliente públicos está establecido en No a menos que la documentación del cliente lo requiera explícitamente.

  5. Haga clic en Guardar.

Importante

Use siempre el URI de redirección exacto documentado por el cliente MCP. Una falta de coincidencia hace que se produzca un error en el inicio de sesión de OAuth.

Paso 3: Agregar permisos de API de Power BI delegados

El servidor MCP de Power BI remoto llama a las API rest de Power BI en nombre del usuario que ha iniciado sesión. Conceda los siguientes permisos delegados en la API Power BI Service.

  1. En el registro de la aplicación, seleccione Permisos> de APIAgregar un permiso.

  2. Seleccione Power BI Service en Microsoft API.

  3. Seleccione Permisos delegados y agregue los permisos siguientes:

    URI del recurso: https://analysis.windows.net/powerbi/api

    Ámbito Description
    Dataset.Read.All Lea todos los modelos semánticos a los que puede acceder el usuario.
    MLModel.Execute.All Permite ejecutar modelos de ML.
    Workspace.Read.All Lea las áreas de trabajo a las que puede acceder el usuario.

  4. Seleccione Agregar permisos.

  5. (Opcional) Si el inquilino requiere el consentimiento del administrador para estos permisos, seleccione Conceder consentimiento del administrador. De lo contrario, se pide a los usuarios que dé su consentimiento la primera vez que inicien sesión desde el cliente MCP.

Paso 4: Registrar el servidor MCP de Power BI remoto en el cliente MCP

Use el identificador de Application (cliente) del paso 1 como identificador de cliente de OAuth al agregar el servidor MCP de Power BI remoto al cliente. Los pasos de configuración exactos dependen del cliente.

Si se produce un error al iniciar sesión, compruebe que:

  • El URI de redirección de la aplicación Entra coincide exactamente con el esperado por el cliente.
  • Se conceden los permisos de Power BI delegados necesarios (y el administrador da su consentimiento si lo requiere el inquilino).
  • La configuración del inquilino "Los usuarios pueden usar el punto de conexión del servidor de Power BI del Protocolo de contexto de modelo (versión preliminar)" está habilitada.

Escritorio Claude

  1. Abra Claude Desktop y, a continuación, vaya a Configuración>conectores>Agregar conector personalizado.

  2. Escriba los siguientes valores:

    • Nombre: Power BI
    • Dirección URL remota del servidor MCP: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Id. de cliente de OAuth: el identificador de aplicación (cliente) del paso 1.

  3. Guarde el conector. Claude Desktop abre una ventana del explorador para que pueda iniciar sesión con su cuenta de Microsoft Entra y dar su consentimiento a los permisos de Power BI solicitados.

ChatGPT

  1. En ChatGPT, vaya a Configuración>Aplicaciones>crear aplicación.

  2. Rellene el cuadro de diálogo Nueva aplicación :

    • Nombre: Power BI
    • DIRECCIÓN URL del servidor MCP: https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Autenticación: seleccione OAuth.

  3. Expanda Configuración avanzada para revisar la configuración de OAuth detectada y, a continuación, configure:

    • Método de registro: seleccione cliente OAuth definido por el usuario.
    • Id. de cliente de OAuth: escriba el identificador de aplicación (cliente) del paso 1.

  4. Selecciona Crear. ChatGPT le pide que inicie sesión con su cuenta de Microsoft Entra y dé su consentimiento a los permisos de Power BI solicitados.

Otros clientes MCP

Para otros clientes de MCP, siga la documentación del cliente para agregar un servidor MCP remoto.

Prueba de la conexión

Después de registrar el servidor en el cliente, valide la configuración:

  1. Inicie una nueva conversación en el cliente MCP.
  2. Haga una pregunta que requiera el Power BI servidor MCP, por ejemplo: "¿Qué tablas están en el modelo semántico [id. del modelo semántico]?".
  3. Confirme que el cliente devuelve los resultados del modelo semántico de Power BI.

Contenido relacionado

  • Last updated on