Dokumentacja serwera MCP profilu użytkownika platformy Microsoft 365

Ważne

Aby uzyskać wczesny dostęp do programu Microsoft Agent 365, musisz być częścią programu Frontier w wersji zapoznawczej. Usługa Frontier łączy Cię bezpośrednio z najnowszymi innowacjami firmy Microsoft dotyczącymi sztucznej inteligencji. Wersje zapoznawcze platformy Frontier podlegają istniejącym warunkom obowiązywania wersji zapoznawczej umów klienta. Ponieważ te funkcje są nadal opracowywane, ich dostępność i możliwości mogą ulec zmianie w miarę upływu czasu.

Omówienie

Identyfikator serwera	Display name	Podpis
mcp_MeServer	Serwer MCP profilu użytkownika platformy Microsoft 365	Serwer MCP na potrzeby samodzielnej wiedzy i świadomości organizacyjnej. Ten serwer MCP służy do uzyskiwania dostępu do profilów użytkowników w organizacji i wykonywania różnych akcji, takich jak pobieranie profilu, profil użytkownika, menedżer użytkownika lub bezpośrednie raporty.

Dostępne narzędzia

mcp_graph_getDirectReports

Wyświetl listę bezpośrednich raportów określonego użytkownika w katalogu. Musisz podać identyfikator obiektu użytkownika (GUID) lub jego userPrincipalName (nazwa UPN podobna do adresu e-mail). Nie używaj nazwy "me" jako userIdentifier.

Parametry wymagane

• userIdentifier: identyfikator obiektu użytkownika (GUID) lub userPrincipalName (UPN)

Notatka

Nie wysyłaj "mnie" jako userIdentifier. Jeśli dostępna jest tylko nazwa wyświetlana, najpierw wyszukaj użytkownika, aby uzyskać nazwę userPrincipalName lub identyfikator obiektu.

Parametry opcjonalne

• select: rozdzielona przecinkami lista właściwości do zwrócenia (na przykład id,displayName,mail,jobTitle,userPrincipalName)
• top: liczba elementów, które mają być zwracane na stronę

mcp_graph_getMyManager

Pobierz menedżera zalogowanego użytkownika (wywołującego). Ten punkt końcowy zawsze zwraca menedżera bieżącego kontekstu użytkownika.

Parametry opcjonalne

• select: Rozdzielona przecinkami lista właściwości menedżera do zwrócenia

mcp_graph_getMyProfile

Pobierz szczegóły profilu zalogowanego użytkownika (wywołującego). Ten punkt końcowy zawsze zwraca profil bieżącego kontekstu użytkownika.

Parametry opcjonalne

• select: Rozdzielona przecinkami lista właściwości profilu użytkownika
• rozwiń: Rozwiń powiązane jednostki (na przykład menedżer, directReports)

mcp_graph_getUserProfile

Pobierz profil określonego użytkownika w katalogu. Musisz podać identyfikator obiektu użytkownika (GUID) lub jego userPrincipalName (nazwa UPN podobna do adresu e-mail). Nie używaj ciągu "me" jako userIdentifier — użyj mcp_graph_getMyProfile zamiast tego dla zalogowanego użytkownika.

Parametry wymagane

• userIdentifier: identyfikator obiektu użytkownika (GUID) lub userPrincipalName (UPN)

Notatka

Nie wysyłaj "mnie". Jeśli dostępna jest tylko nazwa wyświetlana, najpierw wyszukaj użytkownika.

Parametry opcjonalne

• select: Rozdzielona przecinkami lista właściwości użytkownika do zwrócenia
• rozwiń: rozwiń powiązaną jednostkę (menedżer LUB directReports). Można rozwinąć tylko jedną właściwość na żądanie.

mcp_graph_getUsersManager

Pobierz menedżera określonego użytkownika w katalogu. Musisz podać identyfikator obiektu użytkownika (GUID) lub jego userPrincipalName (nazwa UPN podobna do adresu e-mail). Nie używaj ciągu "me" jako userIdentifier — użyj mcp_graph_getMyManager zamiast tego dla zalogowanego użytkownika.

Parametry wymagane

• userIdentifier: identyfikator obiektu użytkownika (GUID) lub userPrincipalName (UPN)

Notatka

Nie wysyłaj "mnie". Jeśli dostępna jest tylko nazwa wyświetlana, najpierw wyszukaj użytkownika.

Parametry opcjonalne

• select: rozdzielona przecinkami lista właściwości, które mają być zwracane dla menedżera (np. id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Pobieranie listy użytkowników w organizacji. Obsługuje opcje zapytań, takie jak $select, $filter, $top, $orderby. Wartość ConsistencyLevel jest domyślnie ustawiona na ostateczną.

Parametry opcjonalne

• top: Pokaż tylko pierwszych n użytkowników
• select: Rozdzielona przecinkami lista właściwości użytkownika do zwrócenia
• filter: Filtruj użytkowników według właściwości (np. startswith(displayName,'A'))
• orderby: Order results by given property (np. displayName)
• wyszukiwanie: wyszukiwanie w tekście swobodnym dla użytkowników. Format: "property:value", np. "displayName:Neha", aby wyszukać nazwy wyświetlane zawierające ciąg "Neha". Obsługuje wiele właściwości ze spacjami. Reguła rezerwowa: jeśli $search zakończy się niepowodzeniem lub nie zwróci żadnych wyników, spróbuj ponownie z $filter.
• count: uwzględnij liczbę elementów ('true' lub 'false')
• ConsistencyLevel: wymagany nagłówek dla zapytań zaawansowanych (wartość domyślna: "ostateczna")

Kluczowe cechy i funkcje

Samowiedzy

• Uzyskiwanie profilu zalogowanych użytkowników
• Uzyskiwanie menedżera zalogowanych użytkowników
• Uzyskiwanie dostępu do bieżących informacji kontekstowych użytkownika
• Brak potrzeby identyfikatorów użytkowników

Profil użytkownika

• Pobieranie profilu użytkownika według identyfikatora lub nazwy UPN
• Uzyskiwanie dostępu do właściwości użytkownika (displayName, mail, jobTitle itp.)
• Rozwiń powiązane jednostki (menedżer, directReports)
• Wybór właściwości z $select

Hierarchia organizacyjna

• Wyświetl menedżera użytkownika.
• Pobieranie bezpośrednich raportów użytkownika
• Nawigowanie po strukturze raportowania
• Relacje menedżerów i raportów bezpośrednich

Odnajdywanie użytkowników

• Wyświetlanie listy użytkowników w organizacji
• Wyszukiwanie bez tekstu z automatycznym rezerwowym
• Filtrowanie i porządkowanie danych OData
• Pomoc techniczna obsługi stronicowania
• Liczba użytkowników w wynikach

Możliwości użytkownika

• $select OData dla wyboru właściwości
• $filter OData na potrzeby filtrowania użytkowników
• $expand OData dla powiązanych jednostek
• $orderby OData na potrzeby sortowania
• $search bez tekstu z rezerwowym
• Obsługa spójności ostatecznej

Uwagi

1. Użyj mcp_graph_getMyProfile dla zalogowanego użytkownika, a nie mcp_graph_getUserProfile z użytkownikiem "me"
2. Używanie mcp_graph_getMyManager dla menedżera zalogowanych użytkowników
3. userIdentifier musi być identyfikatorem obiektu (GUID) lub userPrincipalName (UPN), a nie nazwą wyświetlaną
4. Jeśli dostępna jest tylko nazwa wyświetlana, użyj mcp_graph_listUsers, aby najpierw wyszukać użytkownika
5. $expand może rozwinąć tylko jedną właściwość na żądanie (menedżer LUB directReports)
6. $search ma automatyczny powrót do $filter w przypadku niepowodzenia wyszukiwania
7. ConsistencyLevel "ostateczna" wymagana dla zapytań zaawansowanych
8. Format wyszukiwania: "property:value" z cudzysłowami

Typowe przypadki użycia

Uzyskiwanie informacji

• Uzyskiwanie profilu bieżącego użytkownika przy użyciu mcp_graph_getMyProfile
• Uzyskiwanie menedżera bieżącego użytkownika przy użyciu mcp_graph_getMyManager

2. Znajdowanie użytkownika

• Używanie mcp_graph_listUsers z parametrem wyszukiwania

  Przykład: search='"displayName:John"' w celu znalezienia użytkowników o nazwie John

• Pobieranie parametru userPrincipalName lub identyfikatora obiektu z wyników

3. Pobieranie szczegółów użytkownika

• Używanie mcp_graph_getUserProfile z identyfikatorem userIdentifier
• Wybierz pozycję Właściwości, aby uzyskać szczegółowe informacje.
• Użyj rozszerzenia , aby uwzględnić menedżer lub directReports

Struktura organizacyjna.

• Uzyskiwanie menedżera użytkownika przy użyciu mcp_graph_getUsersManager
• Uzyskiwanie bezpośrednich raportów użytkownika za pomocą mcp_graph_getDirectReports
• Łączenie wywołań łańcucha w celu nawigowania po hierarchii raportowania