중요
Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.
개요
| 서버 ID입니다. | 표시 이름 | 설명 |
|---|---|---|
| mcp_ODSPRemoteServer | Microsoft SharePoint 및 OneDrive | SHAREPoint 및 OneDrive 콘텐츠 작업을 위한 도구를 제공하는 MCP 서버. 이 서버는 테넌트별 SharePoint Online MCP 서버에 연결합니다. ODSP MCP 엔드포인트에서 노출하는 OneDrive 및 SharePoint 파일 통합을 지원하는 모든 도구를 자동으로 검색하고 사용할 수 있습니다. |
사용 가능한 도구
CreateFolder
지정된 문서 라이브러리 내에 지정된 부모 폴더의 자식으로 새 폴더를 만듭니다. 문서 라이브러리를 지정하지 않으면 서버에서 사용자의 OneDrive를 사용합니다. 부모 폴더를 지정하지 않으면 서버에서 루트에 폴더를 만듭니다. 이름이 같은 폴더가 이미 있는 경우 서버는 숫자 접미사가 있는 새 폴더를 만듭니다(예: NewFolder (1).).
필수 매개 변수:
-
folderName(string) – 만들 폴더의 이름입니다. 이름이 같은 폴더가 이미 있는 경우 서버는 새 폴더 이름(예:
NewFolder (1).)에 숫자 접미사를 추가합니다. -
documentLibraryId(string) – 폴더를 만들 문서 라이브러리(드라이브라고도 함)의 ID입니다. 사용자의 드라이브 또는 OneDrive(예: "내 드라이브" 또는 "내 onedrive")에 폴더를 만들려면 다음으로
documentLibraryId보냅니"me"다.
선택적 매개 변수
- parentFolderId(string, default = "root") – 새 폴더를 만들 상위 폴더의 ID입니다. 지정하지 않으면 기본적으로 문서 라이브러리의 루트로 설정됩니다.
findSite
사용자가 액세스할 수 있는 SharePoint 사이트를 찾습니다. 이 도구는 사용자가 제공한 검색 쿼리를 기반으로 특정 사이트를 찾거나 검색 쿼리를 제공하지 않는 경우 사용자가 액세스할 수 있는 상위 20개의 관련 사이트를 찾을 수 있습니다.
필수 매개 변수:
없음
선택적 매개 변수
-
searchQuery(string, default = null) – 전체 또는 부분 사이트 이름이 될 수 있는 검색 쿼리입니다. 검색 쿼리를 제공하면 사용자가 특정 사이트를 찾는 경우에만 사이트를 효율적으로 검색할 수 있습니다. 예를 들어 사용자가 호출
xyz된 사이트를 요청하는 경우 다음으로 전달xyz됩니다searchQuery. 사용자가 "내 사이트"를 요청하는 경우 이 매개 변수를 비워 둡니다.
listDocumentLibrariesInSite
지정한 SharePoint 사이트의 문서 라이브러리(드라이브라고도 함)를 나열합니다. 사이트를 지정하지 않으면 서버에서 루트 사이트를 사용합니다.
필수 매개 변수:
없음
선택적 매개 변수
- siteId: 사이트 ID(기본값: 루트)
findFileOrFolder
사용자가 검색 쿼리를 전달하여 액세스할 수 있는 파일 또는 폴더(DriveItem이라고도 함)를 찾습니다.
필수 매개 변수:
- searchQuery: 전체 또는 부분 파일 이름이 될 수 있는 검색 쿼리
renameFileOrFolder
지정된 문서 라이브러리 내에서 파일 또는 폴더(DriveItems라고도 함)의 이름을 바꿉니다. 참고: 새 이름은 명명 규칙을 준수해야 합니다.
필수 매개 변수:
- documentLibraryId: 문서 라이브러리 ID (문자열)
- fileOrFolderId: 파일 또는 폴더 ID (문자열)
- newFileOrFolderName: 파일 또는 폴더 의 새 이름(문자열)
deleteFileOrFolder
지정된 문서 라이브러리에서 파일 또는 폴더를 삭제합니다.
필수 매개 변수:
- documentLibraryId: 문서 라이브러리 ID (문자열)
- fileOrFolderId: 파일 또는 폴더 ID (문자열)
readSmallTextFile
특정 문서 라이브러리에서 텍스트 파일을 읽어(다운로드)합니다. 문서 라이브러리를 지정하지 않으면 사용자의 OneDrive가 사용됩니다. 파일을 식별하고 다운로드하려면 fileId(파일의 driveItemId)를 제공해야 합니다.
필수 매개 변수:
- fileId(string)
- documentLibraryId(string) – 읽을 파일의 문서 라이브러리(드라이브라고도 함)의 ID입니다. 예를 들어 사용자가 드라이브 또는 Onedrive에서 파일을 읽거나 다운로드하도록 요청하는 경우 - "내 드라이브"에서 파일을 읽으려면 "my onedrive"에서 documentLibraryId로 "me"로 보내야 하는 파일을 읽습니다.
moveSmallFile
지정한 문서 라이브러리에 있는 파일을 다른 폴더로 이동합니다. 이 도구는 5MB 미만의 파일 및 동일한 사이트 내에 있는 이동에 대해서만 이동을 지원합니다. 이 요청을 사용하여 드라이브 간에 파일을 이동할 수 없습니다.
필수 매개 변수:
- documentLibraryId(string) – 이동하려는 파일의 문서 라이브러리(드라이브라고도 함)의 ID입니다. 예를 들어 사용자가 드라이브 또는 Onedrive에서 파일을 이동하도록 요청하는 경우 - "내 드라이브"에서 파일을 이동하려면 "me"에서 documentLibraryId로 보내야 하는 "my onedrive"의 파일을 이동합니다.
- fileId(string) – 이동할 파일의 ID
- newParentFolderId(string) – 파일을 이동할 대상 폴더의 ID입니다. 파일의 원래 위치와 동일한 문서 라이브러리에 있어야 합니다.
getFileOrFolderMetadata
Sharepoint 사이트의 지정된 문서 라이브러리에서 파일 또는 폴더의 메타데이터를 가져옵니다.
필수 매개 변수:
- FileOrFolderId(string) – 파일 또는 폴더의 ID입니다. DriveItems라고도 합니다. 또한 ID를 driveItemId라고도 합니다.
- documentLibraryId(string) – 메타데이터가 필요한 파일 또는 폴더의 문서 라이브러리(드라이브라고도 함)의 ID입니다. 사용자가 "내 드라이브에 있는 파일의 메타데이터 가져오기" 또는 "내 onedrive에 있는 폴더의 메타데이터 가져오기"와 같이 드라이브 또는 Onedrive에서 파일 또는 폴더를 가져와야 하는 경우 documentLibraryId로 "me"로 보내야 합니다.
createSmallTextFile
5MB보다 작은 텍스트 파일을 만들거나 특정 문서 라이브러리에 업로드합니다. 문서 라이브러리를 지정하지 않으면 사용자의 OneDrive가 사용됩니다. 다음과 같이 특정 파일을 업로드할 수 있습니다. 폴더를 지정하지 않으면 파일이 루트 폴더에 업로드됩니다.
필수 매개 변수:
- filename (string) – 만들 파일의 이름
- contentText (문자열) – 만들 파일의 텍스트 콘텐츠
- documentLibraryId (문자열) – 파일에 대한 문서 라이브러리(드라이브라고도 함)의 ID입니다. 사용자가 자신의 드라이브 또는 OneDrive에 파일을 만들도록 요청하는 경우(예: "내 드라이브에 파일 만들기" 또는 "내 onedrive에 파일 만들기") documentLibraryId로 "me"를 보냅니다.
선택적 매개 변수
- parentfolderId(string, default = "root") – 드라이브 내의 폴더 ID를 사용하여 새 파일을 추가합니다.
getFileOrFolderMetadataByUrl
공유 URL에서 파일 또는 폴더에 대한 메타데이터를 가져옵니다. 파일에 액세스할 수 있는 명시적 권한이 있는 사용자만 메타데이터를 가져올 수 있습니다.
필수 매개 변수:
- fileOrFolderUrl:(string) – 파일 또는 폴더의 URL(DriveItems라고도 함). URL은 사용자와 공유하기 위해 교환되지 않습니다. 파일에 대한 명시적 액세스 권한이 이미 있어야 합니다.
shareFileOrFolder
공유 초대를 보내 지정된 문서 라이브러리 내의 파일 또는 폴더에 대한 권한을 부여합니다. 역할 할당 및 받는 사람 알림 지원
필수 매개 변수:
- documentLibraryId: 문서 라이브러리 ID (문자열, 필수)
- fileOrFolderId: 파일 또는 폴더 ID (문자열, 필수)
- recipientEmails:(string[], Required) – 초대할 받는 사람의 전자 메일 주소입니다. 받는 사람 전자 메일이 하나 이상 필요합니다.
선택적 매개 변수
- roles(string[]) – 받는 사람에게 할당할 역할입니다. 허용되는 값: 읽기, 쓰기(쓰기 권한 모두 읽기 및 쓰기 권한 부여) 는 지정하지 않으면 기본적으로 으로 설정됩니다.
- sendInvitation(bool, default = true) – 공유 초대를 보낼지 여부를 나타냅니다. 는 지정하지 않으면 기본적으로 으로 설정됩니다.
- message(string, default = "여기에 공동 작업 중인 파일이 있습니다.") – 초대 전자 메일에 포함할 사용자 지정 메시지입니다. 지정하지 않으면 기본적으로 표준 메시지로 설정됩니다.
getFolderChildren
문서 라이브러리의 지정된 부모 폴더 내에 있는 상위 20개 파일 및 폴더를 열거합니다. 문서 라이브러리를 지정하지 않으면 사용자의 OneDrive가 사용됩니다.
필수 매개 변수:
- documentLibraryId(string) – 부모 폴더에 대한 문서 라이브러리(드라이브라고도 함)의 ID입니다. 사용자가 드라이브 또는 OneDrive의 폴더에 있는 파일(예: "내 드라이브의 폴더에 있는 파일 가져오기" 또는 "내 onedrive의 폴더에 있는 파일 가져오기")을 요청하면 documentLibraryId로 "me"를 보냅니다.
선택적 매개 변수
- parentFolderId:(string, default = "root") – 파일 및 폴더가 나열된 부모 폴더(DriveItem)의 ID입니다. 지정하지 않으면 기본적으로 문서 라이브러리의 루트 폴더로 설정됩니다.
에코
클라이언트에 메시지를 보냅니다.
필수 매개 변수:
- 메시지: 다시 보낼 메시지
setSensitivityLabelOnFile
지정된 문서 라이브러리에서 파일의 민감도 레이블을 설정합니다.
필수 매개 변수:
- documentLibraryId(string) – 문서 라이브러리의 문서 라이브러리 ID(driveId라고도 함)
- fileId(string) – 파일의 파일 ID(driveItemId라고도 함)
- sensitivityLabelId(string) – 필수 요소입니다. 할당할 민감도 레이블의 ID이거나 민감도 레이블을 제거할 빈 문자열입니다.
선택적 매개 변수
- assignmentMethod(string, default = "privileged") - 문서에 있는 레이블의 할당 메서드입니다. 레이블 할당이 자동으로, 표준 또는 권한 있는 작업(관리자 작업과 동일)으로 수행되었는지 여부를 나타냅니다. 가능한 값은 표준, 권한 있는 값, 자동 및 unknownFutureValue입니다.
- justificationText(string, default = "Changed by MCPServer") – 선택 사항입니다. 감사용 근거 텍스트이며 레이블을 다운그레이드하거나 제거할 때 필요합니다.
getDefaultDocumentLibraryInSite
SharePoint 사이트에서 기본 문서 라이브러리(드라이브라고도 함)를 가져옵니다. 사이트를 지정하지 않으면 루트 사이트가 사용됩니다.
필수 매개 변수:
없음
선택적 매개 변수
- siteId: 사이트 ID(기본값: 루트)
주요 특징
폴더 관리
- 자동 명명 충돌 해결을 사용하여 폴더 만들기
- 폴더 자식 열거(상위 20개)
- 폴더 간 파일 이동(동일한 사이트 내)
파일 작업
- 작은 텍스트 파일 만들기 및 업로드(< 5MB)
- 텍스트 파일 읽기 및 다운로드
- 파일 및 폴더 찾기
- 파일 및 폴더 삭제
- ID 또는 URL로 파일 및 폴더 메타데이터 가져오기
사이트 및 라이브러리 검색
- 검색 쿼리로 SharePoint 사이트 찾기
- 사이트의 문서 라이브러리 나열
- 기본 문서 라이브러리 가져오기
공유 및 권한
- 역할 할당을 사용하여 파일 및 폴더 공유
- 사용자 지정 메시지를 사용하여 공유 초대 보내기
- 명시적 권한을 통한 액세스 제어
보안 및 규정 준수
- 파일에 민감도 레이블 설정
- 권한 있는, 표준 및 자동 할당 방법에 대한 지원
- 규정 준수 감사를 위한 근거 텍스트
통합
- OneDrive 및 SharePoint Online 지원
- 테넌트별 서버 연결
- 파일 및 폴더에 대한 DriveItem 추상화
노트
- 기본 문서 라이브러리는 'me'(사용자의 OneDrive)입니다.
- 기본 부모 폴더는 'root'입니다.
- 숫자 접미사로 해결된 폴더 이름 충돌
- 파일 이동이 5MB 미만으로 제한되고 동일한 사이트 내에서
- URL을 공유하려면 명시적 액세스 권한이 필요합니다.
- DriveItems는 파일과 폴더를 모두 나타냅니다.
- 폴더 자식 열거형의 상위 20개 제한