Del via

MCP-serverreference for Microsoft 365-brugerprofil

Vigtigt

Du skal være en del af Frontier-forhåndsversionsprogrammet for at få tidlig adgang til Microsoft Agent 365. Frontier forbinder dig direkte med Microsofts seneste AI-innovationer. Frontier-forhåndsversioner er underlagt de eksisterende forhåndsversionsbetingelser i dine kundeaftaler. Da disse funktioner stadig er under udvikling, kan deres tilgængelighed og egenskaber ændre sig over tid.

Oversigt

Server-id Vist navn Beskrivelse
mcp_MeServer MCP-server for Microsoft 365-brugerprofil MCP-server til selvforståelse og organisationsbevidsthed. Brug denne MCP-server til at få adgang til brugerprofiler i din organisation og udføre forskellige handlinger, f.eks. hente din profil, en brugers profil, en brugers chef eller direkte underordnede.

Tilgængelige værktøjer

mcp_graph_getDirectReports

Viser de direkte underordnede for en angivet bruger i mappen. Du skal enten angive brugerens objekt-id (GUID) eller brugerens userPrincipalName (maillignende UPN). Brug ikke 'mig' som userIdentifier.

Påkrævede parametre:

  • userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Bemærk

Send ikke 'mig' som userIdentifier. Hvis kun vist navn er tilgængeligt, skal du først slå brugeren op for at hente userPrincipalName eller objekt-id.

Valgfrie parametre:

  • vælg: Kommasepareret liste over egenskaber, der skal returneres (f.eks. id,displayName,mail,jobTitle,userPrincipalName)
  • top: Antal elementer, der skal returneres pr. side

mcp_graph_getMyManager

Hent lederen for den bruger, der er logget på (kalderen). Dette slutpunkt returnerer altid lederen for den aktuelle brugerkontekst.

Valgfrie parametre:

  • select: Kommasepareret liste over lederegenskaber, der skal returneres

mcp_graph_getMyProfile

Hent profiloplysninger for den bruger, der er logget på (kalderen). Dette slutpunkt returnerer altid profilen for den aktuelle brugerkontekst.

Valgfrie parametre:

  • vælg: Kommasepareret liste over brugerprofilegenskaber
  • udvid: Udvid relaterede objekter (f.eks. chef, directReports)

mcp_graph_getUserProfile

Hent en angivet brugers profil i mappen. Du skal enten angive brugerens objekt-id (GUID) eller brugerens userPrincipalName (maillignende UPN). Brug ikke 'mig' som userIdentifier – brug mcp_graph_getMyProfile i stedet for den bruger, der er logget på.

Påkrævede parametre:

  • userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Bemærk

Send ikke 'mig'. Hvis kun vist navn er tilgængeligt, skal du først slå brugeren op.

Valgfrie parametre:

  • select: Kommasepareret liste over brugeregenskaber, der skal returneres
  • udvid: Udvid et relateret objekt (leder ELLER directReports). Du kan kun udvide én egenskab pr. anmodning.

mcp_graph_getUsersManager

Hent lederen for en angivet bruger i mappen. Du skal enten angive brugerens objekt-id (GUID) eller brugerens userPrincipalName (maillignende UPN). Brug ikke 'mig' som userIdentifier – brug mcp_graph_getMyManager i stedet for den bruger, der er logget på.

Påkrævede parametre:

  • userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Bemærk

Send ikke 'mig'. Hvis kun vist navn er tilgængeligt, skal du først slå brugeren op.

Valgfrie parametre:

  • vælg: Kommasepareret liste over egenskaber, der skal returneres for lederen (f.eks. id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Hent liste over brugere i en organisation. Understøtter forespørgselsindstillinger som $select, $filter, $top, $orderby. ConsistencyLevel er som standard angivet til endelig.

Valgfrie parametre:

  • top: Vis kun de første n brugere
  • select: Kommasepareret liste over brugeregenskaber, der skal returneres
  • filter: Filtrer brugere efter egenskab (f.eks. startswith(displayName,'A'))
  • orderby: Sortér resultater efter en given egenskab (f.eks. displayName)
  • søg Fritekstsøgning for brugere. Format: '"property:value"', f.eks. '"displayName:Neha"' for at søge efter viste navne, der indeholder 'Neha'. Understøtter flere egenskaber med mellemrum. Fallback-regel: Hvis $search mislykkes eller ikke returnerer nogen resultater, skal du automatisk prøve igen med $filter.
  • antal: Medtag antallet af elementer ('true' eller 'false')
  • ConsistencyLevel: Påkrævet overskrift til avancerede forespørgsler (standard: 'endelig')

Nøglefunktioner

Selverkendelse

  • Hent profil for bruger, der er logget på
  • Hent leder for bruger, der er logget på
  • Få adgang til kontekstoplysninger for aktuelle bruger
  • Der er ikke behov for bruger-id'er

Brugerprofiler

  • Hent en brugers profil efter id eller UPN
  • Få adgang til brugeregenskaber (displayName, mail, jobTitle osv.)
  • Udvid relaterede objekter (leder, directReports)
  • Valg af egenskab med $select

Organisationshierarki

  • Hent brugerens leder
  • Hent brugerens direkte underordnede
  • Naviger i rapporteringsstruktur
  • Relationer til leder og direkte underordnede

Brugerregistrering

  • Vis brugere i organisationen
  • Fritekstsøgning med automatisk fallback
  • OData-filtrering og -sortering
  • Understøttelse af sideinddeling
  • Antal brugere i resultater

Forespørgselsfunktioner

  • OData-$select til valg af egenskab
  • OData-$filter til brugerfiltrering
  • OData-$expand for relaterede objekter
  • OData-$orderby til sortering
  • Fritekst-$search med automatisk fallback
  • Endelig overensstemmelsesunderstøttelse

Bemærkninger

  1. Brug mcp_graph_getMyProfile til bruger, der er logget på, og ikke mcp_graph_getUserProfile med 'mig'
  2. Brug mcp_graph_getMyManager til leder for bruger, der er logget på
  3. userIdentifier skal være objekt-id (GUID) eller userPrincipalName (UPN), ikke vist navn
  4. Hvis kun vist navn er tilgængeligt, skal du bruge mcp_graph_listUsers til først at slå brugeren op
  5. $expand kan kun udvide én egenskab pr. anmodning (leder ELLER directReports)
  6. $search har automatisk fallback til $filter, hvis søgningen mislykkes
  7. ConsistencyLevel 'eventual' kræves til avancerede forespørgsler
  8. Søgeformat: '"property:value"' med anførselstegn

Almindelige use cases

Hent Mine oplysninger

  • Brug mcp_graph_getMyProfile til at hente den aktuelle brugers profil
  • Brug mcp_graph_getMyManager til at hente den aktuelle brugers leder

2. Find en bruger

  • Brug mcp_graph_listUsers sammen med søgeparameteren

    Eksempel: search='"displayName:John"' for at finde brugere med navnet John

  • Hent userPrincipalName eller objekt-id fra resultater

3. Hent brugeroplysninger

  • Brug mcp_graph_getUserProfile med userIdentifier
  • Brug vælg til at hente bestemte egenskaber
  • Brug udvid til at inkludere leder eller directReports

4. Hent organisationsstruktur

  • Brug mcp_graph_getUsersManager til at hente en brugers leder
  • Brug mcp_graph_getDirectReports til at hente en brugers direkte underordnede
  • Kædekald for at navigere i rapporteringshierarkiet
  • Last updated on