Справочник по серверу MCP профиля пользователя Microsoft 365

Это важно

Чтобы получить ранний доступ к Microsoft Agent 365, необходимо быть частью программы предварительного просмотра Фронтир. Frontier напрямую подключает вас к последним инновациям ИИ от Microsoft. Получите практический опыт с прорывными функциями, делитесь своими впечатлениями с продуктовыми командами и помогите сформировать будущее Искусственного интеллекта. Предпросмотры Frontier подчиняются существующим условиям предварительного просмотра в рамках ваших клиентских соглашений. Так как эти функции по-прежнему находятся в разработке, их доступность и возможности могут меняться со временем.

Обзор

Идентификатор сервера	Показать имя	Description
mcp_MeServer	Сервер MCP профиля пользователя Microsoft 365	Сервер MCP для самопознания и осведомленности об организации. Используйте этот сервер MCP для доступа к профилям пользователей в организации и выполнения различных действий, таких как получение профиля, профиля пользователя, руководителя пользователя или прямых отчетов.

Доступные средства

mcp_graph_getDirectReports

Перечислить прямые отчеты указанного пользователя в каталоге. Необходимо указать идентификатор объекта пользователя (GUID) или его User Principal Name (UPN), подобный адресу электронной почты. Не используйте "me" в качестве идентификатора пользователя.

Требуемые параметры:

• userIdentifier: Идентификатор объекта пользователя (GUID) или userPrincipalName (UPN)

Замечание

Не отправляйте 'me' в качестве userIdentifier. Если доступно только отображаемое имя, сначала найдите пользователя, чтобы получить userPrincipalName или идентификатор объекта.

Необязательные параметры

• выбирать: Разделенный запятыми список возвращаемых свойств (например, id,displayName,mail,jobTitle,userPrincipalName)
• Вверх: Количество элементов, возвращаемых на страницу

mcp_graph_getMyManager

Получите менеджера вошедшего в систему пользователя (вызывающий). Эта конечная точка всегда возвращает менеджера текущего контекста пользователя.

Необязательные параметры

• выберите: Список свойств менеджера, разделённых запятыми, для возврата

mcp_graph_getMyProfile

Получите сведения о профиле пользователя, вошедшего в систему (вызывающий объект). Эта конечная точка всегда возвращает профиль текущего контекста пользователя.

Необязательные параметры

• выбирать: Разделенный запятыми список свойств профиля пользователя
• расширять: Расширяйте связанные сущности (например, manager, directReports)

mcp_graph_getUserProfile

Получение профиля указанного пользователя в каталоге. Необходимо указать идентификатор объекта пользователя (GUID) или имя пользователя (UPN), похожее на email. Не используйте "me" в качестве идентификатора пользователя. Вместо этого используйте mcp_graph_getMyProfile для вошедшего в систему пользователя.

Требуемые параметры:

• userIdentifier: Идентификатор объекта пользователя (GUID) или userPrincipalName (UPN)

Замечание

Не отправляйте меня. Если доступно только отображаемое имя, сначала найдите пользователя.

Необязательные параметры

• выбрать: Список пользовательских свойств, разделенных запятыми, для возврата
• расширять: Разверните связанную сущность (manager OR directReports). Вы можете развернуть только одно свойство для каждого запроса.

mcp_graph_getUsersManager

Получить менеджера указанного пользователя в каталоге. Необходимо указать либо идентификатор объекта пользователя (GUID), либо userPrincipalName (в формате электронной почты). Не используйте "me" в качестве идентификатора пользователя. Вместо этого используйте mcp_graph_getMyManager для вошедшего пользователя.

Требуемые параметры:

• userIdentifier: Идентификатор объекта пользователя (GUID) или userPrincipalName (UPN)

Замечание

Не отправляйте меня. Если доступно только отображаемое имя, сначала найдите пользователя.

Необязательные параметры

• выбирать: Разделенный запятыми список свойств, возвращаемых для диспетчера (например, id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Получение списка пользователей в организации. Поддерживает такие параметры запросов, как $select, $filter, $top, $orderby. Значение ConsistencyLevel по умолчанию установлено как eventual.

Необязательные параметры

• Топ: Показывать только n первых пользователей
• выбрать: Список пользовательских свойств, разделенных запятыми, для возврата
• фильтр: Фильтрация пользователей по свойству (например, startswith(displayName,'A))
• orderby: Упорядочить результаты по заданному свойству (например, displayName)
• искать: Полнотекстовый поиск по пользователям. Формат: 'свойство:value', например 'displayName:Neha', для поиска отображаемых имен, содержащих 'Neha'. Поддерживает несколько свойств с пробелами. Резервное правило: если $search завершается ошибкой или не возвращает результатов, автоматически повторите попытку с $filter.
• считать: Включение количества элементов ("true" или "false" )
• ConsistencyLevel: Обязательный заголовок для расширенных запросов (по умолчанию: "в конечном итоге" )

Ключевые особенности

Самопознание

• Получение профиля пользователя, выполнившего вход
• Получите руководителя вошедшего в систему пользователя.
• Доступ к текущим сведениям о контексте пользователя
• Нет необходимости в идентификаторах пользователей

Профили пользователей

• Получение профиля любого пользователя по идентификатору или имени пользователя (UPN)
• Доступ к свойствам пользователя (displayName, mail, jobTitle и т. д.)
• Раскройте связанные сущности (менеджер, напрямую подчиненные)
• Выбор свойства с помощью $select

Иерархия организации

• Получить руководителя пользователя
• Получение прямых отчетов пользователя
• Навигация по структуре отчетов
• Связи менеджера и подчинённого

Обнаружение пользователей

• Перечисление пользователей в организации
• Поиск свободного текста с автоматическим резервным возвратом
• Фильтрация и сортировка OData
• Поддержка разбивки на страницы
• Подсчет пользователей в результатах

Возможности запроса

• OData $select для выбора свойств
• OData $filter для фильтрации пользователей
• OData $expand для связанных сущностей
• OData $orderby для сортировки
• Поисковый запрос в свободной форме $search с резервным методом
• Поддержка конечной согласованности

Примечания.

1. Используйте mcp_graph_getMyProfile для входа пользователя, а не mcp_graph_getUserProfile со "мной"
2. Используйте mcp_graph_getMyManager для руководителя вошедшего в систему пользователя
3. userIdentifier должен быть идентификатором объекта (GUID) или userPrincipalName (UPN), а не отображаемым именем
4. Если доступно только отображаемое имя, используйте mcp_graph_listUsers для поиска пользователя в первую очередь
5. $expand может развернуть только одно свойство в одном запросе (manager OR directReports)
6. $search имеет автоматический возврат к $filter, если поиск завершается ошибкой
7. Уровень согласованности «отложенная» требуется для расширенных запросов
8. Формат поиска: «"свойство:значение"», в кавычках

Распространенные варианты использования

Получить мои данные

• Использование mcp_graph_getMyProfile для получения профиля текущего пользователя
• Используйте mcp_graph_getMyManager для получения руководителя текущего пользователя

2. Поиск пользователя

• Использование mcp_graph_listUsers с параметром поиска

  Пример: search="displayName:John", чтобы найти пользователей с именем Джон

• Получение идентификатора userPrincipalName или объекта из результатов

3. Получение сведений о пользователе

• Используйте mcp_graph_getUserProfile с userIdentifier
• Использование выбора для получения определенных свойств
• Используйте расширение для включения менеджера или подчинённых.

4. Получение организационной структуры

• Используйте mcp_graph_getUsersManager, чтобы получить руководителя пользователя
• Использование mcp_graph_getDirectReports для получения прямых отчетов пользователя
• Цепочка вызовов для перемещения по структуре отчетности