Se connecter à Dataverse avec le protocole de contexte de modèle dans les clients non-Microsoft

Connectez-vous à Microsoft Dataverse à l’aide d’un client MCP (Non-Microsoft Model Context Protocol). Cet exemple décrit comment se connecter à l’aide de Claude.

Prerequisites

Il s’agit des conditions préalables à l’utilisation d’un serveur MCP Dataverse avec Claude.

• Activez le serveur MCP Dataverse pour l’environnement via les paramètres PPAC. Plus d’informations : Configurer et gérer le serveur Dataverse MCP pour un environnement
• Connexion Dataverse pour la configuration MCP.
• Installez le proxy local du serveur MCP Dataverse.
• ID de locataire de votre environnement Dataverse.

Créer une connexion Dataverse pour la configuration MCP

1. Accédez à Power Automate. Si nécessaire, passez à l’environnement approprié en le sélectionnant en haut à droite.

2. Sélectionnez Connexions dans le volet de navigation de gauche, puis sélectionnez + Nouvelle connexion dans la barre de commandes.

3. Tapez Dataverse dans la zone de recherche, puis sélectionnez le connecteur Microsoft Dataverse .

4. Complétez les instructions affichées à l'écran.

   Notez le nom d’utilisateur dans le nom de connexion. Il doit s’agir du même nom que celui que vous avez utilisé pour créer l’environnement précédemment.

5. Sélectionnez la connexion pour l’ouvrir. Collez cette URL lorsque vous y êtes invité. https://make.preprod.powerautomate.com/environments/fb6637eb-601d-e9d2-b7f0-1613fca29e7e/connections?apiName=shared_commondataserviceforapps&connectionName=64244f45b6f045299463becb30bcd9b8

Installer le proxy local du serveur MCP Dataverse

Ces étapes installent le proxy local du serveur MCP Dataverse utilisé par le client MCP, par exemple Claude pour le bureau ou VS Code GitHub Copilot.

1. Installez le Kit de développement logiciel (SDK) .NET 8.0 à partir du téléchargement ou avec cette commande PowerShell.

   winget install Microsoft.DotNet.SDK.8

2. Dans une fenêtre de terminal Windows, exécutez cette commande pour installer le proxy local Microsoft PowerPlatform.Dataverse.MCP .

   dotnet tool install --global --add-source https://api.nuget.org/v3/index.json Microsoft.PowerPlatform.Dataverse.MCP

Obtenir l’ID de client de votre environnement Dataverse

Lorsque vous configurez le serveur MCP Dataverse pour Claude pour le bureau ou VS Code GitHub, vous devez fournir la valeur TenantID.

Voici un moyen d’obtenir les détails de l’ID de locataire :

1. Accédez à Power Apps.
2. Sélectionnez Paramètres (icône d’engrenage) en haut à droite, puis sélectionnez Détails de la session.
3. Copiez la valeur de l’ID de locataire à partir des détails de la session Power Apps dans le Presse-papiers Windows. Notez ce GUID, car il sera utilisé ultérieurement dans les étapes de configuration.

Configurer et utiliser le serveur Dataverse MCP dans Claude

Claude AI est un grand modèle de langage (LLM) et chatbot développé par Anthropic. Il excelle dans le traitement du langage naturel et est multimodal, ce qui signifie qu’il peut traiter des entrées textuelles, audio et visuelles. Claude peut répondre à des questions, résumer des documents, générer du texte et même créer des diagrammes, des animations et du code.

Télécharger Claude pour le bureau

Si ce n’est déjà fait, téléchargez et installez Claude Desktop.

Une fois que vous avez installé Claude desktop, vous pouvez trouver et lancer Claude à partir de votre bureau.

Configurer le serveur MCP Dataverse dans Claude pour le bureau

1. Ouvrez Claude pour le bureau et accédez à Fichier>Paramètres.

2. Si vous n’avez configuré aucun serveur MCP pour Claude pour le bureau auparavant, vous observez une boîte de dialogue Paramètres. Sélectionnez Modifier la configuration.

3. Les fichiers de bureau Claude s’affichent. Ouvrez le claude_desktop_config.json fichier avec votre éditeur JSON favori.

4. Remplacez <l’URL> de connexion et <l’ID> de locataire par l’URL de connexion et l’ID de locataire , puis collez l’extrait de code JSON dans la section appropriée du fichier. Pour plus d’informations, consultez Créer une connexion Dataverse pour la configuration de MCP et Obtenir l’ID de client de votre environnement Dataverse

   Utilisez un <nom convivial> pour votre serveur MCP Dataverse que vous pouvez facilement mémoriser, par exemple : MyDataverseMCPServer.

{
     "mcpServers": {
    "<friendly name>": {
      "command": "Microsoft.PowerPlatform.Dataverse.MCP",
      "args": [
        "--ConnectionUrl",
        "<URL for Dataverse connection>",
        "--MCPServerName",
        "DataverseMCPServer",
        "--TenantId",
        "<Tenant Id GUID>",
        "--EnableHttpLogging",
        "true",
        "--EnableMsalLogging",
        "false",
        "--Debug",
        "false",
        "--BackendProtocol",
        "HTTP"
         ]
       }
     }
   }

5. Enregistrez ce fichier et revenez sur le bureau de Claude.

Vérifier et interagir avec la connexion dans Claude Desktop

1. Redémarrez Claude Desktop et assurez-vous que les modifications prennent effet. Sélectionnez Fichier>Quitter.
2. Ouvrez Claude pour le bureau maintenant que la configuration du serveur MCP Dataverse est terminée à partir de l’étape précédente. Vous devez utiliser vos informations d’identification pour vous connecter à votre environnement Dataverse.
3. Vérifiez que vous pouvez afficher le serveur MCP Dataverse et les outils en sélectionnant Recherche et outils. Vous devriez être en mesure d’observer le nom convivial du serveur MCP Dataverse, MyDataverseMCPServer, par exemple.
4. La sélection du serveur MCP (MyDataverseMCPServer) vous permet d’afficher la liste des outils pris en charge par ce serveur MCP.

Interagir avec le serveur MCP Dataverse dans Claude pour le bureau

Si vous avez des données dans l’environnement Dataverse, vous pouvez commencer à tester votre configuration en demandant des tables de liste dans Dataverse, décrire le compte de table ou le nombre de comptes que j’ai, et ainsi de suite. Pour plus d’informations, voir Ajouter ou supprimer des exemples de données

Articles connexes

Se connecter à Dataverse avec le protocole de contexte de modèle