Résoudre les problèmes du connecteur BC MCP Pro
Cet article traite des messages que le connecteur BC MCP Pro affiche lorsqu'il lit la règle de l'utilisateur auprès de l'extension MCP Guard dans Microsoft Dynamics 365 Business Central et ne peut pas continuer. Les messages proviennent du connecteur : l'utilisateur les voit donc dans l'assistant IA et non dans Business Central. Dans certains messages, le connecteur désigne encore l'extension par son ancien nom, BC MCP Pro. Chaque titre est le début du message, en anglais tel que le connecteur l'affiche. Les mots en italique représentent une valeur qui diffère selon le cas.
BC MCP Pro (MCP Guard) is not installed in environment nom, or its version is too old
Cause : L'extension est absente de l'environnement que le connecteur a choisi, ou les versions de l'extension et du connecteur ne concordent pas. Un ancien connecteur peut aussi afficher ce message pour une version plus récente de l'extension.
Solution :
- Installez ou mettez à jour l'extension dans cet environnement depuis Microsoft Marketplace. Voir Installer l'extension MCP Guard.
- Mettez à jour le connecteur vers sa dernière version.
Whether MCP Guard is installed could not be checked in nom
Cause : Business Central n'a pas répondu dans cet environnement : le connecteur ne peut donc pas déterminer si l'extension s'applique.
Solution : Réessayez dans quelques instants. Le message disparaît de lui-même.
No BC MCP Pro licence is assigned to utilisateur
Le message complet se poursuit ainsi :
Ask your administrator to assign one in the Microsoft 365 admin center (Billing > Licenses)
Cause : Business Central a refusé de renvoyer la règle de l'utilisateur, parce qu'aucune licence MCP Guard ne lui est attribuée. Dans un environnement bac à sable, ce message apparaît aussi pour un utilisateur sans licence lorsqu'aucune règle ne s'applique à lui.
Solution : Attribuez une licence MCP Guard à l'utilisateur dans le Centre d'administration Microsoft 365. Voir Attribuer des licences.
La connexion est refusée parce que l'ensemble d'autorisations MCP GUARD - USER manque
Cause : Le connecteur refuse la connexion parce que l'utilisateur n'a aucun ensemble d'autorisations qui comprend MCP GUARD - USER : l'utilisateur ne peut donc pas lire sa règle. Sur la page Paramètres utilisateur MCP Guard, la colonne Ensemble d'autorisations utilisateur affiche Introuvable pour cet utilisateur.
Solution : Attribuez MCP GUARD - USER à l'utilisateur. Voir Ensembles d'autorisations.
MCP Guard allows utilisateur to use sociétés in environment nom, but the account has no permissions in any of those companies
Cause : Les sociétés du champ Sociétés autorisées de la règle de l'utilisateur et les sociétés dans lesquelles l'utilisateur a des autorisations Business Central ne se recoupent pas.
Solution : Modifiez l'un des deux.
- Sur la page Paramètres utilisateur MCP Guard, ajoutez à Sociétés autorisées une société dans laquelle l'utilisateur a des autorisations, ou
- Donnez à l'utilisateur des ensembles d'autorisations dans l'une des sociétés autorisées dans Business Central.
Voir Environnements et sociétés.
Company nom is not available for this connection
Cause : L'assistant IA a demandé une société qui ne figure pas parmi les sociétés autorisées de la règle de l'utilisateur. C'est la règle qui fait son travail.
Solution : Aucune, lorsque la société doit rester hors de portée. Lorsque l'utilisateur doit pouvoir utiliser la société, ajoutez-la à Sociétés autorisées sur la règle de l'utilisateur.
Business Central rejected the connection (HTTP 400/404)
Cause : La configuration MCP que la règle de l'utilisateur indique n'existe pas dans l'environnement, ou elle n'est pas active.
Solution :
- Ouvrez la page MCP Server Configurations dans l'environnement.
- Vérifiez que la configuration portant le nom du champ Configuration MCP de la règle existe.
- Vérifiez que Active est activé pour cette configuration.
Voir Configurations MCP.
Un environnement bac à sable manque dans l'assistant IA
Cause : Le connecteur omet un environnement où l'extension n'admet pas l'utilisateur. Pour un environnement bac à sable, cela se produit lorsque :
- L'utilisateur a désactivé l'assistant IA pour lui-même sur la page Mon MCP Guard dans ce bac à sable.
- L'utilisateur n'a pas de licence MCP Guard et aucune règle ne s'applique à lui dans ce bac à sable.
Solution :
- Lorsque l'utilisateur l'a désactivé, il ouvre Mon MCP Guard dans ce bac à sable et active Assistant IA dans ce bac à sable. Le bac à sable revient dans les dix minutes. Voir Activer ou désactiver l'assistant IA dans un bac à sable.
- Sinon, ajoutez une règle pour l'utilisateur dans ce bac à sable, ou attribuez-lui une licence. Voir Attribuer des licences.
Une règle a été modifiée, et l'assistant IA utilise encore les anciennes sociétés ou l'ancienne configuration
Cause : Le connecteur lit la règle à son démarrage. Il conserve le résultat sur l'appareil de l'utilisateur pour que le démarrage suivant soit rapide, et vérifie à nouveau la règle en arrière-plan.
Solution : Redémarrez le connecteur. Une règle modifiée, une licence retirée ou un accès retiré apparaît lors d'un démarrage suivant.
Où trouver le journal
Lorsque le connecteur s'exécute comme extension dans Claude Desktop, le journal est le fichier mcp-server-BC MCP Pro.log dans le dossier des journaux de Claude Desktop :
- Windows :
%LOCALAPPDATA%\Claude\Logs - macOS :
~/Library/Logs/Claude