Enregistrer le serveur MCP distant de Power BI avec des clients MCP externes (version préliminaire)

Le serveur MCP distant de Power BI fonctionne immédiatement avec les clients MCP qui incluent une application Microsoft Entra préenregistrée, comme Visual Studio Code et l’interface de ligne de commande GitHub Copilot. D’autres clients MCP, tels que Claude Desktop et ChatGPT , nécessitent l’inscription d’un ID client OAuth. Microsoft Entra ID ne prend actuellement pas en charge l'inscription du client. Ces clients ne peuvent donc pas obtenir automatiquement un ID client pour le serveur MCP Power BI.

Pour contourner ce problème, vous inscrivez une application Microsoft Entra vous-même et fournissez son ID d’application (client) au client MCP en tant qu’ID client OAuth.

Cet article vous montre comment :

  • Créer et configurer une inscription d’application Microsoft Entra pour un client MCP externe
  • Inscrire le serveur MCP distant Power BI dans le client externe à l’aide de l’ID d’application Entra

Prerequisites

Avant de commencer, assurez-vous d’avoir :

  • Approbation de l’administrateur - Votre administrateur Power BI doit activer le paramètre du locataire : Les utilisateurs peuvent utiliser le point de terminaison du serveur Power BI Model Context Protocol (préversion).
  • Permissions pour inscrire une application : vous pouvez inscrire des applications dans votre locataire Microsoft Entra ou travailler avec un administrateur client qui peut inscrire l’application pour vous.

Étape 1 : Créer une inscription d’application Microsoft Entra

Créez une nouvelle inscription d’application dans le même locataire Microsoft Entra qui héberge votre environnement Power BI.

  1. Connectez-vous au centre d’administration Microsoft Entra en tant qu’utilisateur qui peut inscrire des applications.
  2. Accédez à inscriptions d'applications, puis sélectionnez Inscription .
  3. Entrez un nom explicite, par exemple Power BI MCP - Claude Desktop.
  4. Sous Types de comptes pris en charge, sélectionnez Comptes dans cet annuaire organisationnel uniquement (locataire unique).
  5. Laissez l’URI de redirection vide pour l’instant. Vous la configurez à l’étape suivante.
  6. Sélectionnez Inscrire.
  7. Dans la page Vue d’ensemble de l’application, copiez l’ID d’application (client). Vous l’utilisez ultérieurement lorsque vous configurez le client MCP.

Étape 2 : Configurer l’URI de redirection

Les clients MCP externes agissent en tant que clients publics. Vous devez donc ajouter un URI de redirection de type client public/natif (mobile &desktop).

  1. Dans l’inscription de votre application, sélectionnez Authentification>Ajouter un URI de redirection>Applications mobiles et de bureau.

  2. Ajoutez l’URI de redirection fourni par votre client MCP. Par exemple:

    Client MCP URI de redirection
    Claude Desktop https://claude.ai/api/mcp/auth_callback
    ChatGPT https://chatgpt.com/connector/oauth/<random_chars>
    Autres clients Utiliser l’URL de rappel OAuth documentée par le client

  3. Sélectionnez Configurer pour enregistrer la configuration de la plateforme.

  4. Dans la page Authentification , sous Paramètres avancés, vérifiez que l’autorisation des flux clients publics est définie sur Non , sauf si votre documentation client l’exige explicitement.

  5. Cliquez sur Enregistrer.

Important

Utilisez toujours l’URI de redirection exact documenté par votre client MCP. Une incompatibilité entraîne l’échec de la connexion OAuth.

Étape 3 : Ajouter des autorisations de API Power BI déléguées

Le serveur MCP distant Power BI appelle les API REST Power BI pour le compte de l’utilisateur connecté. Accordez les autorisations déléguées suivantes sur l’API Power BI Service.

  1. Dans l’inscription de votre application, sélectionnez Autorisations d’API>Ajouter une autorisation.

  2. Sélectionnez Power BI Service dans Microsoft API.

  3. Sélectionnez Autorisations déléguées, puis ajoutez les autorisations suivantes :

    URI de ressource : https://analysis.windows.net/powerbi/api

    Étendue Description
    Dataset.Read.All Lisez tous les modèles sémantiques auxquels l’utilisateur peut accéder.
    MLModel.Execute.All Autorise l’exécution de modèles ML.
    Workspace.Read.All Lisez les espaces de travail que l’utilisateur peut accéder.

  4. Sélectionnez Ajouter des autorisations.

  5. (Facultatif) Si votre locataire requiert le consentement administrateur pour ces autorisations, sélectionnez Accorder le consentement de l’administrateur. Sinon, les utilisateurs sont invités à donner leur consentement la première fois qu’ils se connectent à partir du client MCP.

Étape 4 : Inscrire le serveur MCP à distance Power BI dans le client MCP

Utilisez l’ID Application (client) de l’étape 1 en tant qu’ID client OAuth lorsque vous ajoutez le serveur mcP distant Power BI à votre client. Les étapes de configuration exactes dépendent du client.

Si la connexion échoue, vérifiez que :

  • L’URI de redirection dans votre application Entra correspond exactement à celui attendu par le client.
  • Les autorisations de Power BI déléguées requises sont accordées (et les autorisations d’administrateur sont accordées si elles sont requises par votre locataire).
  • Le paramètre du locataire « Les utilisateurs peuvent utiliser le point de terminaison du serveur Power BI Model Context Protocol (préversion) » est activé.

Claude Desktop

  1. Ouvrez Claude Desktop, puis accédez à Paramètres>Connecteurs>Ajouter un connecteur personnalisé.

  2. Saisissez les valeurs suivantes :

    • Nom : Power BI
    • URL du serveur MCP distant : https://api.fabric.microsoft.com/v1/mcp/powerbi
    • ID client OAuth : ID d’application (client) de l’étape 1.

  3. Enregistrez le connecteur. Claude Desktop ouvre une fenêtre de navigateur pour vous connecter avec votre compte Microsoft Entra et donner votre consentement aux autorisations de Power BI demandées.

ChatGPT

  1. Dans ChatGPT, accédez à Paramètres>Apps>Create App.

  2. Renseignez la boîte de dialogue Nouvelle application :

    • Nom : Power BI
    • URL du serveur MCP : https://api.fabric.microsoft.com/v1/mcp/powerbi
    • Authentification : sélectionnez OAuth.

  3. Développez Paramètres avancés pour passer en revue les paramètres OAuth découverts, puis configurez :

    • Méthode d’inscription : sélectionnez User-Defined client OAuth.
    • ID client OAuth : entrez l’ID d’application (client) de l’étape 1.

  4. Cliquez sur Créer. ChatGPT vous invite à vous connecter avec votre compte Microsoft Entra et à donner votre consentement aux autorisations de Power BI demandées.

Autres clients MCP

Pour les autres clients MCP, suivez la documentation du client pour ajouter un serveur MCP distant.

Tester votre connexion

Après avoir inscrit le serveur dans le client, validez la configuration :

  1. Démarrez une nouvelle conversation dans votre client MCP.
  2. Posez une question qui nécessite l’Power BI serveur MCP, par exemple : « Quelles tables sont dans le modèle sémantique [ID du modèle sémantique] ? ».
  3. Vérifiez que le client retourne les résultats de votre modèle sémantique Power BI.

Contenu connexe

  • Last updated on