McP-serverreferens för Microsoft 365-användarprofil

Viktigt

Du måste vara en del av förhandsversionen av Frontier för att få tidig åtkomst till Microsoft Agent 365. Frontier ansluter dig direkt till Microsofts senaste AI-innovationer. Förhandsversioner av Gräns omfattas av de befintliga förhandsversionsvillkoren för dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och funktioner ändras över tid.

Översikt

Server-ID	Visningsnamn	Description
mcp_MeServer	Microsoft 365 MCP-server för användarprofiler	MCP-server för självkännedom och organisationsmedvetenhet. Använd den här MCP-servern för att komma åt användarprofiler i din organisation och utföra olika åtgärder, till exempel att hämta din profil, en användares profil, en användarhanterare eller direktrapporter.

Tillgängliga verktyg

mcp_graph_getDirectReports

Visa en lista över direktrapporter för en angiven användare i katalogen. Du måste ange antingen användarens objekt-ID (GUID) eller deras userPrincipalName (e-postliknande UPN). Använd inte "me" som userIdentifier.

Obligatoriska parametrar

• userIdentifier: Användarens objekt-ID (GUID) eller userPrincipalName (UPN)

Obs

Skicka inte "mig" som userIdentifier. Om endast visningsnamnet är tillgängligt letar du först upp användaren för att hämta userPrincipalName eller objekt-ID.

Valfria parametrar

• select: Kommaavgränsad lista över egenskaper som ska returneras (till exempel id,displayName,mail,jobTitle,userPrincipalName)
• överst: Antal objekt som ska returneras per sida

mcp_graph_getMyManager

Hämta chefen för den inloggade användaren (anroparen). Den här slutpunkten returnerar alltid chefen för den aktuella användarkontexten.

Valfria parametrar

• select: Kommaavgränsad lista över chefsegenskaper som ska returneras

mcp_graph_getMyProfile

Hämta profilinformationen för den inloggade användaren (anroparen). Den här slutpunkten returnerar alltid profilen för den aktuella användarkontexten.

Valfria parametrar

• select: Kommaavgränsad lista över egenskaper för användarprofil
• expandera: Expandera relaterade entiteter (till exempel chef, directReports)

mcp_graph_getUserProfile

Hämta en angiven användares profil i katalogen. Du måste ange antingen användarens objekt-ID (GUID) eller deras userPrincipalName (e-postliknande UPN). Använd inte "mig" som userIdentifier – använd mcp_graph_getMyProfile i stället för den inloggade användaren.

Obligatoriska parametrar

• userIdentifier: Användarens objekt-ID (GUID) eller userPrincipalName (UPN)

Obs

Skicka inte "mig". Om endast visningsnamnet är tillgängligt letar du först upp användaren.

Valfria parametrar

• select: Kommaavgränsad lista över användaregenskaper som ska returneras
• expandera: Expandera en relaterad entitet (chef ELLER directReports). Du kan bara expandera en egenskap per begäran.

mcp_graph_getUsersManager

Hämta chefen för en angiven användare i katalogen. Du måste ange antingen användarens objekt-ID (GUID) eller deras userPrincipalName (e-postliknande UPN). Använd inte "mig" som userIdentifier – använd mcp_graph_getMyManager i stället för den inloggade användaren.

Obligatoriska parametrar

• userIdentifier: Användarens objekt-ID (GUID) eller userPrincipalName (UPN)

Obs

Skicka inte "mig". Om endast visningsnamnet är tillgängligt letar du först upp användaren.

Valfria parametrar

• select: Kommaavgränsad lista över egenskaper som ska returneras för chefen (t.ex. id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Hämta en lista över användare i organisationen. Stöder frågealternativ som $select, $filter, $top $orderby. ConsistencyLevel är inställt på slutlig som standard.

Valfria parametrar

• överst: Visa endast de första n användarna
• select: Kommaavgränsad lista över användaregenskaper som ska returneras
• filter: Filtrera användare efter egenskap (t.ex. startswith(displayName,'A'))
• orderby: Orderresultat efter angiven egenskap (t.ex. displayName)
• sök: Sök i fritext efter användare. Format: "property:value", t.ex. "displayName:Neha" för att söka efter visningsnamn som innehåller "Neha". Stöder flera egenskaper med blanksteg. Reservregel: Om $search misslyckas eller inte returnerar några resultat försöker du automatiskt igen med $filter.
• count: Include count of items ('true' or 'false')
• ConsistencyLevel: Obligatoriskt huvud för avancerade frågor (standard: "eventual")

Viktiga funktioner

Självkännedom

• Hämta inloggningsanvändarens profil
• Hämta den inloggade användarens chef
• Få åtkomst till aktuell användarkontextinformation
• Inget behov av användaridentifierare

Användarprofil

• Hämta en användares profil med ID eller UPN
• Åtkomst till användaregenskaper (displayName, e-post, jobTitle osv.)
• Expandera relaterade entiteter (chef, directReports)
• Egenskapsval med $select

Organisationshierarki

• Hämta användarens chef
• Hämta användarens direktrapporter
• Navigera i rapporteringsstruktur
• Relationer mellan chef och direktrapport

Användaridentifiering

• Lista användare i organisationen
• Fritextsökning med automatisk återställning
• OData-filtrering och -ordning
• Sidnumreringssupport
• Räkna användare i resultat

Viktiga funktioner

• OData-$select för egenskapsval
• OData-$filter för användarfiltrering
• OData-$expand för relaterade entiteter
• OData-$orderby för sortering
• Fritext $search med reserv
• Stöd för slutlig konsekvens

Anteckningar

1. Använd mcp_graph_getMyProfile för inloggad användare, inte mcp_graph_getUserProfile med "mig"
2. Använda mcp_graph_getMyManager för inloggad användares chef
3. userIdentifier måste vara objekt-ID (GUID) eller userPrincipalName (UPN), inte visningsnamn
4. Om endast visningsnamnet är tillgängligt använder du mcp_graph_listUsers för att leta upp användaren först
5. $expand kan bara expandera en egenskap per begäran (chef eller directReports)
6. $search har automatisk återställning till $filter om sökningen misslyckas
7. ConsistencyLevel "slutlig" krävs för avancerade frågor
8. Sökformat: "property:value" med citattecken

Vanliga användningsfall

Hämta information

• Använd mcp_graph_getMyProfile för att hämta den aktuella användarens profil
• Använd mcp_graph_getMyManager för att hämta den aktuella användarens chef

2. Hitta en användare

• Använda mcp_graph_listUsers med sökparameter

  Exempel: search='"displayName:John"' för att hitta användare med namnet John

• Hämta userPrincipalName eller objekt-ID från resultat

3. Hämta användarinformation

• Använda mcp_graph_getUserProfile med userIdentifier
• Välj Egenskaper om vill visa detaljerad information.
• Använd expandera för att inkludera chef eller directReports

Organisationsstruktur.

• Använd mcp_graph_getUsersManager för att hämta en användares chef
• Använd mcp_graph_getDirectReports för att hämta en användares direktrapporter
• Kedja anrop för att navigera i rapporthierarkin