중요
Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.
개요
| 서버 ID입니다. | 표시 이름 | 설명 |
|---|---|---|
| mcp_MeServer | Microsoft 365 사용자 프로필 MCP 서버 | 자기 지식 및 조직 인식을 위한 MCP 서버입니다. 이 MCP 서버를 사용하여 조직의 사용자 프로필에 액세스하고 프로필 가져오기, 사용자 프로필, 사용자 관리자 또는 직접 보고서 가져오기와 같은 다양한 작업을 수행합니다. |
사용 가능한 도구
mcp_graph_getDirectReports
디렉터리에 지정된 사용자의 직접 보고서를 나열합니다. 사용자의 GUID(개체 ID) 또는 해당 userPrincipalName(전자 메일과 같은 UPN)을 제공해야 합니다. userIdentifier로 'me'를 사용하지 마세요.
필수 매개 변수:
- userIdentifier: 사용자의 개체 ID(GUID) 또는 USERPrincipalName(UPN)
참고
userIdentifier로 'me'를 보내지 마세요. 표시 이름만 사용할 수 있는 경우 먼저 사용자를 조회하여 userPrincipalName 또는 개체 ID를 가져옵니다.
선택적 매개 변수
- select: 반환할 속성의 쉼표로 구분된 목록(예: id,displayName,mail,jobTitle,userPrincipalName)
- top: 페이지당 반환할 항목 수
mcp_graph_getMyManager
로그인한 사용자(호출자)의 관리자를 검색합니다. USER는 항상 현재 컨텍스트의 이름을 반환합니다.
선택적 매개 변수
- select: 반환할 관리자 속성의 쉼표로 구분된 목록
mcp_graph_getMyProfile
로그인한 사용자(호출자)의 프로필 세부 정보를 검색합니다. USER는 항상 현재 컨텍스트의 이름을 반환합니다.
선택적 매개 변수
- select: 사용자 프로필 속성의 쉼표로 구분된 목록
- expand: 관련 엔터티 확장(예: 관리자, directReports)
mcp_graph_getUserProfile
디렉터리에서 지정된 사용자의 프로필을 검색합니다. 사용자의 GUID(개체 ID) 또는 해당 userPrincipalName(전자 메일과 같은 UPN)을 제공해야 합니다. 'me'를 userIdentifier로 사용하지 마세요. 로그인한 사용자 대신 mcp_graph_getMyProfile 사용합니다.
필수 매개 변수:
- userIdentifier: 사용자의 개체 ID(GUID) 또는 USERPrincipalName(UPN)
참고
'나'를 보내지 마십시오. 표시 이름만 사용할 수 있는 경우 먼저 사용자를 조회합니다.
선택적 매개 변수
- select: 반환할 사용자 속성의 쉼표로 구분된 목록
- expand: 관련 엔터티(관리자 또는 directReports)를 확장합니다. 요청당 하나의 속성만 확장할 수 있습니다.
mcp_graph_getUsersManager
디렉터리에서 지정된 사용자의 관리자를 검색합니다. 사용자의 GUID(개체 ID) 또는 해당 userPrincipalName(전자 메일과 같은 UPN)을 제공해야 합니다. 'me'를 userIdentifier로 사용하지 마세요. 로그인한 사용자 대신 mcp_graph_getMyManager 사용합니다.
필수 매개 변수:
- userIdentifier: 사용자의 개체 ID(GUID) 또는 USERPrincipalName(UPN)
참고
'나'를 보내지 마십시오. 표시 이름만 사용할 수 있는 경우 먼저 사용자를 조회합니다.
선택적 매개 변수
- select: 관리자에 대해 반환할 쉼표로 구분된 속성 목록(예: id,displayName,mail,jobTitle,userPrincipalName)
mcp_graph_listUsers
조직의 사용자 목록 가져오기 $select, $filter, $top, $orderby 같은 쿼리 옵션을 지원합니다. ConsistencyLevel은 기본적으로 최종값으로 설정됩니다.
선택적 매개 변수
- top: 첫 번째 n 사용자만 표시
- select: 반환할 사용자 속성의 쉼표로 구분된 목록
- 필터: 속성별로 사용자 필터링(예: startswith(displayName,'A'))
- orderby: 지정된 속성별 결과 정렬(예: displayName)
- 검색: 사용자를 자유 텍스트로 검색합니다. 형식: '"property:value"', 예: '"displayName:Neha"' - 'Neha'가 포함된 표시 이름을 검색합니다. 공백이 있는 여러 속성을 지원합니다. 대체 규칙: $search 실패하거나 결과를 반환하지 않으면 $filter 사용하여 자동으로 다시 시도합니다.
- count: 항목 수 포함('true' 또는 'false')
- ConsistencyLevel: 고급 쿼리에 필요한 헤더(기본값: 'eventual')
주요 특징
자기 지식
- 로그인한 사용자의 프로필 가져오기
- 로그인한 사용자의 관리자 가져오기
- 현재 사용자 컨텍스트 정보에 액세스
- 사용자 식별자가 필요하지 않습니다.
사용자 프로필
- ID 또는 UPN을 사용하여 사용자의 프로필 검색
- 사용자 속성에 액세스(displayName, 메일, jobTitle 등)
- 관련 엔터티 확장(관리자, directReports)
- $select 있는 속성 선택
조직 계층
- 사용자 관리자 가져오기
- 사용자의 직접 보고서 가져오기
- 보고 구조 탐색
- 관리자 및 직접 보고서 관계
사용자 검색
- 조직의 사용자 나열
- 자동 대체를 사용하는 자유 텍스트 검색
- OData 필터링 및 순서 지정
- 페이지 매김 지원
- 결과에서 사용자 수 계산
쿼리 기능
- 속성 선택에 대한 OData $select
- 사용자 필터링을 위한 OData $filter
- 관련 엔터티에 대한 OData $expand
- 정렬을 위한 OData $orderby
- 대체가 있는 자유 텍스트 $search
- 최종 일관성 지원
노트
- 'me'로 mcp_graph_getUserProfile 않고 로그인한 사용자에 mcp_graph_getMyProfile 사용
- 로그인한 사용자의 관리자에 mcp_graph_getMyManager 사용
- userIdentifier는 표시 이름이 아닌 GUID(개체 ID) 또는 USERPrincipalName(UPN)이어야 합니다.
- 표시 이름만 사용할 수 있는 경우 mcp_graph_listUsers 사용하여 사용자를 먼저 조회합니다.
- $expand 요청당 하나의 속성만 확장할 수 있습니다(관리자 OR directReports).
- $search 검색에 실패할 경우 $filter 자동 대체가 있습니다.
- 고급 쿼리에 필요한 ConsistencyLevel '최종'
- 검색 형식: 따옴표가 있는 '"property:value"'
일반 사용 예
VM 정보 가져오기
- mcp_graph_getMyProfile 사용하여 현재 사용자의 프로필 가져오기
- mcp_graph_getMyManager 사용하여 현재 사용자의 관리자 가져오기
2. 사용자 찾기
검색 매개 변수와 함께 mcp_graph_listUsers 사용
예: search='"displayName:John"' - John이라는 사용자를 찾습니다.
결과에서 userPrincipalName 또는 개체 ID 가져오기
사용자 세부 정보 가져오기
- userIdentifier에서 mcp_graph_getUserProfile 사용
- 속성을 선택하여 특정 세부 정보를 가져옵니다.
- expand을 사용하여 관리자 또는 directReports 포함
조직 구조 정보
- mcp_graph_getUsersManager 사용하여 사용자의 관리자 가져오기
- mcp_graph_getDirectReports 사용하여 사용자의 직접 보고서 가져오기
- 보고 계층을 탐색하기 위한 호출 연결