Referanse for MCP-server for Brukerprofil for Microsoft 365

Viktig!

Du må være en del av frontier-forhåndsvisningsprogrammet for å få tidlig tilgang til Microsoft Agent 365. Frontier kobler deg direkte til Microsofts nyeste ai-innovasjoner. Grenseforhåndsvisninger er underlagt de eksisterende forhåndsvisningsvilkårene i kundeavtalene dine. Ettersom disse funksjonene fremdeles er under utvikling, kan tilgjengeligheten og funksjonene endres over tid.

Oversikt

Server-ID	Display name	Description
mcp_MeServer	McP-server for brukerprofil for Microsoft 365	MCP-server for selvkunnskap og organisatorisk bevissthet. Bruk denne MCP-serveren til å få tilgang til brukerprofiler i organisasjonen og utføre ulike handlinger som å hente profilen din, en brukers profil, en brukers overordnede eller direkte rapporter.

Tilgjengelige verktøy

mcp_graph_getDirectReports

Vis de direkte rapportene til en angitt bruker i katalogen. Du må angi enten brukerens objekt-ID (GUID) eller deres userPrincipalName (e-postlignende UPN). Ikke bruk meg som brukeridentifier.

Påkrevde parametere

• userIdentifier: Brukerens objekt-ID (GUID) eller userPrincipalName (UPN)

Notat

Ikke send meg som userIdentifier. Hvis bare visningsnavn er tilgjengelig, må du først slå opp brukeren for å hente userPrincipalName eller objekt-ID.

Valgfrie parametere

• velg: Kommadelt liste over egenskaper som skal returneres (for eksempel id,displayName,mail,jobTitle,userPrincipalName)
• øverst: Antall elementer som skal returneres per side

mcp_graph_getMyManager

Hent lederen for den påloggede brukeren (anroperen). Dette endepunktet returnerer alltid lederen for gjeldende brukerkontekst.

Valgfrie parametere

• velg: Kommadelt liste over overordnedeegenskaper som skal returneres

mcp_graph_getMyProfile

Hent profildetaljene til den påloggede brukeren (innringeren). Dette endepunktet returnerer alltid profilen til gjeldende brukerkontekst.

Valgfrie parametere

• velg: Kommadelt liste over egenskaper for brukerprofil
• utvid: Utvid relaterte enheter (for eksempel leder, directReports)

mcp_graph_getUserProfile

Hent en angitt brukerprofil i katalogen. Du må angi enten brukerens objekt-ID (GUID) eller deres userPrincipalName (e-postlignende UPN). Ikke bruk «meg» som brukeridentifier – bruk mcp_graph_getMyProfile i stedet for den påloggede brukeren.

Påkrevde parametere

• userIdentifier: Brukerens objekt-ID (GUID) eller userPrincipalName (UPN)

Notat

Ikke send meg. Hvis bare visningsnavn er tilgjengelig, må du først slå opp brukeren.

Valgfrie parametere

• velg: Kommadelt liste over brukeregenskaper som skal returneres
• utvid: Utvid en relatert enhet (leder ELLER directReports). Du kan bare utvide én egenskap per forespørsel.

mcp_graph_getUsersManager

Hent lederen for en angitt bruker i katalogen. Du må angi enten brukerens objekt-ID (GUID) eller deres userPrincipalName (e-postlignende UPN). Ikke bruk «meg» som brukeridentifier – bruk mcp_graph_getMyManager i stedet for den påloggede brukeren.

Påkrevde parametere

• userIdentifier: Brukerens objekt-ID (GUID) eller userPrincipalName (UPN)

Notat

Ikke send meg. Hvis bare visningsnavn er tilgjengelig, må du først slå opp brukeren.

Valgfrie parametere

• velg: Kommadelt liste over egenskaper som skal returneres for den overordnede (for eksempel id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Hent en liste over brukere i organisasjonen. Støtter spørringsalternativer som $select, $filter, $top, $orderby. ConsistencyLevel er satt til eventuell som standard.

Valgfrie parametere

• øverst: Vis bare de første n brukerne
• velg: Kommadelt liste over brukeregenskaper som skal returneres
• filter: Filtrere brukere etter egenskap (f.eks. startswith(displayName,'A'))
• orderby: Ordreresultater etter angitt egenskap (f.eks. displayName)
• søk: Fritekstsøk etter brukere. Format: «egenskap:verdi», for eksempel «displayName:Neha» for å søke etter visningsnavn som inneholder Neha. Støtter flere egenskaper med mellomrom. Tilbakefallsregel: Hvis $search mislykkes eller ikke returnerer noen resultater, prøver du automatisk på nytt med $filter.
• antall: Inkluder antall elementer (sann eller usann)
• ConsistencyLevel: Obligatorisk topptekst for avanserte spørringer (standard: «eventual»)

Nøkkelfunksjoner

Selverkjennelse

• Få pålogget brukerprofil
• Få påloggede brukeres overordnede
• Få tilgang til gjeldende informasjon om brukerkontekst
• Ingen behov for brukeridentifikatorer

Brukerprofil

• Hent en brukers profil med ID eller UPN
• Access-brukeregenskaper (displayName, e-post, jobTitle osv.)
• Utvid relaterte enheter (leder, directReports)
• Egenskapsvalg med $select

Organisasjonshierarki

• Få brukerens overordnede
• Få brukerens direkterapporter
• Naviger rapporteringsstruktur
• Leder- og direkte rapportrelasjoner

Brukeroppdagelse

• Liste over brukere i organisasjonen
• Fritekstsøk med automatisk tilbakefall
• OData-filtrering og -bestilling
• Støtte for paginering
• Telle brukere i resultater

Viktige funksjoner

• OData $select for egenskapsvalg
• OData $filter for brukerfiltrering
• OData $expand for relaterte enheter
• OData $orderby for sortering
• Fritekst $search med tilbakefall
• Eventuell konsekvensstøtte

Notater

1. Bruk mcp_graph_getMyProfile for pålogget bruker, ikke mcp_graph_getUserProfile med «meg»
2. Bruk mcp_graph_getMyManager for pålogget brukerbehandling
3. userIdentifier må være objekt-ID (GUID) eller userPrincipalName (UPN), ikke visningsnavn
4. Hvis bare visningsnavn er tilgjengelig, kan du bruke mcp_graph_listUsers til å slå opp brukeren først
5. $expand kan bare utvide én egenskap per forespørsel (leder ELLER directReports)
6. $search har automatisk tilbakefall til $filter hvis søket mislykkes
7. KonsekvensNivå «eventuelt» kreves for avanserte spørringer
8. Søkeformat: «egenskap:verdi» med anførselstegn

Vanlige brukstilfeller

Få informasjon

• Bruk mcp_graph_getMyProfile for å få gjeldende brukerprofil
• Bruk mcp_graph_getMyManager for å få gjeldende brukers overordnede

2. Finn en bruker

• Bruk mcp_graph_listUsers med søkeparameter

  Eksempel: search='"displayName:John"' for å finne brukere som heter John

• Få userPrincipalName eller objekt-ID fra resultater

3. Få brukerdetaljer

• Bruk mcp_graph_getUserProfile med userIdentifier
• Bruk velg for å hente bestemte egenskaper
• Bruk utvid til å inkludere overordnede eller directReports

Organisasjonsstruktur.

• Bruk mcp_graph_getUsersManager for å få en brukers leder
• Bruk mcp_graph_getDirectReports for å få en brukers direkterapporter
• Kjedekall for å navigere i rapporteringshierarkiet