SharePoint 참조 (미리보기)

메모

이 글에서는 표준 하네스로 구동되는 에이전트 또는 에이전트 플로우에서 사용되는 기능에 대해 설명합니다.

Important

미리 보기 기능입니다.

  • Microsoft 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 미리 보기 기능을 릴리스합니다.
  • 미리 보기 기능은 기능이 제한되어 있으며 프로덕션용으로 사용되지 않습니다.
  • Microsoft 미리 보기 MCP 도구 이름 및 매개 변수를 변경할 수 있습니다. 하드 코딩된 종속성을 방지합니다. Microsoft 시나리오 지원을 유지 관리합니다.
  • 미리 보기 기능은 Microsoft 추가 사용 약관 적용됩니다.

메모

애플리케이션 특화 Microsoft 365 MCP 도구들(Copilot, 캘린더, 메일, SharePoint, OneDrive, Teams, User, Word)은 하위 호환성 목적으로만 설계되었으며, 운영 환경이나 새로운 프로젝트에서는 사용하지 않아야 합니다. Microsoft 365 리소스에 접근해야 하는 신규 프로젝트의 경우, GitHub Copilot 하네스와 함께 Work IQ MCP를 사용하세요. 자세한 내용은 Copilot Studio의 Work IQ MCP를 참조하세요.

Overview

서버 ID 테넌트 수준의 URL 표시 이름 Description
mcp_SharePointRemoteServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/servers/
mcp_SharePointRemoteServer		 SharePoint SharePoint 운영용 도구. 이 서버를 사용하여 사이트, 목록, 목록 항목, 열, 문서 라이브러리, 파일, 폴더 및 파일 공유를 관리할 수 있습니다. 파일 작업은 5MB 이하의 파일로 제한됩니다.

사용 가능한 도구

사이트찾기

액세스할 수 있는 SharePoint 사이트를 찾습니다. 검색 쿼리와 일치하는 특정 사이트를 반환하거나 쿼리를 제공하지 않으면 상위 20개 관련 사이트를 반환합니다.

선택적 매개 변수:

  • searchQuery: 검색 쿼리(전체 또는 부분 사이트 이름). 상위 20개의 액세스 가능한 사이트를 반환하지 않습니다.

getSiteByPath

정확한 호스트 이름 및 서버 상대 경로를 사용하여 SharePoint 사이트를 확인합니다. 전체 사이트 URL 구조가 있는 경우에만 이 메서드를 사용합니다. 사이트 이름만 알고 있는 경우에만 사용합니다 findSite .

필수 매개 변수:

  • 호스트: 정확한 호스트 이름(예: 'contoso.sharepoint.com')
  • serverRelativePath: 서버 상대 경로(예: 'sites/Marketing') 선행 슬래시는 선택 사항입니다.

하위 사이트 목록

SharePoint 사이트의 모든 하위 사이트(자식 사이트)를 나열합니다.

필수 매개 변수:

  • 부모 SharePoint 사이트의 siteId: ID(형식: 'hostname,siteCollectionId,webId')

사이트의 문서 라이브러리 목록

지정한 SharePoint 사이트의 문서 라이브러리(드라이브)를 나열합니다.

선택적 매개 변수:

  • SharePoint 사이트의 siteId: ID(기본값: 'root')

사이트에서 기본 문서 라이브러리 가져오기

SharePoint 사이트의 기본 문서 라이브러리(드라이브)를 가져옵니다.

선택적 매개 변수:

  • SharePoint 사이트의 siteId: ID(기본값: 'root')

getFolderChildren

문서 라이브러리(드라이브)의 지정된 부모 폴더 내에 포함된 상위 20개 파일 및 폴더(DriveItems)를 열거합니다.

필수 매개 변수:

  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

선택적 매개 변수:

  • parentFolderId: 상위 폴더의 ID(기본값: 'root').

파일또는폴더찾기

검색 쿼리를 통해 사용자가 액세스할 수 있는 파일 또는 폴더(DriveItem)를 찾습니다. 사용자가 액세스할 수 있는 모든 사이트 및 문서 라이브러리를 검색합니다.

필수 매개 변수:

  • searchQuery: 검색 쿼리(전체 또는 부분 파일 이름)

getFileOrFolderMetadata

SharePoint 지정된 문서 라이브러리(드라이브)에서 파일 또는 폴더(DriveItem)의 메타데이터를 가져옵니다.

필수 매개 변수:

  • fileOrFolderId: 파일 또는 폴더의 ID(DriveItem)
  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

getFileOrFolderMetadataByUrl (URL을 통해 파일 또는 폴더 메타데이터 가져오기)

공유 URL에서 파일이나 폴더(DriveItem)의 메타데이터를 얻습니다. 파일에 액세스할 수 있는 기존 명시적 권한이 있는 사용자만 메타데이터를 가져올 수 있습니다.

필수 매개 변수:

  • fileOrFolderUrl: 파일 또는 폴더의 URL입니다. URL은 사용자와 공유하기 위해 교환되지 않습니다. 이미 명시적 액세스 권한이 있어야 합니다.

readSmallTextFile

특정 문서 라이브러리(드라이브)에서 5MB 미만의 텍스트 파일을 읽습니다.

필수 매개 변수:

  • fileId: 읽거나 다운로드할 파일(DriveItem)의 ID
  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

readSmallBinaryFile

특정 문서 라이브러리(드라이브)에서 5MB보다 작은 이진 파일을 읽습니다. 파일 콘텐츠는 base64로 인코딩된 문자열로 반환됩니다.

필수 매개 변수:

  • fileId: 읽거나 다운로드할 파일(DriveItem)의 ID
  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

createSmallTextFile

5MB 미만의 텍스트 파일을 특정 문서 라이브러리(드라이브)에 생성하거나 업로드합니다.

필수 매개 변수:

  • 파일명: 파일 이름과 확장자 포함.
  • 목문 텍스트: 파일의 텍스트 내용.
  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

선택적 매개 변수:

  • parentFolderId: 상위 폴더의 ID(기본값: 'root').

createSmallBinaryFile

특정 문서 라이브러리(드라이브)에 콘텐츠를 base64 인코딩하여 5MB보다 작은 이진 파일을 만듭니다.

필수 매개 변수:

  • 파일명: 파일 이름과 확장자 포함.
  • base64Content: base64 문자열로 인코딩된 이진 파일 콘텐츠입니다.
  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

선택적 매개 변수:

  • parentFolderId: 상위 폴더의 ID(기본값: 'root').

폴더생성

지정된 문서 라이브러리(드라이브) 내에 새 폴더(DriveItem)를 만듭니다. 이름이 같은 폴더가 있으면 시스템에서 숫자 접미사(예: NewFolder (1))를 추가합니다.

필수 매개 변수:

  • Foldername: 폴더의 이름
  • documentLibraryId: 문서 라이브러리의 ID(드라이브)

선택적 매개 변수:

  • parentFolderId: 상위 폴더의 ID(기본값: 'root').

파일또는폴더이름변경

지정된 문서 라이브러리(드라이브) 내에서 파일 또는 폴더(DriveItem)의 이름을 바꿉니다. 새 이름은 명명 규칙을 준수해야 합니다.

필수 매개 변수:

  • documentLibraryId: 문서 라이브러리의 ID(드라이브)
  • fileOrFolderId: 이름을 바꿀 파일 또는 폴더의 ID
  • newFileOrFolderName: 새 이름

선택적 매개 변수:

  • Etag: 동시성 제어를 위한 ETag

파일 또는 폴더 삭제

지정된 문서 라이브러리(드라이브)에서 파일 또는 폴더(DriveItem)를 삭제합니다.

필수 매개 변수:

  • documentLibraryId: 문서 라이브러리의 ID(드라이브)
  • fileOrFolderId: 삭제할 파일 또는 폴더의 ID

선택적 매개 변수:

  • Etag: 동시성 제어를 위한 ETag

파일 또는 폴더 이동

파일 또는 폴더(DriveItem)를 대상 폴더로 이동합니다. SharePoint 내의 여러 문서 라이브러리(드라이브)를 이동할 수 있습니다. 이 작업은 비동기적입니다. 진행률을 모니터링하는 데 사용합니다 checkOperationStatus .

필수 매개 변수:

  • sourcedoclibid: 원본 문서 라이브러리의 ID(드라이브)
  • sourcefileid: 이동할 원본 파일 또는 폴더의 ID
  • destdoclibid: 대상 문서 라이브러리의 ID(드라이브)
  • destfolderid: 대상 폴더의 ID(있어야 합니다).

선택적 매개 변수:

  • newfilename: 이동된 항목의 새 이름

파일 또는 폴더 복사

파일 또는 폴더(DriveItem)를 대상 폴더에 복사합니다. SharePoint 내의 여러 문서 라이브러리에서 복사를 지원합니다. 이 작업은 비동기적입니다. 진행률을 모니터링하는 데 사용합니다 checkOperationStatus .

필수 매개 변수:

  • sourcedoclibid: 원본 문서 라이브러리의 ID(드라이브)
  • sourcefileid: 복사할 원본 파일 또는 폴더의 ID
  • destdoclibid: 대상 문서 라이브러리의 ID(드라이브)
  • destfolderid: 대상 폴더의 ID(있어야 합니다).

선택적 매개 변수:

  • newfilename: 복사한 항목의 새 이름

작업 상태 확인

원래 작업에서 반환된 작업 토큰을 사용하여 복사 또는 이동과 같은 비동기 작업의 상태를 확인합니다.

필수 매개 변수:

  • operationToken: 비동기 작업에서 반환된 작업 토큰(예: copyFileOrFolder 또는 moveFileOrFolder

uploadFileFromUrl

SharePoint 또는 OneDrive URL에서 문서 라이브러리(드라이브)의 대상 폴더로 파일을 업로드합니다. 원본 URL에서 파일이 복사되므로 원본 파일은 변경되지 않습니다.

필수 매개 변수:

  • sourceUrl: 원본 URL(유효한 SharePoint 또는 OneDrive URL이어야 합니다).
  • destinationDocumentLibraryId: 대상 문서 라이브러리의 ID입니다. 사용자의 OneDrive에 me을(를) 사용하세요

선택적 매개 변수:

  • destinationFolderId: 대상 폴더의 ID(기본값: root)
  • 파일: 새 파일 이름; 기본값은 원래 파일 이름으로 설정됩니다.

파일또는폴더공유

공유 초대를 보내 지정된 문서 라이브러리(드라이브) 내에서 파일 또는 폴더(DriveItem)에 대한 읽기 또는 쓰기 권한을 부여합니다.

필수 매개 변수:

  • documentLibraryId: 문서 라이브러리의 ID(드라이브)
  • fileOrFolderId: 공유할 파일 또는 폴더의 ID
  • recipientEmails: 받는 사람의 전자 메일 주소 배열
  • roles: 역할 배열: 'read', 'write' ('write'는 읽기 및 쓰기 권한을 모두 부여함)

선택적 매개 변수:

  • 메시지: 초대 전자 메일에 대한 사용자 지정 메시지(기본값: 공동 작업 중인 파일은 다음과 같습니다.)
  • sendInvitation: 공유 초대를 보낼지 여부(기본값: true)

파일에 민감도 레이블 설정하기

지정된 문서 라이브러리(드라이브)에서 파일의 민감도 레이블을 설정합니다.

필수 매개 변수:

  • documentLibraryId: 문서 라이브러리의 ID(드라이브)
  • fileId: 파일의 ID(DriveItem)
  • sensitivityLabelId: 민감도 레이블의 ID 또는 제거할 빈 문자열

선택적 매개 변수:

  • assignmentMethod: 할당 방법: 'standard', 'privileged', 'auto' 또는 'unknownFutureValue'(기본값: 'privileged')
  • justificationText: 감사 목적으로 근거 텍스트; 레이블을 다운그레이드하거나 제거할 때 필요(기본값: 'MCPServer에 의해 변경됨')

listLists

특정 사이트에서 사용할 수 있는 모든 SharePoint 목록을 가져옵니다. 사이트 내에 있는 목록을 검색하는 데 사용합니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID(형식: 'hostname,siteCollectionId,webId')

createList

사이트 내에 새 SharePoint list 만듭니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • Displayname: 새 목록의 표시 이름

선택적 매개 변수:

  • 열: 키-값 쌍으로 이루어진 열 모음: [{ Key: 'JobTitle', Value: 'text' }]. 유효한 형식: text, multilineText, number, boolean, dateTime, choice, lookup, personOrGroup, hyperlink, currency, calculated
  • 템플릿: 목록 템플릿 유형(기본값: 'genericList'). 옵션: genericList, documentLibrary, 이벤트, 작업, 공지 사항, 연락처, 링크, 설문 조사, issueTracking, discussionBoard

deleteList

사이트에서 SharePoint list 삭제합니다. 전체 목록 컨테이너와 그 안에 있는 모든 항목을 삭제합니다. 이 작업은 취소할 수 없습니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: 삭제할 목록의 ID

선택적 매개 변수:

  • Etag: 동시성 제어를 위한 ETag

sendInviteForList

공유 초대를 보내 SharePoint list 권한을 부여합니다.

필수 매개 변수:

  • listId: 공유할 SharePoint list ID입니다.
  • recipientEmails: 받는 사람의 전자 메일 주소 배열
  • 역할: 역할: 'read'(보기 전용), 'contribute'(항목 보기, 추가, 업데이트, 삭제), '편집'(목록 구조를 포함한 전체 편집)

선택적 매개 변수:

  • siteUrl: 목록을 포함하는 SharePoint 사이트의 사이트 URL
  • sendEmail: 이메일 알림을 보낼지 여부(기본값: true)

listListItems

특정 SharePoint 목록에서 항목(행/레코드)을 가져옵니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID

getListItem

SharePoint list의 ID로 단일 항목(행 또는 레코드)을 가져옵니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • Itemid: 특정 목록 항목의 ID

createListItem

SharePoint list 새 항목(행 또는 레코드)을 만듭니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • 필드: 필드 값에 대한 키값 쌍, 예를 들어 [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. '타이틀' 필드는 보통 필수입니다.

updateListItem

SharePoint list 기존 항목(행 또는 레코드)을 업데이트합니다. 지정된 필드만 업데이트됩니다. 생략된 필드는 해당 값을 유지합니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • Itemid: 업데이트할 항목의 ID
  • 필드: 업데이트할 필드의 키-값 쌍

선택적 매개 변수:

  • Etag: 동시성 제어를 위한 ETag

deleteListItem

SharePoint 목록에서 항목(행 또는 레코드) 하나를 삭제합니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • Itemid: 삭제할 항목의 ID

선택적 매개 변수:

  • Etag: 동시성 제어를 위한 ETag

열 목록

SharePoint 목록의 모든 열을 가져옵니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID

createColumn

SharePoint 목록에 새 열을 만듭니다. 텍스트, 숫자, 선택, 날짜/시간, 부울 값, 사용자, 조회, 계산 등을 포함한 다양한 열 유형을 지원합니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • 이름: 내부 열 이름(프로그래밍 식별자)
  • columnType: 열 유형: text, note, number, integer, boolean, dateTime, choice, multichoice, currency, lookup, user, url, calculated, term, multiterm, location, geolocation, thumbnail, counter, computed, contentTypeId, file, attachment, guid, outcomeChoice, approvalStatus

선택적 매개 변수:

  • columnProperties: 형식별 설정(예: 텍스트, { "maxLength": 255 }{ "choices": ["A","B","C"] } 선택 항목)
  • 설명: 열에 대한 설명
  • Displayname: UI에 표시된 표시 이름(기본값은 'name')
  • 필수: 열을 필수로 설정(기본값: false)
  • 숨겨진: 뷰에서 열 숨기기(기본값: false)

열 업데이트

SharePoint list 기존 열을 업데이트합니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • columnId: 업데이트할 열의 ID

선택적 매개 변수:

  • columnType: 열 형식('columnProperties'를 제공할 때 필요)
  • columnProperties: 업데이트할 형식별 속성
  • 설명: 새 설명
  • Displayname: 새 표시 이름
  • 숨김: 열을 숨기거나 표시합니다
  • 필수: 열을 필수 또는 선택 사항으로 설정합니다

deleteColumn

SharePoint 목록에서 열을 삭제합니다. 경고: 이 작업은 모든 항목에 대해 해당 열에 저장된 모든 데이터를 제거합니다.

필수 매개 변수:

  • SharePoint 사이트의 siteId: ID
  • listId: SharePoint 목록의 ID
  • columnId: 삭제할 열의 ID

주요 기능

사이트 관리

  • 이름으로 사이트를 찾거나 액세스 가능한 사이트를 찾습니다.
  • 정확한 URL 경로로 사이트를 가져옵니다.
  • 자식 사이트 및 하위 사이트를 나열합니다.
  • 포괄적인 사이트 계층 구조 탐색

문서 라이브러리 관리

  • 사이트의 모든 문서 라이브러리를 나열합니다.
  • 기본 문서 라이브러리를 가져옵니다.
  • 폴더 내용(최대 20개 항목)을 둘러보세요.
  • 폴더 구조를 만들고 관리합니다.

파일 작업

  • 텍스트 및 바이너리 파일(5MB 이하)을 생성하세요.
  • 텍스트와 바이너리 파일(5MB 이하)을 읽으세요.
  • 파일 및 폴더를 삭제, 이름 바꾸기 및 이동합니다.
  • 문서 라이브러리에서 파일 및 폴더를 복사합니다.
  • SharePoint 또는 OneDrive URL에서 파일을 업로드합니다.
  • 액세스 가능한 모든 사이트에서 파일 및 폴더를 검색합니다.
  • 파일 및 폴더 메타데이터를 가져옵니다.

비동기 작업

  • 문서 라이브러리 간에 파일 및 폴더를 비동기적으로 복사하고 이동합니다.
  • 작업 토큰을 사용하여 비동기 작업의 상태를 확인합니다.

목록 작업

  • 목록을 만들고 읽고 삭제합니다.
  • 제네릭, 문서 라이브러리, 이벤트 및 작업을 비롯한 여러 목록 템플릿을 지원합니다.
  • 역할 기반 사용 권한으로 목록을 공유합니다.
  • 목록 항목을 만들고, 읽고, 업데이트하고, 삭제하여 목록 항목을 관리합니다.

열 관리

  • 텍스트, 메모, 숫자, 부울, 날짜 및 시간, 선택, 조회, 사용자, URL, 계산 등 매우 다양한 유형의 열을 만듭니다.
  • 열 속성 및 메타데이터를 업데이트합니다.
  • 열 요구 사항 및 표시 유형을 구성합니다.
  • 형식별 열 속성을 설정합니다.

공유 및 권한

  • 사용자와 파일, 폴더 및 목록을 공유합니다.
  • 역할 읽기, 쓰기, 기여 및 편집 역할을 통해 역할 기반 액세스 제어를 사용합니다.
  • 공유를 위한 이메일 알림.
  • 초대장에 맞춤 메시지를 넣으세요.

보안 및 규정 준수

  • 민감도 레이블을 적용하고 제거합니다.
  • 표준, 권한 및 자동을 비롯한 여러 할당 방법을 사용합니다.
  • 감사 근거를 지원합니다.
  • eTags에서 동시성 제어를 사용합니다.

Notes

  • 파일 작업은 업로드 및 다운로드에 대해 5MB 이하인 파일로 제한됩니다.
  • 복사 및 이동 작업은 비동기적입니다. 진행률을 모니터링하는 데 사용합니다 checkOperationStatus .
  • 복사 및 이동 작업은 SharePoint 내에서 라이브러리 간 작업을 지원합니다.
  • uploadFileFromUrl 유효한 SharePoint 또는 OneDrive 원본 URL이 필요합니다.
  • eTag는 업데이트 및 삭제에 대한 동시성 제어를 제공합니다.
  • 중복된 폴더 이름에 자동 숫자 접미사가 붙습니다.
  • 목록 삭제는 취소할 수 없습니다.
  • 열 삭제는 해당 열에 저장된 모든 데이터를 제거합니다.
  • 검색 작업은 기본적으로 상위 20개 결과를 반환합니다.
  • Last updated on