Utilisation par utilisateur

MCP Guard peut conserver le nombre de fois où l'assistant IA de chaque utilisateur a appelé Microsoft Dynamics 365 Business Central. Le connecteur BC MCP Pro signale les appels, et l'extension MCP Guard conserve des totaux par jour. Elle ne conserve aucun prompt, aucun nom d'action et aucun contenu d'enregistrement. Vous voyez les totaux sur les pages Aperçu de l'utilisation de MCP Guard et Utilisation de MCP Guard, et via une page API pour les rapports.

L'utilisation compte les appels, pas le coût. Pour Microsoft 365 Copilot, les crédits se trouvent dans le Centre d'administration Microsoft 365 sous Rapports > Utilisation > Copilot.

Avant de commencer

C'est le connecteur qui décide s'il signale. Le rapport est désactivé tant que le connecteur n'a pas reçu l'instruction de signaler. Il faut le connecteur cloud BC MCP Pro, version 0.12.0 ou ultérieure. Sans rapport, l'utilisation reste vide.
Vous avez besoin de l'ensemble d'autorisations MCP GUARD - ADMIN pour voir l'utilisation.

Ce que contient une ligne d'utilisation

Il y a une ligne par jour, utilisateur, assistant, type d'appel et résultat.

Champ	Signification
Date	Le jour où les appels ont été effectués.
Nom d'utilisateur	L'utilisateur dont l'assistant IA a effectué les appels.
Assistant	L'assistant IA dans lequel l'utilisateur travaillait, comme Claude, ChatGPT ou Copilot.
Type	Ce que les appels ont fait : Recherche (rechercher quelles actions existent), Lecture, Modifier, Créer et actions ou Validation.
Résultat	Comment les appels se sont terminés : Réussi, Refusé ou Échoué. Refusé signifie que la règle de l'utilisateur n'autorisait pas l'action. Échoué couvre toute autre erreur, y compris les erreurs d'autorisation de Business Central.
Appels	Le nombre d'appels.
Durée (ms)	La durée totale des appels, en millisecondes.
Dernier appel le	Le moment où le connecteur a signalé des appels sur cette ligne pour la dernière fois.

Les lignes sont partagées par toutes les sociétés de l'environnement, comme les règles.

Voir l'utilisation par utilisateur et par assistant

Choisissez l'icône Rechercher, entrez Aperçu de l'utilisation de MCP Guard, puis choisissez le lien associé.
La page s'ouvre sur les 30 derniers jours. Pour changer de période, choisissez Aujourd'hui, 7 derniers jours, 30 derniers jours ou Tout, ou filtrez sur Filtre date.
Pour voir les jours derrière un nombre, choisissez le nombre. Pour voir tous les jours d'une ligne, choisissez Jours.

La page a une ligne par utilisateur et par assistant ayant des appels pendant la période.

Colonne	Affiche
Appels	Tous les appels de la période, quoi qu'ils aient fait et quelle qu'en soit l'issue.
Recherches et lectures	Les appels qui ont recherché des actions ou lu des données.
Modifications	Les appels qui ont modifié, créé ou validé quelque chose, ou qui ont essayé.
Refusé	Les appels que la règle de l'utilisateur n'a pas autorisés.
Échoué	Les appels qui se sont terminés par une erreur autre qu'un refus.
Durée moyenne (ms)	La durée moyenne d'un appel, en millisecondes.
Dernier appel le	Le moment où le connecteur a signalé pour la dernière fois des appels de cet utilisateur et de cet assistant pendant la période.

Voir les lignes par jour

Choisissez l'icône Rechercher, entrez Utilisation de MCP Guard, puis choisissez le lien associé. La page affiche les lignes d'utilisation, le jour le plus récent en premier. Elle est en lecture seule.

Utiliser l'utilisation dans un rapport ou un classeur

La page API mcpUsageTotals renvoie les mêmes lignes que la page Utilisation de MCP Guard.

GET https://api.businesscentral.dynamics.com/v2.0/{environment}/api/vangelderSolutions/mcpguard/v1.0/companies({companyId})/mcpUsageTotals

Les champs sont id, usageDate, userSecurityId, userName, assistant, kind, result, calls, durationMs et lastCallAt. La page est en lecture seule, et seul un utilisateur disposant de MCP GUARD - ADMIN peut la lire.

Comment l'utilisation arrive

Le connecteur envoie les appels à la page API mcpUsageEntries avec usageDate, assistant, kind, result, calls et durationMs. Chaque rapport est ajouté au total du jour de l'utilisateur connecté. Le connecteur appelle Business Central en tant qu'utilisateur : un utilisateur peut donc signaler plus d'appels propres qu'il n'en a faits, mais jamais les appels de quelqu'un d'autre.

L'extension refuse un rapport :

Pour un autre jour qu'aujourd'hui. Un jour avant ou après aujourd'hui est accepté, en raison des fuseaux horaires.
Avec moins de 1 ou plus de 10 000 appels.
Avec une durée négative.
Sans assistant.

La règle de licence est la même que pour la lecture de la règle : un utilisateur sans licence ne peut signaler l'utilisation que dans un environnement bac à sable où une règle s'applique à lui. Voir Attribuer des licences.

Une piste d'audit

Personne ne modifie ni ne supprime une ligne d'utilisation à la main. Les pages sont en lecture seule, et MCP GUARD - ADMIN n'a pas d'autorisation directe de suppression sur les lignes. Seule la stratégie de rétention les supprime. Un utilisateur disposant de l'ensemble d'autorisations SUPER peut tout faire dans Business Central, comme toujours.

Durée de conservation de l'utilisation

L'utilisation est conservée pendant un an. Lorsque l'extension est installée ou mise à niveau, elle ajoute une stratégie de rétention pour Utilisation de MCP Guard aux Stratégies de rétention de Business Central dans chaque société, activée. Une stratégie qui existe déjà est laissée telle quelle.

Les lignes d'utilisation sont partagées par les sociétés : la tâche de stratégie d'une seule société suffit donc. Vous pouvez choisir une autre période sur la stratégie ou désactiver la stratégie. Vous ne pouvez pas choisir une période inférieure à 90 jours.

Choisissez l'icône Rechercher, entrez Administration de MCP Guard, puis choisissez le lien associé.
Choisissez l'action Stratégie de rétention.
Modifiez la Période de rétention, ou désactivez la stratégie.

Important

La tâche qui applique les stratégies de rétention doit s'exécuter sous un utilisateur disposant de l'ensemble d'autorisations MCP GUARD - ADMIN ou SUPER. Sinon, les anciennes lignes d'utilisation ne sont pas supprimées.

Confidentialité

L'utilisation par personne est une donnée personnelle. Le nom d'utilisateur est classé comme EndUserIdentifiableInformation et l'ID de sécurité de l'utilisateur comme EndUserPseudonymousIdentifiers.