Referencia de servidor MCP de perfil de usuario de Microsoft 365

Importante

Debe formar parte del programa de versión preliminar de Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Información general

Id. de servidor	Nombre	Descripción
mcp_MeServer	Servidor MCP de perfil de usuario de Microsoft 365	Servidor MCP para el conocimiento propio y la conciencia de la organización. Use este servidor MCP para acceder a los perfiles de usuario de su organización y realizar diversas acciones, como obtener el perfil, el perfil de un usuario, el administrador de un usuario o los informes directos.

Herramientas disponibles

mcp_graph_getDirectReports

Enumera los informes directos de un usuario especificado en el directorio. Debe proporcionar el identificador de objeto (GUID) del usuario o su userPrincipalName (UPN similar al correo electrónico). No use "me" como userIdentifier.

Parámetros requeridos:

• userIdentifier: identificador de objeto del usuario (GUID) o userPrincipalName (UPN)

Nota

No envíe "me" como userIdentifier. Si solo hay un nombre para mostrar disponible, busque primero el usuario para obtener userPrincipalName o el identificador de objeto.

Parámetros opcionales:

• select: lista separada por comas de propiedades que se van a devolver (por ejemplo, id,displayName,mail,jobTitle,userPrincipalName)
• top: número de elementos que se van a devolver por página

mcp_graph_getMyManager

Recupere el administrador del usuario que ha iniciado sesión (el autor de la llamada). Este punto de conexión siempre devuelve el administrador del contexto de usuario actual.

Parámetros opcionales:

• select: lista separada por comas de administrador propiedades que se van a devolver

mcp_graph_getMyProfile

Recupere los detalles del perfil del usuario que ha iniciado sesión (el autor de la llamada). Este punto de conexión siempre devuelve el perfil del contexto de usuario actual.

Parámetros opcionales:

• select: lista separada por comas de propiedades de perfil de usuario
• expand: expanda entidades relacionadas (por ejemplo, administrador, directReports)

mcp_graph_getUserProfile

Recupere el perfil de un usuario especificado en el directorio. Debe proporcionar el identificador de objeto (GUID) del usuario o su userPrincipalName (UPN similar al correo electrónico). No use "me" como userIdentifier: use mcp_graph_getMyProfile en su lugar para el usuario que ha iniciado sesión.

Parámetros requeridos:

• userIdentifier: identificador de objeto del usuario (GUID) o userPrincipalName (UPN)

Nota

No envíe "me". Si solo hay un nombre para mostrar disponible, busque primero el usuario.

Parámetros opcionales:

• select: lista separada por comas de propiedades de usuario que se van a devolver
• expand: expanda una entidad relacionada (administrador O directReports). Solo puede expandir una propiedad por solicitud.

mcp_graph_getUsersManager

Recupere el administrador de un usuario especificado en el directorio. Debe proporcionar el identificador de objeto (GUID) del usuario o su userPrincipalName (UPN similar al correo electrónico). No use "me" como userIdentifier: use mcp_graph_getMyManager en su lugar para el usuario que ha iniciado sesión.

Parámetros requeridos:

• userIdentifier: identificador de objeto del usuario (GUID) o userPrincipalName (UPN)

Nota

No envíe "me". Si solo hay un nombre para mostrar disponible, busque primero el usuario.

Parámetros opcionales:

• select: lista separada por comas de propiedades que se van a devolver del administrador (por ejemplo, id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Recupere una lista de usuarios en la organización. Admite opciones de consulta como $select, $filter, $top $orderby. ConsistencyLevel se establece en eventual de forma predeterminada.

Parámetros opcionales:

• top: mostrar solo los primeros n usuarios
• select: lista separada por comas de propiedades de usuario que se van a devolver
• filter: filtre los usuarios por propiedad (por ejemplo, startswith(displayName,'A'))
• orderby: ordene los resultados por propiedad especificada (por ejemplo, displayName)
• search: búsqueda de texto libre para los usuarios. Formato: '"property:value"', por ejemplo, '"displayName:Neha"' para buscar nombres para mostrar que contienen 'Neha'. Admite varias propiedades con espacios. Regla de reserva: si $search produce un error o no devuelve ningún resultado, vuelva a intentarlo automáticamente con $filter.
• count: incluir el recuento de elementos ("true" o "false")
• ConsistencyLevel: encabezado obligatorio para consultas avanzadas (valor predeterminado: 'eventual')

Características clave

Autoconocimiento

• Obtener el perfil del usuario que ha iniciado sesión
• Obtener el administrador del usuario que ha iniciado sesión
• Acceso a la información de contexto del usuario actual
• No es necesario usar identificadores de usuario

Perfiles de usuario

• Recuperar el perfil de cualquier usuario por identificador o UPN
• Obtener acceso a las propiedades de usuario (displayName, mail, jobTitle, etc.)
• Expandir entidades relacionadas (administrador, directReports)
• Selección de propiedades con $select

Jerarquía organizativa

• Obtener el administrador del usuario
• Obtención de informes directos del usuario
• Navegar por la estructura de informes
• Relaciones de administrador e informe directo

Detección de usuarios

• Enumerar usuarios de la organización
• Búsqueda de texto libre con reserva automática
• Filtrado y ordenación de OData
• Compatibilidad con la paginación
• Recuento de usuarios en los resultados

Capacidades de consulta

• $select de OData para la selección de propiedades
• OData $filter para el filtrado de usuarios
• OData $expand para entidades relacionadas
• $orderby de OData para la ordenación
• $search de texto libre con reserva
• Compatibilidad con la coherencia final

Notas

1. Use mcp_graph_getMyProfile para el usuario que ha iniciado sesión, no mcp_graph_getUserProfile con "me"
2. Usar mcp_graph_getMyManager para el administrador del usuario que ha iniciado sesión
3. userIdentifier debe ser el identificador de objeto (GUID) o userPrincipalName (UPN), no el nombre para mostrar
4. Si solo hay un nombre para mostrar disponible, use mcp_graph_listUsers para buscar primero al usuario
5. $expand solo puede expandir una propiedad por solicitud (administrador O directReports)
6. $search tiene reserva automática en $filter si se produce un error en la búsqueda
7. ConsistencyLevel 'eventual' necesario para las consultas avanzadas
8. Formato de búsqueda: '"property:value"' con comillas

Casos de uso comunes

Obtener Mi información

• Usar mcp_graph_getMyProfile para obtener el perfil del usuario actual
• Usar mcp_graph_getMyManager para obtener el administrador del usuario actual

2. Buscar un usuario

• Uso de mcp_graph_listUsers con el parámetro de búsqueda

  Ejemplo: search='"displayName:John"' para buscar usuarios denominados John

• Obtención del identificador de objeto o userPrincipalName de los resultados

3. Obtener detalles de usuario

• Use mcp_graph_getUserProfile con userIdentifier
• Use seleccionar para obtener propiedades específicas
• Uso de expand para incluir el administrador o directReports

4. Obtener estructura organizativa

• Usar mcp_graph_getUsersManager para obtener el administrador de un usuario
• Usar mcp_graph_getDirectReports para obtener los informes directos de un usuario
• Cadenas de llamadas para navegar por la jerarquía de informes