Riferimento al server MCP del profilo utente di Microsoft 365

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

Panoramica

ID del server	Nome visualizzato	Descrizione
mcp_MeServer	Server MCP del profilo utente di Microsoft 365	Server MCP per la consapevolezza dell'organizzazione e la conoscenza autonoma. Usa questo server MCP per accedere ai profili utente nell'organizzazione ed eseguire varie azioni, ad esempio ottenere il profilo, il profilo di un utente, il manager di un utente o i report diretti.

Strumenti disponibili

mcp_graph_getDirectReports

Elenca i report diretti di un utente specificato nella directory. Devi specificare l'ID oggetto (GUID) dell'utente o il relativo nome userPrincipalName (upN simile al messaggio di posta elettronica). Non usare "me" come userIdentifier.

Parametri obbligatori:

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

Nota

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

Parametri facoltativi:

• select: elenco delimitato da virgole di 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 delimitato da virgole di proprietà responsabili 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
• expand: espandi le entità correlate (ad esempio, responsabile, directReports)

mcp_graph_getUserProfile

Recupera il profilo di un utente specificato nella directory. Devi specificare l'ID oggetto (GUID) dell'utente o il relativo nome userPrincipalName (upN simile al messaggio di posta elettronica). Non usare "me" come userIdentifier: usa mcp_graph_getMyProfile per l'utente connesso.

Parametri obbligatori:

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

Nota

Non inviare "me". Se è disponibile solo il nome visualizzato, cerca prima di tutto l'utente.

Parametri facoltativi:

• select: elenco delimitato da virgole di proprietà utente da restituire
• expand: espandi un'entità correlata (responsabile OPPURE directReports). Puoi espandere una sola proprietà per richiesta.

mcp_graph_getUsersManager

Recupera il gestore di un utente specificato nella directory. Devi specificare l'ID oggetto (GUID) dell'utente o il relativo nome userPrincipalName (upN simile al messaggio di posta elettronica). Non usare "me" come userIdentifier: usa mcp_graph_getMyManager per l'utente connesso.

Parametri obbligatori:

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

Nota

Non inviare "me". Se è disponibile solo il nome visualizzato, cerca prima di tutto l'utente.

Parametri facoltativi:

• select: elenco delimitato da virgole di proprietà da restituire per il responsabile (ad esempio 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 finale per impostazione predefinita.

Parametri facoltativi:

• top: mostra solo i primi n utenti
• select: elenco delimitato da virgole di proprietà utente da restituire
• filter: filtra gli utenti in base alla proprietà, Nome visualizzato, ad esempio startswith(displayName,"A")
• orderby: ordina i risultati in base alla proprietà specificata (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à con spazi. Regola di fallback: se $search ha esito negativo o non restituisce risultati, riprova automaticamente con $filter.
• count: includi il conteggio degli elementi ("true" o "false")
• ConsistencyLevel: intestazione obbligatoria per le query avanzate (impostazione predefinita: "eventuale")

Funzionalità chiave

Conoscenza autonoma

• Recuperare il profilo dell'utente connesso
• Recuperare il profilo del responsabile connesso
• Accedere alle 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à utente (displayName, mail, jobTitle e così via)
• Espandi le entità correlate (responsabile, directReports)
• Selezione delle proprietà con $select

Gerarchia organizzativa

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

Individuazione 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

• $select OData per la selezione delle proprietà
• $filter OData per il filtro utente
• $expand OData per le entità correlate
• $orderby OData per l'ordinamento
• $search di testo libero con fallback
• Supporto della coerenza finale

Note

1. Usa mcp_graph_getMyProfile per l'utente connesso, non mcp_graph_getUserProfile con 'me'
2. Usa mcp_graph_getMyManager per il responsabile dell'utente connesso
3. userIdentifier deve essere l'ID oggetto (GUID) o userPrincipalName (UPN), non il nome visualizzato
4. Se è disponibile solo il nome visualizzato, usa mcp_graph_listUsers per cercare prima l'utente
5. $expand può espandere una sola proprietà per richiesta (responsabile OPPURE directReports)
6. $search ha il fallback automatico in $filter se la ricerca non riesce
7. ConsistencyLevel "eventuale" necessaria per le query avanzate
8. Formato di ricerca: '"property:value"' con virgolette

Casi d'uso comuni

Ottenere informazioni personali

• Usa mcp_graph_getMyProfile per ottenere il profilo dell'utente corrente
• Usa mcp_graph_getMyManager per ottenere il profilo del responsabile dell'utente corrente

2. Trova un utente

• Usa mcp_graph_listUsers con il parametro di ricerca

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

• Ottenere userPrincipalName o l'ID dell'oggetto dai risultati

3. Ottenere dettagli utente

• Usa mcp_graph_getUserProfile con userIdentifier
• Usare la selezione per ottenere proprietà specifiche
• Usare l'espansione per includere responsabili o directReports

4. Ottieni la struttura organizzativa

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