Se connecter avec le connecteur BC MCP Pro
Le connecteur BC MCP Pro de Vangelder Solutions relie un assistant IA à Microsoft Dynamics 365 Business Central. À son démarrage, il lit dans l'extension MCP Guard la règle de l'utilisateur connecté et l'applique : les sociétés autorisées, la société par défaut, la configuration MCP, les niveaux d'accès et les limites quotidiennes. Le connecteur peut aussi signaler l'utilisation de chaque utilisateur. Chaque appel s'exécute toujours sous le compte Business Central de l'utilisateur : les ensembles d'autorisations et les filtres de sécurité s'appliquent donc sans changement.
Avant de commencer
Dans chaque environnement où les utilisateurs travaillent :
- L'extension est installée. Voir Installer l'extension MCP Guard.
- Chaque utilisateur dispose d'une licence MCP Guard et de l'ensemble d'autorisations MCP GUARD - USER. Voir Attribuer des licences.
- Les configurations MCP que les règles indiquent existent et sont Active. Voir Configurations MCP.
Utilisez la dernière version du connecteur, et mettez à jour le connecteur avant de mettre à jour l'extension. Certaines parties d'une règle exigent une version minimale du connecteur. Un connecteur plus ancien les ignore.
| Partie de la règle | Exige |
|---|---|
| Accès général | Le connecteur 0.8.0 ou ultérieur, ou l'édition cloud 0.11.0 ou ultérieure. Voir Accès général. |
| Rapport d'utilisation | L'édition cloud 0.12.0 ou ultérieure, avec le rapport activé. Voir Utilisation par utilisateur. |
| Limite quotidienne d'appels et Limite quotidienne de modifications | L'édition cloud 0.13.0 ou ultérieure, avec le rapport d'utilisation activé. Le connecteur de bureau ne les applique pas. Voir Limites quotidiennes. |
Ce que fait le connecteur à son démarrage
- Connexion. L'utilisateur se connecte une fois avec Microsoft.
- Environnement. Le connecteur utilise l'environnement qui est renseigné. Sinon, il prend d'abord les environnements de production, puis les autres par ordre alphabétique, et choisit le premier où l'utilisateur a des autorisations dans au moins une société.
- Sociétés. Pour chaque société, le connecteur vérifie si l'utilisateur peut y travailler.
- Règle. Le connecteur lit la règle de l'utilisateur dans la page API
mcpUserSettings. Cet appel est aussi la vérification de la licence. - Connexion au serveur. Le connecteur se connecte au serveur MCP de Business Central avec la société et la configuration MCP qui en résultent, avec le changement de société limité aux sociétés autorisées, et avec les outils que l'utilisateur ne peut pas utiliser masqués.
Ce que le connecteur lit dans l'extension
La page MCP Guard User Settings API (73633179) renvoie au plus une ligne : la règle qui s'applique à l'utilisateur connecté.
GET https://api.businesscentral.dynamics.com/v2.0/{tenantId}/{environment}/api/vangelderSolutions/mcpguard/v1.0/companies({companyId})/mcpUserSettings
| Champ | Signification |
|---|---|
allowedCompanies | Noms de sociétés, séparés par des points-virgules. Vide signifie toutes les sociétés dans lesquelles l'utilisateur a des autorisations. |
defaultCompany | La société dans laquelle la connexion s'ouvre. Lorsqu'elle ne figure pas parmi les sociétés autorisées, la première société autorisée est utilisée. |
configurationName | Le nom de la configuration MCP. Vide signifie la configuration par défaut de l'environnement. |
settingSource | User ou Group : l'origine de la règle. |
licenceSource | Licensed, ou SandboxRule pour un utilisateur sans licence dans un environnement bac à sable. |
productionAccess, planningAccess, assemblyAccess, projectAccess | Le niveau d'accès par module. |
generalAccess | Le niveau d'accès pour tout ce qui se trouve en dehors des pages API propres à l'extension. |
dailyCallLimit, dailyChangeLimit | Les limites quotidiennes. 0 signifie aucune limite. |
Aucune ligne signifie qu'aucune règle ne s'applique : l'utilisateur obtient toutes les sociétés dans lesquelles il a des autorisations et la configuration MCP par défaut.
Dans un environnement bac à sable, un utilisateur qui a désactivé l'assistant IA sur la page Mon MCP Guard obtient une réponse comme si aucune règle ne s'appliquait, et le connecteur omet ce bac à sable. Voir Activer ou désactiver l'assistant IA dans un bac à sable.
Plusieurs environnements
Le connecteur peut conserver chaque environnement où l'utilisateur a des autorisations et où l'extension admet l'utilisateur. Il lit alors la règle une fois par environnement. Un environnement sans l'extension, ou dans lequel l'utilisateur n'a pas de licence, est ignoré. L'utilisateur ne voit un message que lorsqu'il ne reste aucun environnement.
Les règles sont par environnement. Installez l'extension et créez les règles dans chaque environnement que les utilisateurs doivent atteindre.
Les niveaux d'accès dans le connecteur
Le connecteur lit les niveaux d'accès et masque ce que la règle n'autorise pas : un outil ou une action des pages API de l'extension qui exige un niveau supérieur est omis de la liste des outils. Business Central applique les mêmes niveaux sur le serveur : le résultat est donc le même lorsqu'un utilisateur se connecte avec un autre client MCP. Voir Niveaux d'accès par module.
Pour l'Accès général, le connecteur est le seul à appliquer le niveau. Il masque et refuse les actions sur les pages standard de Business Central qui dépassent le niveau. Voir Accès général.
Ce que le connecteur applique, et ce que Business Central applique
Les sociétés, la société par défaut, la configuration MCP, l'Accès général, les limites quotidiennes, le rapport d'utilisation et l'interrupteur du bac à sable sont appliqués par le connecteur. Ils sont une stratégie, pas une limite de sécurité : un utilisateur qui utilise un autre client MCP peut toujours choisir une autre société ou une autre configuration, et n'est pas limité par eux. Les niveaux d'accès par module et toutes les autorisations sont appliqués par Business Central.