Référence du serveur MCP User Profile de Microsoft 365

Vue d’ensemble

Outils disponibles

mcp_graph_getDirectReports

Répertoriez les subordonnés directs d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet de l’utilisateur (GUID), soit son userPrincipalName (UPN de type courrier électronique). N’utilisez pas « moi » comme userIdentifier.

Paramètres obligatoires :

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

Paramètres facultatifs :

• select : liste de propriétés à renvoyer, séparées par des virgules (par exemple : id, displayName, mail, jobTitle, userPrincipalName)
• top : nombre d’éléments à retourner par page

mcp_graph_getMyManager

Récupérer le responsable 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érer 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
• expand : étendre les entités associées (par exemple, manager, directReports)

mcp_graph_getUserProfile

Récupérer le profil d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet de l’utilisateur (GUID), soit son userPrincipalName (UPN de type courrier électronique). N’utilisez pas « moi » comme userIdentifier : utilisez mcp_graph_getMyProfile à la place pour l’utilisateur connecté.

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
• expand : développer une entité associée (manager OU directReports). Vous ne pouvez étendre qu’une seule propriété par requête.

mcp_graph_getUsersManager

Récupérer le responsable d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet de l’utilisateur (GUID), soit son userPrincipalName (UPN de type courrier électronique). N’utilisez pas « moi » comme userIdentifier : utilisez mcp_graph_getMyManager à la place pour l’utilisateur connecté.

Paramètres obligatoires :

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

Paramètres facultatifs :

• select : liste de propriétés du responsable à renvoyer, séparées par des virgules (par exemple : id, displayName, mail, jobTitle, userPrincipalName)

mcp_graph_listUsers

Récupérer une liste d’utilisateurs de l’organisation. Prend en charge les options de requête telles que $select, $filter, $top, $orderby. ConsistencyLevel est défini sur la valeur eventual par défaut.

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
• filter : filtrer les utilisateurs par propriété (par exemple, startswith(displayName,’A’))
• orderby : trie les résultats par la propriété indiquée (par exemple, displayName)
• search : recherche en texte libre pour les utilisateurs. Format : "property:value", par exemple "displayName:Neha" pour rechercher les noms d’affichage contenant Neha. Prend en charge plusieurs propriétés avec des espaces. Règle de repli : si $search échoue ou ne renvoie aucun résultat, réessayer automatiquement avec $filter.
• count : inclure le nombre d’éléments (« true » ou « false »)
• ConsistencyLevel : en-tête requis pour les requêtes avancées (valeur par défaut : « eventual »)

Fonctionnalités clés

Connaissance de soi

• Obtenir le profil de l’utilisateur connecté
• Obtenir le responsable de l’utilisateur connecté
• Accéder aux informations de contexte utilisateur actuelles
• Nul besoin d’identificateurs d’utilisateur

Profils utilisateur

• Récupérer le profil d’un utilisateur par ID ou UPN
• Accéder aux propriétés utilisateur (displayName, mail, jobTitle, etc.)
• Développer les entités associées (manager, directReports)
• Sélection de propriétés avec $select

Hiérarchie organisationnelle

• Obtenir le responsable de l’utilisateur
• Obtenir les subordonnés directs de l’utilisateur
• Naviguer dans la structure hiérarchique
• Relations entre les responsables et les subordonnés directs

Découverte d’utilisateurs

• Répertorier les utilisateurs de l’organisation
• Recherche en texte libre avec solution de repli automatique
• Filtrage et tri 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 solution de repli
• Prise en charge de la cohérence éventuelle

Notes

1. Utiliser mcp_graph_getMyProfile pour l’utilisateur connecté, et non mcp_graph_getUserProfile avec « moi »
2. Utiliser mcp_graph_getMyManager pour le responsable de l’utilisateur connecté
3. userIdentifier doit être l’ID d’objet (GUID) ou userPrincipalName (UPN), et non le nom d’affichage
4. Si seul le nom d’affichage est disponible, utilisez mcp_graph_listUsers pour rechercher l’utilisateur en premier
5. $expand ne peut développer qu’une seule propriété par requête (manager OU directReports)
6. $search applique automatiquement un mécanisme de repli vers $filter si la recherche échoue
7. ConsistencyLevel doit être défini sur « eventual » pour les requêtes avancées
8. Format de recherche : "property:value" avec des guillemets

Cas d’utilisation courants

Obtenir mes informations

• Utiliser mcp_graph_getMyProfile pour obtenir le profil de l’utilisateur actuel
• Utiliser mcp_graph_getMyManager pour obtenir le responsable de l’utilisateur actuel

2. Rechercher un utilisateur

• Utiliser mcp_graph_listUsers avec le paramètre search

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

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

3. Obtenir les détails sur l’utilisateur

• Utiliser mcp_graph_getUserProfile avec userIdentifier
• Utiliser select pour obtenir des propriétés spécifiques
• Utiliser expand pour inclure manager ou directReports

4. Obtenir la structure d’organisation

• Utiliser mcp_graph_getUsersManager pour obtenir le responsable d’un utilisateur
• Utiliser mcp_graph_getDirectReports pour obtenir les subordonnés directs d’un utilisateur
• Enchaîner des appels pour parcourir la hiérarchie de rapports