Référence utilisateur (aperçu)

Aperçu

Outils disponibles

mcp_graph_getDirectReports

Répertorie les rapports directs d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet (GUID) de l’utilisateur, soit leur userPrincipalName UPN (de type email). N’utilisez pas me comme le userIdentifier.

Paramètres obligatoires :

• userIdentifier : ID d’objet de l’utilisateur (GUID) ou userPrincipalName (UPN)

Paramètres facultatifs :

• Sélectionner : Liste des propriétés séparées par virgule à retourner (par exemple, id, displayName, mail, jobTitle, userPrincipalName)
• top : nombre d’éléments à retourner par page

mcp_graph_getMyManager

Récupère le gestionnaire de l’utilisateur connecté (l’appelant). Ce point de terminaison renvoie toujours le responsable du contexte utilisateur actuel.

Paramètres facultatifs :

• select : liste de propriétés du responsable à renvoyer, séparées par des virgules

mcp_graph_getMyProfile

Récupère les détails du profil de l’utilisateur connecté (l’appelant). Ce point de terminaison renvoie toujours le profil du contexte utilisateur actuel.

Paramètres facultatifs :

• select : liste séparée par des virgules des propriétés de profil utilisateur
• Étendre : Développer les tables associées (par exemple, manager, directReports)

mcp_graph_getUserProfile

Récupère le profil d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet (GUID) de l’utilisateur, soit leur userPrincipalName UPN (de type email). N’utilisez pas me comme le userIdentifier. Pour l’utilisateur connecté, utilisez mcp_graph_getMyProfile.

Paramètres obligatoires :

• userIdentifier : ID d’objet de l’utilisateur (GUID) ou userPrincipalName (UPN)

Paramètres facultatifs :

• select : liste de propriétés de l’utilisateur à renvoyer, séparées par des virgules
• Étendre : Étendre une table liée (manager OU directReports). Vous ne pouvez étendre qu’une seule propriété par requête.

mcp_graph_getUsersManager

Récupère le gestionnaire d’un utilisateur spécifié dans le répertoire. Indiquez l’ID d’objet de l’utilisateur (GUID) ou son userPrincipalName (UPN de type e-mail). N’utilisez pas me comme le userIdentifier. Pour l’utilisateur connecté, utilisez mcp_graph_getMyManager.

Paramètres obligatoires :

• userIdentifier : ID d’objet de l’utilisateur (GUID) ou userPrincipalName (UPN)

Paramètres facultatifs :

• select: Liste de propriétés séparées par des virgules à renvoyer pour le gestionnaire, telles que id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Récupère une liste d’utilisateurs de l’organisation. Prend en charge les options de requête telles que $select, $filter, $top$orderby. La valeur par défaut ConsistencyLevel est éventuelle.

Paramètres facultatifs :

• Top: Afficher uniquement les n premiers utilisateurs
• select : liste de propriétés de l’utilisateur à renvoyer, séparées par des virgules
• Filtre : Filtrez les utilisateurs par propriété, tels que startswith(displayName,'A')
• Ordonner par : Classer les résultats par la propriété donnée, telle que displayName
• search : recherche en texte libre pour les utilisateurs. Format : « property :value », par exemple displayName:Neha pour rechercher des noms d’affichage contenant Neha. Prend en charge plusieurs propriétés avec des espaces. Règle de secours : si $search échoue ou ne renvoie aucun résultat, réessayer automatiquement avec $filter.
• Compter: Inclure le nombre d’éléments (true ou false)
• ConsistencyLevel : En-tête requis pour les requêtes avancées (valeur par défaut : éventuelle)

Fonctionnalités clés

Connaissance de soi

• Obtenez le profil de l’utilisateur connecté.
• Obtenez le gestionnaire de l’utilisateur connecté.
• Accédez aux informations de contexte utilisateur actuelles.
• Il n’est pas nécessaire d’identifier l’utilisateur.

Profils utilisateur

• Récupérez le profil d’un utilisateur par ID ou UPN.
• Accédez aux propriétés utilisateur telles que displayName, mail, jobTitleet bien plus encore.
• Développez les tables associées telles que manager et directReports.
• Sélectionnez les propriétés à l’aide de $select.

Hiérarchie organisationnelle

• Récupérez le supérieur hiérarchique d’un utilisateur.
• Obtenir les collaborateurs directs d’un utilisateur.
• Parcourez la structure hiérarchique.
• Relations entre le manager et ses collaborateurs directs.

Découverte utilisateur

• Listez les utilisateurs de l’organisation.
• Recherche en texte libre avec basculement automatique.
• Filtrage et classement OData.
• Prise en charge de la pagination.
• Compter les utilisateurs dans les résultats.

Fonctionnalités de requête

• OData $select pour la sélection de propriétés.
• OData $filter pour le filtrage utilisateur.
• OData $expand pour les entités associées.
• OData $orderby pour le tri.
• $search en texte libre avec repli.
• Prise en charge de la cohérence éventuelle.

Remarques

• Utilisez-le mcp_graph_getMyProfile pour l’utilisateur connecté, pas mcp_graph_getUserProfile avec moi.
• Utilisez mcp_graph_getMyManager pour le gestionnaire de l’utilisateur connecté.
• userIdentifier doit être l’identifiant d’objet (GUID) ou userPrincipalName (UPN), n’utilisez pas le nom d’affichage.
• Si seul le nom d’affichage est disponible, utilisez mcp_graph_listUsers pour rechercher d’abord l’utilisateur.
• $expand ne peut développer qu’une seule propriété par requête (manager ou directReports).
• $search bascule automatiquement sur $filter si la recherche échoue.
• ConsistencyLevel éventuellement requis pour les requêtes avancées.
• Format de recherche : « property :value » avec des guillemets.

Cas d’utilisation courants

Obtenir mes informations

• Utilisez-le mcp_graph_getMyProfile pour obtenir le profil de l’utilisateur actuel.
• Utilisez mcp_graph_getMyManager pour obtenir le gestionnaire de l’utilisateur actuel.

Rechercher un utilisateur

• Utilisez mcp_graph_listUsers avec le paramètre de recherche.

  Exemple : search='"displayName:John"' pour rechercher des utilisateurs nommés John.

• Obtenir userPrincipalName ou l’identifiant d’objet à partir des résultats.

Obtenir les détails de l’utilisateur

• utiliser mcp_graph_getUserProfile avec userIdentifier.
• Permet select d’obtenir des propriétés spécifiques.
• À utiliser expand pour inclure manager ou directReports.

Obtenir une structure organisationnelle

• Utilisez mcp_graph_getUsersManager pour obtenir le responsable d’un utilisateur.
• Permet mcp_graph_getDirectReports d’obtenir les rapports directs d’un utilisateur.
• Chaîner les appels pour naviguer dans la hiérarchie de supervision.