Partager via

Guide d'utilisation Work IQ (préversion)

Important

  • Il s’agit d’une fonctionnalité en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Vue d’ensemble

ID du serveur Nom d’affichage Description
mcp_MeServer Utilisateur Work IQ Serveur MCP pour la connaissance de soi et la connaissance de l’organisation. Utilisez ce serveur MCP pour accéder aux profils utilisateur de votre organisation et effectuer diverses actions telles que d'obtenir votre profil, le profil d'un utilisateur, le gestionnaire d'un utilisateur ou ses rapports directs.

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 (GUID) de l’utilisateur, soit leur userPrincipalName UPN (de type email). N’utilisez pas « moi » comme le userIdentifier.

Paramètres obligatoires :

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

Note

N’envoyez pas 'moi' comme userIdentifier. Si seul le nom d’affichage est disponible, recherchez d’abord l’utilisateur pour obtenir userPrincipalName, ou l’identifiant de l’objet.

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é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
  • Étendre : Développer les tables 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 (GUID) de l’utilisateur, soit leur userPrincipalName UPN (de type email). N'utilisez pas « moi » comme userIdentifier - utilisez plutôt mcp_graph_getMyProfile pour l'utilisateur connecté.

Paramètres obligatoires :

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

Note

Ne m’envoyez pas. Si le nom d'affichage seul est disponible, commencez par rechercher l'utilisateur.

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érer le responsable 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 « moi » comme userIdentifier - utilisez plutôt mcp_graph_getMyManager pour l'utilisateur connecté.

Paramètres obligatoires :

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

Note

Ne m’envoyez pas. Si le nom d'affichage seul est disponible, commencez par rechercher l'utilisateur.

Paramètres facultatifs :

  • Sélectionner : Liste des propriétés à retourner pour le gestionnaire séparées par virgule, telles que 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 réglé par défaut sur é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, effectuez automatiquement une nouvelle tentative 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

  • Obtenir le profil de l’utilisateur connecté
  • Obtenir le responsable de l’utilisateur connecté
  • Accéder à l'information actuelle sur le contexte de l'utilisateur
  • Nul besoin d’identificateurs d’utilisateur

Profils utilisateur

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

Hiérarchie organisationnelle

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

Découverte utilisateur

  • Répertorier les utilisateurs de l’organisation
  • Recherche en texte libre avec solution de repli automatique
  • Filtrage et tri de données OData
  • Prise en charge de la pagination
  • Compter les utilisateurs dans les résultats

Interrogation des données par 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

  • Utiliser mcp_graph_getMyProfile pour l’utilisateur connecté, pas mcp_graph_getUserProfile avec moi
  • Utilisation mcp_graph_getMyManager du gestionnaire d’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 l’utilisateur en premier.
  • $expand ne peut développer qu’une seule propriété par requête (manager ou directReports)
  • $search bascule automatiquement vers $filter si la recherche échoue
  • ConsistencyLevel éventuellement requise pour les requêtes avancées
  • 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
  • Utilisation 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 identifier un 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 étendre pour inclure manager ou directReports

4. Obtenir la structure d’organisation

  • Utilisation mcp_graph_getUsersManager pour obtenir un gestionnaire d’utilisateurs
  • Utilisez mcp_graph_getDirectReports pour obtenir les rapports directs d’un utilisateur
  • Enchaîner des appels pour parcourir la hiérarchie de rapports
  • Last updated on