Referencia de usuario de Work IQ (versión preliminar)

Importante

• Esta es una función de vista previa.
• Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a términos de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan obtener acceso temprano y brindar comentarios.

Información general

Id. de servidor	Nombre para mostrar	Descripción
mcp_MeServer	Usuario de Work IQ	Servidor MCP para el autoconocimiento y la conciencia organizacional. Usa este servidor MCP para acceder a los perfiles de usuario de su organización y realizar diversas acciones, como obtener su perfil, el perfil de un usuario, el supervisor de un usuario o los subordinados 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 el nombre de visualización está disponible, primero busque al usuario para obtener el userPrincipalName o el ID de 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 (la persona que llama). Este extremo siempre devuelve el administrador del contexto de usuario actual.

Parámetros opcionales:

• select: lista de propiedades del administrador separada por comas 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 utilices 'yo' como el userIdentifier; utiliza mcp_graph_getMyProfile en su lugar para el usuario conectado.

Parámetros requeridos:

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

Nota

No me envíes. 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 utilices 'yo' como el userIdentifier; utiliza mcp_graph_getMyManager en su lugar para el usuario conectado.

Parámetros requeridos:

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

Nota

No me envíes. 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_listarUsuarios

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:

• Arriba: 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: Ordenar los resultados por la propiedad dada, como displayName
• search: búsqueda de texto libre para los usuarios. Formato: "property:value", como displayName:Neha para buscar nombres para mostrar que contengan Neha. Admite varias propiedades con espacios. Regla de reserva: si $search falla o no devuelve ningún resultado, se intentará automáticamente nuevamente con $filter.
• count: Incluir 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
• Acceder 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 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 y subordinado directo

Descubrimiento por parte del usuario

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

Funciones de consultas

• $select de OData para seleccionar 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 opción de respaldo
• Compatibilidad con la coherencia final

Notas

• Usar mcp_graph_getMyProfile para el usuario que ha iniciado sesión, no mcp_graph_getUserProfileconmigo
• Uso mcp_graph_getMyManager para el gestor de usuarios con inicio de sesión
• userIdentifier debe ser un identificador de objeto (GUID) o userPrincipalName (UPN), no utilice un nombre de visualización.
• Si solo hay nombre para mostrar disponible, usa mcp_graph_listUsers para buscar al usuario primero.
• $expand solo puede expandir una propiedad por solicitud (manager o directReports)
• $search tiene un retroceso automático a $filter si la búsqueda falla
• ConsistencyLevel eventual necesario para 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
• Usa mcp_graph_getMyManager para obtener el gestor del usuario actual

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 ID del objeto a partir de resultados

3. Obtener detalles de usuario

• Uso de mcp_graph_getUserProfile con userIdentifier
• Utiliza "selecciona" para obtener propiedades específicas
• Utilice expandir para incluir manager o directReports

4. Obtener estructura organizativa

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