Αναφορά microsoft 365 User Profile MCP Server

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Επισκόπηση

Αναγνωριστικό διακομιστή	Εμφανιζόμενο όνομα	Περιγραφή
mcp_MeServer	Microsoft 365 User Profile MCP Server	Διακομιστής MCP για αυτογνωσία και επίγνωση οργανισμού. Χρησιμοποιήστε αυτόν τον διακομιστή MCP για να αποκτήσετε πρόσβαση σε προφίλ χρηστών στον οργανισμό σας και να εκτελέσετε διάφορες ενέργειες όπως η λήψη του προφίλ σας, του προφίλ ενός χρήστη, του διευθυντή ενός χρήστη ή των άμεσων αναφορών.

Διαθέσιμα εργαλεία

mcp_graph_getDirectReports

Παρατίθενται οι άμεσες αναφορές ενός καθορισμένου χρήστη στον κατάλογο. Πρέπει να καταχωρήσετε είτε το αναγνωριστικό αντικειμένου του χρήστη (GUID) είτε τον χρήστηPrincipalName (upn που μοιάζει με διεύθυνση ηλεκτρονικού ταχυδρομείου). Μην χρησιμοποιείτε το "me" ως το userIdentifier.

Απαιτούμενες παράμετροι

• userIdentifier: Αναγνωριστικό αντικειμένου χρήστη (GUID) ή userPrincipalName (UPN)

Σημείωμα

Μην στέλνετε το "me" ως userIdentifier. Εάν υπάρχει μόνο εμφανιζόμενο όνομα, αναζητήστε πρώτα τον χρήστη για να λάβετε το userPrincipalName ή το αναγνωριστικό αντικειμένου.

Προαιρετικές παράμετροι

• select: Λίστα ιδιοτήτων διαχωρισμένων με κόμματα για επιστροφή (για παράδειγμα, id, displayName, mail,jobTitle,userPrincipalName)
• top: Αριθμός στοιχείων που θα επιστραφούν ανά σελίδα

mcp_graph_getMyManager

Ανακτήστε τον προϊστάμενο του συνδεδεμένου χρήστη (τον καλούντα). Αυτό το τελικό σημείο επιστρέφει πάντα τον διευθυντή του τρέχοντος περιβάλλοντος χρήστη.

Προαιρετικές παράμετροι

• select: Λίστα ιδιοτήτων διευθυντή διαχωρισμένων με κόμματα για επιστροφή

mcp_graph_getMyProfile

Ανακτήστε τις λεπτομέρειες προφίλ του συνδεδεμένου χρήστη (του καλούντε). Αυτό το τελικό σημείο επιστρέφει πάντα το προφίλ του τρέχοντος περιβάλλοντος χρήστη.

Προαιρετικές παράμετροι

• select: Λίστα διαχωρισμένων με κόμματα ιδιοτήτων προφίλ χρήστη
• expand: Ανάπτυξη σχετικών οντοτήτων (για παράδειγμα, manager, directReports)

mcp_graph_getUserProfile

Ανακτήστε το προφίλ ενός καθορισμένου χρήστη στον κατάλογο. Πρέπει να καταχωρήσετε είτε το αναγνωριστικό αντικειμένου του χρήστη (GUID) είτε τον χρήστηPrincipalName (upn που μοιάζει με διεύθυνση ηλεκτρονικού ταχυδρομείου). Μην χρησιμοποιείτε το "me" ως αναγνωριστικό χρήστη - χρησιμοποιήστε mcp_graph_getMyProfile αντί για τον συνδεδεμένο χρήστη.

Απαιτούμενες παράμετροι

• userIdentifier: Αναγνωριστικό αντικειμένου χρήστη (GUID) ή userPrincipalName (UPN)

Σημείωμα

Μην στέλνεις "εμένα". Εάν υπάρχει μόνο εμφανιζόμενο όνομα, αναζητήστε πρώτα τον χρήστη.

Προαιρετικές παράμετροι

• select: Λίστα ιδιοτήτων χρήστη διαχωρισμένων με κόμματα για επιστροφή
• expand: Αναπτύξτε μια σχετική οντότητα (διαχείριση Ή directReports). Μπορείτε να αναπτύξετε μόνο μία ιδιότητα ανά αίτηση.

mcp_graph_getUsersManager

Ανακτήστε τον διευθυντή ενός καθορισμένου χρήστη στον κατάλογο. Πρέπει να καταχωρήσετε είτε το αναγνωριστικό αντικειμένου του χρήστη (GUID) είτε τον χρήστηPrincipalName (upn που μοιάζει με διεύθυνση ηλεκτρονικού ταχυδρομείου). Μην χρησιμοποιείτε το "me" ως αναγνωριστικό χρήστη - χρησιμοποιήστε mcp_graph_getMyManager αντί για τον συνδεδεμένο χρήστη.

Απαιτούμενες παράμετροι

• userIdentifier: Αναγνωριστικό αντικειμένου χρήστη (GUID) ή userPrincipalName (UPN)

Σημείωμα

Μην στέλνεις "εμένα". Εάν υπάρχει μόνο εμφανιζόμενο όνομα, αναζητήστε πρώτα τον χρήστη.

Προαιρετικές παράμετροι

• select: Λίστα ιδιοτήτων διαχωρισμένων με κόμματα για επιστροφή για τον διευθυντή (π.χ. id, displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Ανάκτηση μιας λίστας χρηστών στον οργανισμό. Υποστηρίζει επιλογές ερωτημάτων όπως $select, $filter, $top $orderby. Το ConsistencyLevel ορίζεται σε παρεπόμενη από προεπιλογή.

Προαιρετικές παράμετροι

• top: Εμφάνιση μόνο των πρώτων n χρηστών
• select: Λίστα ιδιοτήτων χρήστη διαχωρισμένων με κόμματα για επιστροφή
• filter: Φιλτράρισμα χρηστών κατά ιδιότητα (π.χ. startswith(displayName,'A'))
• orderby: Order results by given property (π.χ. displayName)
• search: Αναζήτηση ελεύθερου κειμένου για χρήστες. Μορφή: '"property:value"', π.χ., '"displayName:Neha"' για αναζήτηση εμφανιζόμενων ονομάτων που περιέχουν 'Neha'. Υποστηρίζει πολλές ιδιότητες με κενά διαστήματα. Εναλλακτικός κανόνας: Εάν αποτύχει η $search ή δεν επιστρέψει κανένα αποτέλεσμα, δοκιμάστε ξανά αυτόματα με $filter.
• count: Include count of items ('true' ή 'false')
• ConsistencyLevel: Απαιτούμενη κεφαλίδα για σύνθετα ερωτήματα (προεπιλογή: "τελικό")

Δυνατότητες κλειδιά

Αυτογνωσία

• Λήψη προφίλ συνδεδεμένου χρήστη
• Λήψη υπεύθυνου συνδεδεμένου χρήστη
• Πρόσβαση στις τρέχουσες πληροφορίες περιβάλλοντος χρήστη
• Δεν απαιτείται αναγνωριστικό χρήστη

Προφίλ χρήστη

• Ανάκτηση προφίλ οποιουδήποτε χρήστη κατά αναγνωριστικό ή UPN
• Πρόσβαση στις ιδιότητες χρήστη (displayName, mail, jobTitle κ.λπ.)
• Ανάπτυξη σχετικών οντοτήτων (διαχείριση, directReports)
• Επιλογή ιδιότητας με $select

Οργανική ιεραρχία

• Λήψη του προϊσταμενού του χρήστη
• Λήψη των άμεσων αναφορών του χρήστη
• Περιήγηση στη δομή αναφορών
• Σχέσεις διαχείρισης και άμεσης αναφοράς

Εντοπισμός χρήστη

• Λίστα χρηστών στον οργανισμό
• Αναζήτηση ελεύθερου κειμένου με αυτόματη επιστροφή
• Φιλτράρισμα και ταξινόμηση δεδομένων OData
• Υποστήριξη σελιδοποίησης
• Πλήθος χρηστών στα αποτελέσματα

Βασικές δυνατότητες

• $select OData για την επιλογή ιδιότητας
• $filter OData για φιλτράρισμα χρηστών
• $expand OData για σχετικές οντότητες
• $orderby OData για ταξινόμηση
• $search ελεύθερου κειμένου με επιστροφή
• Υποστήριξη τελικής συνέπειας

Σημειώσεις

1. Χρήση mcp_graph_getMyProfile για συνδεδεμένο χρήστη, όχι για mcp_graph_getUserProfile με "εμένα"
2. Χρήση mcp_graph_getMyManager για τον υπεύθυνο χρήστη που έχει εισέλθει
3. Το userIdentifier πρέπει να είναι αναγνωριστικό αντικειμένου (GUID) ή userPrincipalName (UPN), όχι εμφανιζόμενο όνομα
4. Εάν υπάρχει μόνο εμφανιζόμενο όνομα, χρησιμοποιήστε mcp_graph_listUsers για να αναζητήσετε πρώτα τον χρήστη
5. $expand μπορούν να επεκτείνουν μόνο μία ιδιότητα ανά αίτηση (διαχείριση Ή directReports)
6. Η $search έχει αυτόματη επιστροφή σε $filter εάν αποτύχει η αναζήτηση
7. Το "eventual" consistencyLevel απαιτείται για σύνθετα ερωτήματα
8. Μορφή αναζήτησης: '"property:value"' με εισαγωγικά

Υποθέσεις συνήθους χρήσης

Λήψη πληροφοριών

• Χρήση mcp_graph_getMyProfile για τη λήψη του προφίλ τρέχοντος χρήστη
• Χρήση mcp_graph_getMyManager για λήψη του διευθυντή του τρέχοντος χρήστη

2. Εύρεση χρήστη

• Χρήση mcp_graph_listUsers με την παράμετρο αναζήτησης

  Παράδειγμα: search='"displayName:John"' για να βρείτε χρήστες με το όνομα John

• Λήψη του userPrincipalName ή του αναγνωριστικού αντικειμένου από τα αποτελέσματα

3. Λήψη λεπτομερειών χρήστη

• Χρήση mcp_graph_getUserProfile με το userIdentifier
• Χρήση επιλογής για λήψη συγκεκριμένων ιδιοτήτων
• Χρήση ανάπτυξης για συμπερίληψη διευθυντή ή directReports

4. Λήψη οργανωτικής δομής

• Χρήση mcp_graph_getUsersManager για λήψη του προϊσταμενού ενός χρήστη
• Χρήση mcp_graph_getDirectReports για τη λήψη άμεσων αναφορών ενός χρήστη
• Κλήσεις αλυσίδας για περιήγηση στην ιεραρχία αναφορών