FAQ sur la connexion à Dataverse avec le protocole de contexte de modèle

Cet article fournit des réponses aux questions fréquemment posées sur l’utilisation de Microsoft Dataverse avec un serveur MCP (Model Context Protocol).

Je ne peux pas m’authentifier. Quel est le problème ?

Vérifiez que l’URL de l’environnement Dataverse dans la configuration de votre client MCP est correcte. Accédez à Power Apps, sélectionnez l’environnement approprié, puis sélectionnez Paramètres (icône d’engrenage> Détails de session pour confirmer l’URL de votre instance.

Vérifiez également que le client MCP que vous utilisez est activé dans le Centre d’administration Power Platform. Plus d’informations : Configurer et gérer le serveur Dataverse MCP pour un environnement

Quels sont les outils MCP disponibles et ce qu’ils font ?

Le serveur MCP Dataverse fournit des outils pour les opérations de données courantes telles que l’interrogation d’enregistrements, la création et la mise à jour de lignes, la description des schémas de table et la description des tables. Pour obtenir la liste complète des outils et descriptions, accédez à Dataverse avec le protocole de contexte de modèle.

Puis-je restreindre les tables ou enregistrements accessibles via le serveur MCP ?

Oui. Le serveur MCP Dataverse respecte les rôles de sécurité Dataverse et la sécurité au niveau des lignes. Les utilisateurs peuvent uniquement accéder aux tables et enregistrements que leur rôle de sécurité autorise. Aucun contrôle d’accès mcP supplémentaire n’est nécessaire au-delà de la configuration de sécurité Dataverse standard.

Existe-t-il des coûts associés à l’utilisation du serveur McP Dataverse ?

À compter du 15 décembre 2025, les outils MCP Dataverse sont facturés lorsqu’ils sont accessibles par les agents IA créés en dehors de Microsoft Copilot Studio. Si vous avez des licences Dynamics 365 Premium éligibles ou une licence d’abonnement utilisateur Microsoft 365 Copilot (USL), vous n’êtes pas facturé pour accéder aux données Dynamics 365. Pour plus d’informations sur les tarifs de facturation, consultez Connect to Dataverse with Model Context Protocol.

Puis-je utiliser le serveur MCP Dataverse avec plusieurs environnements ?

Oui. Chaque environnement Dataverse peut avoir sa propre configuration de serveur MCP. Vous pouvez vous connecter à plusieurs environnements en configurant des entrées de serveur MCP distinctes dans votre client, chacune pointant vers une URL d’environnement différente.

Que dois-je faire si un outil Dataverse MCP retourne une erreur ?

Si un outil retourne une erreur, essayez de réécrire votre demande et de la soumettre à nouveau. Utilisez un langage plus spécifique pour décrire ce que vous souhaitez accomplir. Si l’erreur persiste, vérifiez que vous disposez des autorisations Dataverse appropriées pour l’opération que vous tentez.

Pourquoi ne vois-je pas l’outil de recherche sur le serveur McP Dataverse ?

L’outil de recherche est disponible uniquement lorsque la recherche Dataverse est activée pour votre environnement. Si la recherche Dataverse n’est pas activée, l’outil de recherche n’apparaît pas dans la liste des outils MCP disponibles. Pour activer la recherche Dataverse, accédez à Configurer la recherche Dataverse pour votre environnement.

Pourquoi puis-je voir différents outils sur les points de terminaison /api/mcp et /api/mcp_preview ?

Le point de terminaison /api/mcp fournit l’ensemble généralement disponible d’outils MCP Dataverse, tandis que le point de terminaison /api/mcp_preview inclut des outils en préversion supplémentaires qui sont évalués avant la disponibilité générale. Les outils en préversion peuvent changer ou être supprimés sans préavis. Pour accéder aux outils en préversion, un administrateur doit activer le paramètre de fonctionnalités en préversion dans le Centre d’administration Power Platform. Plus d’informations : Utiliser les outils en préversion et les fonctionnalités à venir dans le serveur MCP Dataverse

Comment activer la journalisation du débogage pour le proxy local ?

Si vous rencontrez des problèmes avec le proxy local (@microsoft/dataverse), vous pouvez activer la journalisation du débogage pour capturer une sortie détaillée pour la résolution des problèmes. Ajoutez les arguments --log-level et --log-file à la commande proxy :

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file

Le fichier journal est écrit dans le répertoire temporaire système. L’emplacement par défaut dépend de votre système d’exploitation :

Vous pouvez partager le fichier journal de sortie avec Microsoft lors de l’ouverture d’un incident de support pour vous aider à diagnostiquer le problème.