Informazioni di riferimento sugli utenti di IQ aziendale (anteprima)

Importante

• Si tratta di una funzionalità di anteprima.
• Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono soggette a condizioni per l'utilizzo supplementari e sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso iniziale e fornire feedback.

Panoramica

ID del server	Nome visualizzato	Descrizione
mcp_MeServer	Utente di IQ aziendale	Server MCP per la consapevolezza di sé e la consapevolezza dell'organizzazione. Usare questo server MCP per accedere ai profili utente all'interno dell'organizzazione ed eseguire varie azioni, ad esempio ottenere il proprio profilo, il profilo di un utente, il manager di un utente o i suoi riporti diretti.

Strumenti disponibili

mcp_graph_getDirectReports

Elenca i report diretti di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare 'me' come userIdentifier.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Nota

Non mandare 'me' come userIdentifier. Se è disponibile solo il nome visualizzato, cerca prima l'utente per ottenere userPrincipalName o l'ID dell'oggetto.

Parametri facoltativi:

• seleziona: Elenco separato da virgola delle proprietà da restituire (ad esempio, id, displayName, mail, jobTitle, userPrincipalName)
• top: numero di elementi da restituire per pagina

mcp_graph_getMyManager

Recupera il responsabile dell'utente connesso (il chiamante). Questo endpoint restituisce sempre il gestore del contesto utente corrente.

Parametri facoltativi:

• select: elenco di proprietà dei manager separato da virgole da restituire

mcp_graph_getMyProfile

Recupera i dettagli del profilo dell'utente connesso (il chiamante). Questo endpoint restituisce sempre il profilo del contesto utente corrente.

Parametri facoltativi:

• select: elenco delimitato da virgole delle proprietà del profilo utente
• Espandi: Espandi le tabelle correlate (ad esempio, manager, directReports)

mcp_graph_getUserProfile

Recupera il profilo di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare 'me' come userIdentifier - usa mcp_graph_getMyProfile invece per l'utente loggato.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Nota

Non mandarmi. Se è disponibile solo il nome visualizzato, cerca prima l'utente.

Parametri facoltativi:

• select: elenco delimitato da virgole di proprietà utente da restituire
• Espandi: Espandi una tabella correlata (manager oppure directReports). Puoi espandere una sola proprietà per richiesta.

mcp_graph_getUsersManager

Recupera il gestore di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare 'me' come userIdentifier - usa mcp_graph_getMyManager invece per l'utente loggato.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Nota

Non mandarmi. Se è disponibile solo il nome visualizzato, cerca prima l'utente.

Parametri facoltativi:

• seleziona: Elenco separato da virgole di proprietà da restituire per il manager, come id,displayName, mail, jobTitle, ) userPrincipalName

mcp_graph_listUsers

Recupera un elenco di utenti nell'organizzazione. Supporta opzioni di query come $select, $filter, $top $orderby. ConsistencyLevel è impostato su eventuale di default.

Parametri facoltativi:

• Superiore: Mostra solo i n primi utenti
• select: elenco delimitato da virgole di proprietà utente da restituire
• Filtro: Filtra gli utenti per proprietà, ad esempio startswith(displayName,'A')
• Orderby: L'ordine risulta tramite una proprietà data, come ad esempio displayName
• search: ricerca di testo libero per gli utenti. Formato: "property:value", ad esempio displayName:Neha per cercare nomi visualizzati contenenti Neha. Supporta più proprietà che includono spazi. Regola di fallback: se $search ha esito negativo o non restituisce alcun risultato riprova automaticamente con $filter.
• Conteggio: Includi conteggio degli elementi (vero o falso)
• ConsistencyLevel: Intestazione obbligatoria per le query avanzate (impostazione predefinita: finale)

Funzionalità chiave

Conoscenza di sé

• Recuperare il profilo dell'utente connesso
• Ottenere il manager dell'utente autenticato
• Access informazioni sul contesto utente corrente
• Nessuna necessità di identificatori utente

Profili utente

• Recupera il profilo di qualsiasi utente in base all'ID o all'UPN
• Accedi alle proprietà degli utenti (displayName, mail, jobTitle ecc.)
• Espandi le tabelle correlate (manager, directReports)
• Selezione delle proprietà con $select

Gerarchia organizzativa

• Recupera il responsabile dell'utente
• Ottenere i dipendenti diretti dell'utente
• Esplora la struttura gerarchica
• Relazioni tra responsabile e subalterno

Ricerca utente

• Elenca gli utenti nell'organizzazione
• Ricerca di testo libero con fallback automatico
• Filtro e ordinamento di OData
• Supporto della paginazione
• Contare gli utenti nei risultati

Funzionalità di query

• OData $select per la selezione delle proprietà
• $filter OData per filtrare l'utente
• OData $expand per entità correlate
• OData $orderby per l'ordinamento
• Ricerca di testo libero con alternativa
• Supporto della coerenza eventuale

Note

• Usare mcp_graph_getMyProfile per l'utente connesso, non mcp_graph_getUserProfile con me
• Usa mcp_graph_getMyManager per il manager dell'utente connesso
• userIdentifier deve essere l'ID dell'oggetto (GUID) oppure userPrincipalName (UPN), non usare il nome visualizzato
• Se è disponibile solo il nome visualizzato, usare mcp_graph_listUsers per cercare prima l'utente
• $expand può espandere una sola proprietà per richiesta (manager o directReports)
• $search effettua automaticamente il fallback su $filter se la ricerca non riesce
• ConsistencyLevel eventualmente richiesto per le query avanzate
• Formato di ricerca: "property:value" con virgolette

Casi d'uso comuni

Ottenere le mie informazioni

• Usare mcp_graph_getMyProfile per ottenere il profilo dell'utente attuale
• Usa mcp_graph_getMyManager per ottenere il responsabile dell'utente attuale

Trovare un utente

• Utilizzo mcp_graph_listUsers con parametro di ricerca

  Esempio: search='"displayName:John"' per trovare gli utenti denominati John

• Ottenere userPrincipalName o l'ID oggetto dai risultati

3. Ottenere dettagli utente

• Usare mcp_graph_getUserProfile con userIdentifier
• Usare la selezione per ottenere proprietà specifiche
• Usa espandi per includere manager o directReports

4. Ottieni la struttura organizzativa

• Usa mcp_graph_getUsersManager per ottenere il responsabile dell'utente
• Usa mcp_graph_getDirectReports per ottenere i rapporti diretti di un utente
• Concatenare le chiamate per spostarsi nella gerarchia dei report