Freigeben über

Arbeit IQ Benutzerhandbuch (Vorschau)

Wichtig

  • Dies ist eine Vorschaufunktion.
  • Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Für diese Features gelten ergänzende Nutzungsbedingungen. Die Features werden vor einer offiziellen Veröffentlichung zur Verfügung gestellt, sodass die Kundschaft frühzeitig Zugriff erhält und Feedback geben kann.

Übersicht

Server-ID Anzeigename Beschreibung
mcp_MeServer Work-IQ-Benutzer MCP-Server für Selbsterkenntnis und Organisationsbewusstsein. Verwenden Sie diesen MCP-Server, um Benutzerprofile in Ihrer Organisation zu access und verschiedene Aktionen auszuführen, z. B. das Abrufen Ihres Profils, des Profils eines Benutzers, des Vorgesetzten eines Benutzers oder direkte Berichte.

Verfügbare Tools

mcp_graph_getDirectReports

Auflisten der direkten Berichte eines angegebenen Benutzers im Verzeichnis. Du musst entweder die Objekt-ID des Nutzers (GUID) oder deren userPrincipalName (e-mailähnliches UPN) angeben. Benutze nicht 'mich' als das userIdentifier.

Erforderliche Parameter:

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

Anmerkung

Schick nicht 'mich' als userIdentifier. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer auf, um userPrincipalName oder die Objekt-ID zu erhalten.

Optionale Parameter:

  • Auswählen: Komma-separierte Liste von zu zurückgebenden Eigenschaften (zum Beispiel 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 Tabellen (zum Beispiel Manager, directReports)

mcp_graph_getUserProfile

Rufen Sie das Profil eines angegebenen Benutzers im Verzeichnis ab. Du musst entweder die Objekt-ID des Nutzers (GUID) oder deren userPrincipalName (e-mailähnliches UPN) angeben. Verwenden Sie nicht 'mich' als userIdentifier - mcp_graph_getMyProfile verwenden Sie stattdessen für den angemeldeten Nutzer.

Erforderliche Parameter:

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

Anmerkung

Schicken Sie mich nicht. 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 Tabelle (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. Du musst entweder die Objekt-ID des Nutzers (GUID) oder deren userPrincipalName (e-mailähnliches UPN) angeben. Verwenden Sie nicht 'mich' als userIdentifier - mcp_graph_getMyManager verwenden Sie stattdessen für den angemeldeten Nutzer.

Erforderliche Parameter:

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

Anmerkung

Schicken Sie mich nicht. Wenn nur der Anzeigename verfügbar ist, suchen Sie zuerst den Benutzer nach.

Optionale Parameter:

  • Auswählen: Komma-getrennte Liste von Eigenschaften, die für den Manager zurückgegeben werden sollen, wie zum Beispiel 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 eventual eingestellt.

Optionale Parameter:

  • Nach oben: Nur die ersten n Benutzer anzeigen
  • Auswählen: Kommagetrennte Liste der Benutzereigenschaften, die zurückgegeben werden sollen
  • Filter: Filtern Sie Benutzer nach Eigenschaft, wie zum Beispiel startswith(displayName,'A')
  • OrderBy: Ordnung ergibt sich nach gegebener Eigenschaft, wie zum Beispiel displayName
  • Suche: Freitextsuche für Benutzer. Format: "property:value", z. B. displayName:Neha zum Durchführen einer Suche in Anzeigenamen, die Neha enthalten. Unterstützt mehrere Eigenschaften mit Leerzeichen. Fallbackregel: Wenn $search ein Fehler auftritt oder keine Ergebnisse zurückgegeben werden, automatisch mit $filter erneut versuchen.
  • Count: Anzahl von Elementen einschließen (wahr oder falsch)
  • ConsistencyLevel: Erforderlicher Header für erweiterte Abfragen (Standard: eventual)

Schlüsselfunktionen

Selbsterkenntnis

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

Benutzerprofile

  • Abrufen des Profils eines Benutzers nach ID oder UPN
  • Zugriff auf Benutzereigenschaften (displayName, mail, jobTitle usw.)
  • Erweitern Sie verwandte Tabellen (manager, directReports)
  • Eigenschaftenauswahl mit $select

Organisationshierarchie

  • Manager des Benutzers abrufen
  • Abrufen der Direkt-Berichte des Benutzers
  • Navigieren in der Berichtsstruktur
  • Manager- und direkte Berichtsbeziehungen

Benutzerentdeckung

  • Benutzer in der Organisation auflisten
  • Freitextsuche mit automatischem Fallback
  • OData-Filterung und -Sortierung
  • Unterstützung der Paginierung
  • Benutzer in Ergebnissen zählen

Abfragemöglichkeiten

  • OData $select zur Auswahl von Eigenschaften
  • OData $filter für die Benutzerfilterung
  • OData $expand für verwandte Entitäten
  • OData $orderby zum Sortieren
  • Freitextsuche mit automatischem Fallback
  • Mögliche Konsistenzunterstützung

Anmerkungen

  • Verwende mcp_graph_getMyProfile für angemeldeten Benutzer, nicht mcp_graph_getUserProfile mit mich
  • Verwenden Sie mcp_graph_getMyManager, um den Manager des angemeldeten Benutzers zu identifizieren.
  • userIdentifier muss Objekt-ID (GUID) oder userPrincipalName (UPN) sein, verwenden Sie keinen Anzeigenamen
  • Wenn nur der Anzeigename verfügbar ist, verwende mcp_graph_listUsers, um zuerst den Benutzer nachzuschlagen.
  • $expand kann nur eine Eigenschaft pro Anforderung erweitern (manager oder directReports)
  • $search hat einen automatischen Fallback zu $filter, wenn die Suche fehlschlägt.
  • Konsistenzniveau eventual für erweiterte Abfragen erforderlich
  • Suchformat: "property:value" mit Anführungszeichen

Gängige Anwendungsfälle

Meine Informationen abrufen

  • Nutze mcp_graph_getMyProfile , um das Profil des aktuellen Nutzers zu erhalten
  • Nutze mcp_graph_getMyManager , um den aktuellen Benutzermanager zu erhalten

Suchen eines Benutzers

  • Verwendung mcp_graph_listUsers mit Suchparameter

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

  • Erhalten Sie die Objekt-ID oder userPrincipalName aus den Ergebnissen.

3. Benutzerdetails abrufen

  • Verwenden Sie mcp_graph_getUserProfile mit userIdentifier
  • Verwenden Sie „Auswählen“, um bestimmte Eigenschaften zu erhalten
  • Verwenden Sie "Erweitern", um manager oder directReports einzuschließen.

4. Organisationsstruktur abrufen

  • Nutze mcp_graph_getUsersManager , um einen Benutzermanager zu bekommen
  • Nutze mcp_graph_getDirectReports , um direkte Berichte eines Nutzers zu erhalten
  • Verketten von Aufrufen zur Navigation in der Berichtshierarchie
  • Last updated on