Referência do Perfil de Usuário do Microsoft 365 MCP Server

Visão geral

Ferramentas disponíveis

mcp_graph_getDirectReports

Liste os subordinados diretos de um usuário especificado no diretório. Você deve fornecer o ID do objeto (GUID) do usuário ou seu userPrincipalName (UPN semelhante a um e-mail). Não use 'eu' como identificador de usuário.

Parâmetros obrigatórios

• userIdentifier: ID de objeto do usuário (GUID) ou userPrincipalName (UPN)

Parâmetros opcionais:

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

mcp_graph_getMyManager

Recupere o gerente do usuário logado (o chamador). USER sempre retorna o nome do contexto atual.

Parâmetros opcionais:

• select: lista separada por vírgulas das propriedades do gerenciador para devolver

mcp_graph_getMyProfile

Recupere os dados do perfil do usuário logado (o chamador). USER sempre retorna o nome do contexto atual.

Parâmetros opcionais:

• select: lista separada por vírgulas das propriedades do perfil do usuário
• expandir: expandir entidades relacionadas (por exemplo, gerente, direReportes)

mcp_graph_getUserProfile

Recupere o perfil de um usuário especificado no diretório. Você deve fornecer o ID do objeto (GUID) do usuário ou seu userPrincipalName (UPN semelhante a um e-mail). Não use 'eu' como usuário identificador - use mcp_graph_getMyProfile para o usuário logado.

Parâmetros obrigatórios

• userIdentifier: ID de objeto do usuário (GUID) ou userPrincipalName (UPN)

Parâmetros opcionais:

• select: lista separada por vírgulas das propriedades do usuário para devolver
• expandir: expandir uma entidade relacionada (gerente OU diretoReporte). Você pode expandir apenas uma propriedade por pedido.

mcp_graph_getUsersManager

Recupere o gerenciador de um usuário especificado no diretório. Você deve fornecer o ID do objeto (GUID) do usuário ou seu userPrincipalName (UPN semelhante a um e-mail). Não use 'eu' como userIdentifier - use mcp_graph_getMyManager para o usuário logado.

Parâmetros obrigatórios

• userIdentifier: ID de objeto do usuário (GUID) ou userPrincipalName (UPN)

Parâmetros opcionais:

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

mcp_graph_listUsers

Obter uma lista de usuários na organização Suporta opções de consulta como $select, $filter, $top $orderby. ConsistencyLevel é definido como eventual por padrão.

Parâmetros opcionais:

• topo: Mostrar apenas os primeiros n usuários
• select: lista separada por vírgulas das propriedades do usuário para devolver
• filtrar: Filtrar usuários por propriedade (por exemplo, começa com(displayName,'A'))
• orderby: A ordem resulta por propriedade dada (ex.: displayName)
• busca: Busca em texto livre para usuários. Formate: '"property:value"', por exemplo, 'displayName:Neha"' para buscar nomes de exibição contendo 'Neha'. Suporta múltiplas propriedades com espaços. Regra de reserva: Se $search falhar ou não apresentar resultados, tente automaticamente com $filter.
• contagem: Inclua a contagem de itens ('verdadeiro' ou 'falso')
• ConsistencyLevel: Cabeçalho obrigatório para consultas avançadas (padrão: 'eventual')

Recursos principais

Autoconhecimento

• Obter o perfil do usuário conectado
• Obtenha o gerenciador de usuários logados
• Acesse informações contextuais atuais do usuário
• Não há necessidade de identificadores de usuário

Perfis de Usuário

• Recupere o perfil de qualquer usuário por ID ou UPN
• Acesse propriedades de usuário (displayName, e-mail, cargoTitle, etc.)
• Expandir entidades relacionadas (gerente, direReports)
• Seleção de propriedades com $select

Hierarquia da organização

• Obter um gerenciador de usuário
• Obtenha subordinados diretos dos usuários
• Navegar pela estrutura de relatórios
• Relacionamentos entre gerente e subordinado direto

Descoberta do Usuário

• Listar usuários na organização
• Busca em texto livre com recurso automático
• Filtragem e ordenação OData
• Suporte à paginação
• Conte usuários nos resultados

Capacidades de consulta

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

Notes

1. Use mcp_graph_getMyProfile para usuários logados, não mcp_graph_getUserProfile com 'eu'
2. Use mcp_graph_getMyManager para gerenciador de usuários logados
3. userIdentifier deve ser ID de objeto (GUID) ou userPrincipalName (UPN), não nome de exibição
4. Se apenas o nome de exibição estiver disponível, use mcp_graph_listUsers para procurar o usuário primeiro
5. $expand só pode expandir uma propriedade por solicitação (gerente OU direReports)
6. $search tem um recurso automático para $filter caso a busca falhasse
7. ConsistencyLevel 'eventual' necessário para consultas avançadas
8. Formato de busca: '"property:value"' com aspas

Casos de uso comuns

Obter informações da chave

• Use mcp_graph_getMyProfile para obter o perfil do usuário atual
• Use mcp_graph_getMyManager para obter o gerenciador do usuário atual

2. Encontre um Usuário

• Use mcp_graph_listUsers com parâmetro de busca

  Exemplo: busque='"displayName:John"' para encontrar usuários chamados John

• Obtenha userPrincipalName ou ID de objeto a partir dos resultados

Obter detalhes do usuário

• Use mcp_graph_getUserProfile com userIdentifier
• Escolha Propriedades para obter detalhes específicos.
• Use expandir para incluir gerente ou diretoReports

Sobre a estrutura organizacional

• Use mcp_graph_getUsersManager para obter um gerenciador de usuários
• Use mcp_graph_getDirectReports para obter os subordinados diretos de um usuário
• Chamadas em cadeia para navegar pela hierarquia de relatórios