Referência do Servidor MCP do Perfil de Utilizador Microsoft 365

Importante

É necessário fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Descrição geral

ID do servidor	Nome a apresentar	Descrição
mcp_MeServer	Servidor MCP de Perfil de Utilizador Microsoft 365	Servidor MCP para autoconhecimento e consciência organizacional. Use este servidor MCP para aceder a perfis de utilizador na sua organização e realizar várias ações, como obter o seu perfil, o perfil de um utilizador, o gestor de um utilizador ou subordinados diretos.

Ferramentas disponíveis

mcp_graph_getDirectReports

Liste os subordinados diretos de um utilizador especificado no diretório. Deve fornecer o ID do objeto (GUID) do utilizador ou o seu userPrincipalName (UPN semelhante a um email). Não uses 'me' como identificador de utilizador.

Parâmetros necessários

• userIdentifier: ID do objeto do utilizador (GUID) ou userPrincipalName (UPN)

Nota

Não envies 'me' como userIdentifier. Se apenas o nome de exibição estiver disponível, primeiro procure o utilizador para obter userPrincipalName ou ID de objeto.

Parâmetros opcionais

• select: lista separada por vírgulas de propriedades a devolver (por exemplo, id, displayName,mail,jobTitle,userPrincipalName)
• topo: Número de itens a devolver por página

mcp_graph_getMyManager

Recupere o gestor do utilizador iniciado (o chamador). Este endpoint devolve sempre o gestor do contexto do utilizador atual.

Parâmetros opcionais

• select: lista separada por vírgulas das propriedades do gestor a devolver

mcp_graph_getMyProfile

Recupere os dados do perfil do utilizador iniciado (o chamador). Este endpoint devolve sempre o perfil do contexto do utilizador atual.

Parâmetros opcionais

• select: lista separada por vírgulas das propriedades do perfil do utilizador
• expandir: expandir entidades relacionadas (por exemplo, gestor, directReports)

mcp_graph_getUserProfile

Recuperar o perfil de um utilizador especificado no diretório. Deve fornecer o ID do objeto (GUID) do utilizador ou o seu userPrincipalName (UPN semelhante a um email). Não use 'me' como userIdentifier – use mcp_graph_getMyProfile em vez disso para o utilizador iniciado sessão.

Parâmetros necessários

• userIdentifier: ID do objeto do utilizador (GUID) ou userPrincipalName (UPN)

Nota

Não envies 'eu'. Se apenas o nome de exibição estiver disponível, primeiro procura o utilizador.

Parâmetros opcionais

• select: lista separada por vírgulas das propriedades do utilizador a devolver
• expandir: expandir uma entidade relacionada (gestor OU diretos). Só pode expandir uma propriedade por pedido.

mcp_graph_getUsersManager

Recuperar o gestor de um utilizador especificado no diretório. Deve fornecer o ID do objeto (GUID) do utilizador ou o seu userPrincipalName (UPN semelhante a um email). Não use 'eu' como identificador de utilizador – use mcp_graph_getMyManager em vez disso para o utilizador iniciado sessão.

Parâmetros necessários

• userIdentifier: ID do objeto do utilizador (GUID) ou userPrincipalName (UPN)

Nota

Não envies 'eu'. Se apenas o nome de exibição estiver disponível, primeiro procura o utilizador.

Parâmetros opcionais

• select: lista separada por vírgulas de propriedades a devolver para o gestor (ex.: id, displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Recupere uma lista de utilizadores da organização. Suporta opções de consulta como $select, $filter, $top, $orderby. ConsistencyLevel está definido como eventual por defeito.

Parâmetros opcionais

• topo: Mostrar apenas os primeiros n utilizadores
• select: lista separada por vírgulas das propriedades do utilizador a devolver
• filter: Filtrar utilizadores por propriedade (por exemplo, startsamb(displayName,'A'))
• orderby: Resultados da ordem por propriedade dada (ex.: displayName)
• pesquisa: pesquisa em texto livre para utilizadores. Formato: '"property:value", por exemplo, '"displayName:Neha"' para pesquisar nomes de exibição que contenham 'Neha'. Suporta múltiplas propriedades com espaços. Regra de recurso: Se $search falhar ou não apresentar resultados, tente automaticamente com $filter.
• contagem: Incluir contagem de itens ('verdadeiro' ou 'falso')
• ConsistencyLevel: Cabeçalho obrigatório para consultas avançadas (por defeito: 'eventual')

Funcionalidades principais

Autoconhecimento

• Obtenha o perfil do utilizador iniciado sessão
• Obtenha o gestor de utilizadores iniciados
• Aceder à informação atual do contexto do utilizador
• Não há necessidade de identificadores de utilizador

Perfil do Utilizador

• Recuperar o perfil de qualquer utilizador por ID ou UPN
• Aceder às propriedades do utilizador (displayName, email, jobTitle, etc.)
• Expandir entidades relacionadas (gestor, directReports)
• Seleção de propriedades com $select

Hierarquia organizacional

• Liste o gestor do utilizador.
• Obtenha os subordinados diretos dos utilizadores
• Estrutura de relatórios de navegação
• Relações entre gestores e subordinados diretos

Descoberta do Utilizador

• Lista de utilizadores na organização
• Pesquisa em texto livre com recurso automático
• Filtragem e ordenação OData
• Suporte à paginação
• Contar utilizadores nos resultados

Capacidades-chave

• OData $select para seleção de propriedades
• OData $filter para filtragem de utilizadores
• OData $expand para entidades relacionadas
• OData $orderby para ordenação
• $search de texto livre com recurso de recurso
• Suporte de consistência eventual

Notas

1. Usa mcp_graph_getMyProfile para utilizadores iniciados em sessão, não mcp_graph_getUserProfile com 'eu'
2. Use mcp_graph_getMyManager para o gestor de utilizadores iniciados
3. userIdentifier deve ser o ID do objeto (GUID) ou userPrincipalName (UPN), não o nome de exibição
4. Se apenas o nome de exibição estiver disponível, use mcp_graph_listUsers para procurar primeiro o utilizador
5. $expand só pode expandir uma propriedade por pedido (gestor OU direReports)
6. $search tem recurso automático para $filter se a pesquisa falhar
7. ConsistencyLevel 'eventual' necessário para consultas avançadas
8. Formato de pesquisa: '"property:value"' com aspas

Casos comuns de utilização

Obter informações

• Use mcp_graph_getMyProfile para obter o perfil do utilizador atual
• Use mcp_graph_getMyManager para obter o gestor do utilizador atual

2. Encontrar um Utilizador

• Usar mcp_graph_listUsers com parâmetro de pesquisa

  Exemplo: pesquisa='"displayName:John"' para encontrar utilizadores chamados John

• Obtenha userPrincipalName ou ID de objeto a partir dos resultados

3. Obter Dados do Utilizador

• Use mcp_graph_getUserProfile com userIdentifier
• Selecione Propriedades para obter detalhes específicos.
• Use expandir para incluir gestor ou directReports

Estrutura organizacional.

• Use mcp_graph_getUsersManager para obter um gestor de utilizadores
• Use mcp_graph_getDirectReports para obter os subordinados diretos de um utilizador
• Chamadas em cadeia para navegar pela hierarquia de relatórios