Perfil de usuario de Microsoft 365 Referencia del servidor MCP

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	Perfil de usuario de Microsoft 365 servidor MCP	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. Debes proporcionar el ID de objeto (GUID) del usuario o su userPrincipalName UPN (tipo correo electrónico). No uses 'yo' como el userIdentifier.

Parámetros requeridos:

• Identificador de usuario: ID de objeto del usuario (GUID) o userPrincipalName (UPN)

Nota

No envíes 'me' como userIdentifier. Si solo hay nombre de visualización disponible, primero busca el usuario para obtener userPrincipalName el ID de un objeto.

Parámetros opcionales:

• seleccionar: Lista separada por comas de propiedades que deben 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
• Ampliar: Expande tablas relacionadas (por ejemplo, gestor, directReports)

mcp_graph_getUserProfile

Recupere el perfil de un usuario especificado en el directorio. Debes proporcionar el ID de objeto (GUID) del usuario o su userPrincipalName UPN (tipo correo electrónico). No uses 'yo' como userIdentifier el - úsalo mcp_graph_getMyProfile en su lugar para el usuario que ha iniciado sesión.

Parámetros requeridos:

• Identificador de usuario: ID 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
• Ampliar: Amplía una tabla relacionada (manager O directReports). Solo puede expandir una propiedad por solicitud.

mcp_graph_getUsersManager

Recupere el administrador de un usuario especificado en el directorio. Debes proporcionar el ID de objeto (GUID) del usuario o su userPrincipalName UPN (tipo correo electrónico). No uses 'yo' como userIdentifier el - úsalo mcp_graph_getMyManager en su lugar para el usuario que ha iniciado sesión.

Parámetros requeridos:

• Identificador de usuario: ID 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:

• seleccionar: Lista separada por comas de propiedades que devolver al administrador, como 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 está configurado como eventual por defecto.

Parámetros opcionales:

• top: mostrar solo los primeros n usuarios
• select: lista separada por comas de propiedades de usuario que se van a devolver
• Filtrar: Filtra usuarios por propiedad, como startswith(displayName,'A')
• ordenar: El orden resulta por propiedad dada, como displayName
• search: búsqueda de texto libre para los usuarios. Formato: "property:value", por ejemplo "displayName:Neha" , buscar nombres de visualización que contengan 'Neha'. Admite varias propiedades con espacios. Regla de respaldo: Si $search falla o no devuelve resultados, intenta 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
• Acceder a las propiedades de usuario (displayName, mail, jobTitle, etc.)
• Expandir tablas relacionadas (manager, 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

Descubrimiento por parte del usuario

• 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

Funciones de consultas

• $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

• Úsalo mcp_graph_getMyProfile para usuarios conectados, no mcp_graph_getUserProfile con 'yo'
• Uso mcp_graph_getMyManager para el gestor de usuarios con inicio de sesión
• userIdentifier debe ser el ID de objeto (GUID) o userPrincipalName (UPN), no use nombre de visualización
• Si solo hay nombre de usuario disponible, primero mcp_graph_listUsers busca al usuario
• $expand solo puede ampliar una propiedad por solicitud (manager o directReports)
• $search tiene reserva automática en $filter si se produce un error en la búsqueda
• ConsistencyLevel 'eventual' necesario para las consultas avanzadas
• Formato de búsqueda: '"property:value"' con comillas

Casos de uso comunes

Obtener mi información

• Úsalo mcp_graph_getMyProfile para obtener el perfil del usuario actual
• Úsalo mcp_graph_getMyManager para obtener el gestor de usuarios actuales

Búsqueda de un usuario

• Uso mcp_graph_listUsers con parámetro de búsqueda

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

• Obtener userPrincipalName o identificar objetos a partir de resultados

3. Obtener detalles de usuario

• Uso de mcp_graph_getUserProfile con userIdentifier
• Use seleccionar para obtener propiedades específicas
• Usar expandir para incluir manager o directReports

4. Obtener estructura organizativa

• Úsalo mcp_graph_getUsersManager para conseguir un gestor de usuario
• Úsalos mcp_graph_getDirectReports para obtener los subordinados directos de un usuario
• Cadenas de llamadas para navegar por la jerarquía de informes