Microsoft 365-Benutzerprofil-MCP-Serverreferenz

Wichtig

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

Übersicht

Server-ID	Anzeigename	Beschreibung des Dataflows
mcp_MeServer	Microsoft 365-Benutzerprofil-MCP-Server	MCP-Server für Selbsterkenntnis und Organisationsbewusstsein. Verwenden Sie diesen MCP-Server, um auf Benutzerprofile in Ihrer Organisation zuzugreifen und verschiedene Aktionen auszuführen, z. B. das Abrufen Ihres Profils, des Profils eines Benutzers, des Vorgesetzten eines Benutzers oder direkte Untergebene.

Verfügbare Tools

mcp_graph_getDirectReports

Auflisten der direkten Berichte eines angegebenen Benutzers im Verzeichnis. Sie müssen entweder die Objekt-ID (GUID) des Benutzers oder dessen userPrincipalName (UPN im E-Mail-Stil) angeben. Verwenden Sie nicht „ich“ als userIdentifier.

Erforderliche Parameter:

• userIdentifier: Benutzerobjekt-ID (GUID) oder userPrincipalName (UPN)

Anmerkung

Senden Sie nicht „ich“ als userIdentifier. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer, um userPrincipalName oder Objekt-ID abzurufen.

Optionale Parameter:

• Auswählen: Durch Trennzeichen getrennte Liste der zurückzugebenden Eigenschaften (z. B.: id,displayName,mail,jobTitle,userPrincipalName)
• Oberste: Anzahl der Elemente, die pro Seite zurückgegeben werden sollen

mcp_graph_getMyManager

Rufen Sie den Vorgesetzten des angemeldeten Benutzers (den Aufrufer) ab. Dieser Endpunkt gibt immer den Vorgesetzten des aktuellen Benutzerkontexts zurück.

Optionale Parameter:

• Auswählen: Kommagetrennte Liste der Managereigenschaften, die zurückgegeben werden sollen

mcp_graph_getMyProfile

Rufen Sie die Profildetails des angemeldeten Benutzers (den Aufrufer) ab. Dieser Endpunkt gibt immer das Profil des aktuellen Benutzerkontexts zurück.

Optionale Parameter:

• Auswählen: Kommagetrennte Liste der Benutzerprofileigenschaften
• Erweitern: Erweitern Sie verwandte Entitäten (zum Beispiel Manager, directReports)

mcp_graph_getUserProfile

Rufen Sie das Profil eines angegebenen Benutzers im Verzeichnis ab. Sie müssen entweder die Objekt-ID (GUID) des Benutzers oder dessen userPrincipalName (UPN im E-Mail-Stil) angeben. Verwenden Sie nicht „ich“ als userIdentifier – verwenden Sie stattdessen mcp_graph_getMyProfile für den angemeldeten Benutzer.

Erforderliche Parameter:

• userIdentifier: Benutzerobjekt-ID (GUID) oder userPrincipalName (UPN)

Anmerkung

Nicht „ich“ senden. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer nach.

Optionale Parameter:

• Auswählen: Kommagetrennte Liste der Benutzereigenschaften, die zurückgegeben werden sollen
• Erweitern: Erweitern Sie eine verwandte Entität (Manager ODER directReports). Sie können pro Anforderung nur eine Eigenschaft erweitern.

mcp_graph_getUsersManager

Rufen Sie den Vorgesetzten eines angegebenen Benutzers im Verzeichnis ab. Sie müssen entweder die Objekt-ID (GUID) des Benutzers oder dessen userPrincipalName (UPN im E-Mail-Stil) angeben. Verwenden Sie nicht „ich“ als userIdentifier – verwenden Sie stattdessen mcp_graph_getMyManager für den angemeldeten Benutzer.

Erforderliche Parameter:

• userIdentifier: Benutzerobjekt-ID (GUID) oder userPrincipalName (UPN)

Anmerkung

Nicht „ich“ senden. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer nach.

Optionale Parameter:

• Auswählen: Durch Trennzeichen getrennte Liste von Eigenschaften, die für den Manager zurückgegeben werden sollen (z. B.: id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Rufen Sie eine Liste der Benutzer in der Organisation ab. Unterstützt Abfrageoptionen wie $select, $filter, $top, $orderby. ConsistencyLevel ist standardmäßig auf „eventuell“ festgelegt.

Optionale Parameter:

• Oberste: Nur die ersten n Benutzer anzeigen
• Auswählen: Kommagetrennte Liste der Benutzereigenschaften, die zurückgegeben werden sollen
• Filter: Filtern von Benutzern nach Eigenschaft (z. B. startswith(displayName,„A“))
• orderby: Sortieren der Ergebnisse nach einer bestimmten Eigenschaft (z. B. displayName)
• Suche: Freitextsuche für Benutzer. Format: „Eigenschaft:Wert“‚, z.B. „displayName:Neha“, um Anzeigenamen zu suchen, die „Neha“ enthalten. Unterstützt mehrere Eigenschaften mit Leerzeichen. Fallbackregel: Wenn $search fehlschlägt oder keine Ergebnisse zurückgibt, versuchen Sie es automatisch mit $filter.
• Anzahl: Anzahl der Artikel einbeziehen („wahr“ oder „falsch“)
• ConsistencyLevel: Erforderlicher Header für erweiterte Abfragen (Standard: „eventuell“)

Schlüsselfunktionen

Selbsterkenntnis

• Profil des angemeldeten Benutzers abrufen
• Den Manager des angemeldeten Benutzers abrufen
• Zugreifen auf aktuelle Benutzerkontextinformationen
• Keine Notwendigkeit für Benutzerbezeichner

Benutzerprofile

• Abrufen des Profils eines Benutzers nach ID oder UPN
• Zugreifen auf Benutzereigenschaften (displayName, Mail, jobTitle usw.)
• Erweitern verwandter Entitäten (Manager, directReports)
• Eigenschaftenauswahl mit $select

Organisationshierarchie

• Manager des Benutzers abrufen
• Abrufen der direkt Untergebenen des Benutzers
• Navigieren in der Berichtsstruktur
• Manager- und direkte Berichtsbeziehungen

Benutzerermittlung

• Auflisten von Benutzern in der Organisation
• Freitextsuche mit automatischem Fallback
• OData-Filterung und -Sortierung
• Unterstützung der Paginierung
• Zählen von Benutzern in Ergebnissen

Abfragefunktionen

• OData $select für die Eigenschaftenauswahl
• OData $filter für die Benutzerfilterung
• OData $expand für verwandte Entitäten
• OData $orderby zum Sortieren
• Freitext $search mit automatischem Fallback
• Mögliche Konsistenzunterstützung

Anmerkungen

1. Verwenden von mcp_graph_getMyProfile für angemeldeten Benutzer, nicht für mcp_graph_getUserProfile mit „ich“
2. Verwenden von mcp_graph_getMyManager für den Vorgesetzten des angemeldeten Benutzers
3. userIdentifier muss Objekt-ID (GUID) oder userPrincipalName (UPN) sein, nicht Anzeigename
4. Wenn nur der Anzeigename verfügbar ist, verwenden Sie mcp_graph_listUsers, um den Benutzer zuerst nachzuschlagen
5. $expand kann nur eine Eigenschaft pro Anforderung erweitern (Manager ODER directReports)
6. $search hat einen automatischen Fallback auf $filter, wenn die Suche fehlschlägt
7. ConsistencyLevel „eventuell“ erforderlich für erweiterte Abfragen
8. Suchformat: „property:value“ mit Anführungszeichen

Gängige Anwendungsfälle

Meine Informationen abrufen

• Verwenden von mcp_graph_getMyProfile zum Abrufen des Profils des aktuellen Benutzers
• Verwenden Sie mcp_graph_getMyManager, um den Manager des aktuellen Benutzers zu ermitteln

2. Suchen eines Benutzers

• Verwenden von mcp_graph_listUsers mit Suchparametern

  Beispiel: Suche=„displayName:John“ zum Suchen von Benutzern namens John

• Abrufen von userPrincipalName oder Objekt-ID aus Ergebnissen

3. Benutzerdetails abrufen

• Verwenden von mcp_graph_getUserProfile mit userIdentifier
• Verwenden Sie „Auswählen“, um bestimmte Eigenschaften zu erhalten
• Verwenden von Erweiterung zum Einschließen von Managern oder DirectReports

4. Organisationsstruktur abrufen

• Verwenden von mcp_graph_getUsersManager zum Abrufen des Vorgesetzten eines Benutzers
• Verwenden von mcp_graph_getDirectReports zum Abrufen der direkt Untergebenen eines Benutzers
• Verketten von Aufrufen zur Navigation in der Berichtshierarchie