Delen via

Naslaginformatie voor MCP-server voor Microsoft 365-gebruikersprofiel

Belangrijk

U moet deelnemen aan het preview-programma Frontier om vroegtijdige toegang te krijgen tot Microsoft Agent 365. Frontier verbindt u rechtstreeks met de nieuwste AI-innovaties van Microsoft. Op Frontier-previews zijn de bestaande preview-voorwaarden van uw klantovereenkomsten van toepassing. Omdat deze functies nog in ontwikkeling zijn, kunnen de beschikbaarheid en mogelijkheden hiervan na verloop van tijd veranderen.

Overzicht

Server ID Weergavenaam Omschrijving
mcp_MeServer MCP-server voor Microsoft 365-gebruikersprofiel MCP-server voor zelfkennis en bewustzijn binnen de organisatie. Gebruik deze MCP-server om toegang tot gebruikersprofielen in uw organisatie te krijgen en voer verschillende acties uit, zoals het ophalen van uw profiel, het profiel van een gebruiker, de manager van een gebruiker of directe ondergeschikten.

Beschikbare hulpmiddelen

mcp_graph_getDirectReports

Hiermee worden de directe ondergeschikten van een opgegeven gebruiker in de directory weergeven. U moet de object-id (GUID) van de gebruiker of de userPrincipalName (e-mailachtige UPN) opgeven. Gebruik 'me' niet als userIdentifier.

Vereiste parameters:

  • userIdentifier: object-id van gebruiker (GUID) of userPrincipalName (UPN)

Notitie

Stuur 'me' niet als userIdentifier. Als alleen de weergavenaam beschikbaar is, zoekt u eerst de gebruiker op om de userPrincipalName of object-id te krijgen.

Optionele parameters:

  • select: door komma's gescheiden lijst met eigenschappen die moeten worden geretourneerd (bijvoorbeeld id,displayName,mail,jobTitle,userPrincipalName)
  • top: aantal items dat per pagina moet worden geretourneerd

mcp_graph_getMyManager

Hiermee haalt u de manager van de aangemelde gebruiker (de beller) op. Dit eindpunt retourneert altijd de manager van de huidige gebruikerscontext.

Optionele parameters:

  • select: door komma's gescheiden lijst met managereigenschappen die moeten worden geretourneerd

mcp_graph_getMyProfile

Hiermee haalt u de profieldetails van de aangemelde gebruiker (de beller) op. Dit eindpunt retourneert altijd het profiel van de huidige gebruikerscontext.

Optionele parameters:

  • select: door komma's gescheiden lijst met eigenschappen van gebruikersprofielen
  • expand: gerelateerde entiteiten uitvouwen (bijvoorbeeld manager, directReports)

mcp_graph_getUserProfile

Het profiel van een opgegeven gebruiker in de map ophalen. U moet de object-id (GUID) van de gebruiker of de userPrincipalName (e-mailachtige UPN) opgeven. Gebruik 'me' niet als userIdentifier. Gebruik in plaats daarvan mcp_graph_getMyProfile voor de aangemelde gebruiker.

Vereiste parameters:

  • userIdentifier: object-id van gebruiker (GUID) of userPrincipalName (UPN)

Notitie

Verzend niet 'me'. Als alleen de weergavenaam beschikbaar is, moet u eerst de gebruiker opzoeken.

Optionele parameters:

  • select: door komma's gescheiden lijst met gebruikerseigenschappen die moeten worden geretourneerd
  • expand: een gerelateerde entiteit uitvouwen (manager OF directReports). U kunt slechts één eigenschap per aanvraag uitvouwen.

mcp_graph_getUsersManager

Hiermee haalt u de manager van een opgegeven gebruiker in de map op. U moet de object-id (GUID) van de gebruiker of de userPrincipalName (e-mailachtige UPN) opgeven. Gebruik 'me' niet als userIdentifier. Gebruik in plaats daarvan mcp_graph_getMyManager voor de aangemelde gebruiker.

Vereiste parameters:

  • userIdentifier: object-id van gebruiker (GUID) of userPrincipalName (UPN)

Notitie

Verzend niet 'me'. Als alleen de weergavenaam beschikbaar is, moet u eerst de gebruiker opzoeken.

Optionele parameters:

  • select: door komma's gescheiden lijst met eigenschappen die moeten worden geretourneerd voor de manager (bijvoorbeeld id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Hiermee haalt u een lijst met gebruikers in de organisatie op. Ondersteunt queryopties zoals $select, $filter, $top en $orderby. ConsistencyLevel is standaard ingesteld op eventual.

Optionele parameters:

  • top: alleen de eerste n gebruikers worden weergegeven
  • select: door komma's gescheiden lijst met gebruikerseigenschappen die moeten worden geretourneerd
  • filter: gebruikers filteren op eigenschap (bijvoorbeeld startswith(displayName,'A'))
  • orderby: resultaten ordenen op basis van een bepaalde eigenschap (bijvoorbeeld displayName)
  • search: op basis van vrije tekst zoeken naar gebruikers. Notatie: ''property:value', bijvoorbeeld ''displayName:Neha'' om weergavenamen te zoeken die 'Neha' bevatten. Ondersteunt meerdere eigenschappen met spaties. Terugvalregel: als $search mislukt of geen resultaten retourneert, wordt het automatisch opnieuw geprobeerd met $filter.
  • count: het aantal opnemen ('true' of 'false')
  • ConsistencyLevel: vereiste header voor geavanceerde query's (standaard: 'eventual')

Belangrijke functies

Zelfkennis

  • Profiel van aangemelde gebruiker ophalen
  • Manager van aangemelde gebruiker ophalen
  • Huidige gebruikerscontextgegevens openen
  • Gebruikers-id's zijn niet nodig

Gebruikersprofielen

  • Het profiel van een gebruiker ophalen op id of UPN
  • Gebruikerseigenschappen openen (displayName, mail, jobTitle, enzovoort)
  • Gerelateerde entiteiten uitvouwen (manager, directReports)
  • Eigenschap selecteren met $select

Organisatiehiërarchie

  • De manager van de gebruiker ophalen
  • De directe ondergeschikten van de gebruiker ophalen
  • Navigeren in rapportagestructuur
  • Relaties tussen manager en direct ondergeschikten

Gebruikersdetectie

  • Gebruikers in de organisatie vermelden
  • Zoeken op basis van vrije tekst met automatische terugval
  • OData filteren en ordenen
  • Ondersteuning voor paginering
  • Gebruikers tellen in resultaten

Querymogelijkheden

  • OData $select voor de selectie van eigenschappen
  • OData $filter voor het filteren van gebruikers
  • OData $expand voor gerelateerde entiteiten
  • OData $orderby voor sorteren
  • $search op basis van vrije tekst met terugval
  • Ondersteuning voor uiteindelijke consistentie

Opmerkingen

  1. Gebruik mcp_graph_getMyProfile voor de aangemelde gebruiker, niet mcp_graph_getUserProfile met 'me'
  2. Gebruik mcp_graph_getMyManager voor de manager van de aangemelde gebruiker
  3. userIdentifier moet de object-id (GUID) of userPrincipalName (UPN) zijn, niet de weergavenaam
  4. Als alleen de weergavenaam beschikbaar is, gebruikt u mcp_graph_listUsers om eerst de gebruiker op te zoeken
  5. Met $expand kan slechts één eigenschap per aanvraag worden uitgevouwen (manager OF directReports)
  6. Voor $search wordt automatisch teruggevallen op $filter als het zoeken mislukt
  7. ConsistencyLevel eventual vereist voor geavanceerde query's
  8. Zoeknotatie: '"property:value"' met aanhalingstekens

Veelvoorkomende toepassingen

Mijn gegevens ophalen

  • Gebruik mcp_graph_getMyProfile om het profiel van de huidige gebruiker op te halen
  • Gebruik mcp_graph_getMyManager om de manager van de huidige gebruiker op te halen

2. Een gebruiker zoeken

  • Gebruik mcp_graph_listUsers met een zoekparameter

    Gebruik bijvoorbeeld search='"displayName:John"' om gebruikers met de naam John te zoeken

  • Haal de userPrincipalName of object-id op uit resultaten

3. Gebruikersdetails ophalen

  • Gebruik mcp_graph_getUserProfile met userIdentifier
  • Gebruik select om bepaalde eigenschappen op te halen
  • Gebruik expand om de manager of directReports op te nemen

4. Organisatiestructuur ophalen

  • Gebruik mcp_graph_getUsersManager om de manager van een gebruiker op te halen
  • Gebruik mcp_graph_getDirectReports om de direct ondergeschikten van een gebruiker op te halen
  • Aanroepen ketenen om door de rapportagehiërarchie te navigeren
  • Last updated on