Microsoft SharePoint

Microsoft SharePoint의 사이트, 문서 라이브러리, 리스트, 페이지를 조회하고 관리할 수 있습니다. 조직 내 SharePoint에 저장된 문서를 AI 에이전트가 직접 검색하고 활용할 수 있습니다.

주요 기능

• SharePoint 사이트 및 문서 라이브러리 탐색
• 파일/폴더 읽기, 생성, 이동, 복사, 삭제
• 파일 공유 링크 생성 및 초대 전송
• 리스트 생성 및 아이템 CRUD
• 사이트 페이지 조회 및 생성
• KQL 구문 기반 콘텐츠 검색
• 휴지통 항목 조회 및 복구

기본 정보

인증 방식

OAuth 2.0 (Microsoft Entra ID)을 사용합니다.

필요한 권한

• Sites.ReadWrite.All: 사이트, 리스트, 드라이브, 파일 읽기/쓰기
• Sites.Manage.All: 리스트, 페이지 등 사이트 구조 관리

지원하는 MCP 도구

사이트 관리

findSite

사용자가 접근 가능한 SharePoint 사이트를 검색합니다. 검색 쿼리 없이 호출하면 접근 가능한 상위 사이트 목록을 반환합니다.

getSite

사이트 ID, 특수 경로(예: root), 또는 hostname:path 형식으로 사이트 상세 정보를 조회합니다. includeSubsites를 사용하면 하위 사이트 목록도 함께 반환합니다.

문서 라이브러리

listDocumentLibraries

SharePoint 사이트의 문서 라이브러리 목록을 조회합니다. defaultOnly를 true로 설정하면 기본 문서 라이브러리만 반환합니다.

파일 및 폴더

listFolderContents

문서 라이브러리 내 폴더의 파일 및 하위 폴더 목록을 조회합니다. 최대 20개까지 반환합니다.

getItemInfo

파일 또는 폴더의 메타데이터를 조회합니다. includeVersions로 버전 히스토리, includePermissions로 공유 권한 정보를 함께 조회할 수 있습니다.

readFile

문서 라이브러리에서 파일 내용을 읽습니다. 텍스트와 바이너리 콘텐츠를 자동으로 감지하며, 바이너리/이미지 파일은 saveToTemp를 사용해 aip-temp:// URI로 저장할 수 있습니다.

createFileOrFolder

문서 라이브러리에 파일 또는 폴더를 생성합니다. isFolder=true로 폴더를 생성하며, 파일은 encoding을 text(기본값) 또는 base64로 지정하여 콘텐츠를 업로드합니다.

manageItem

파일 또는 폴더를 관리합니다. 지원하는 액션:

• rename: 이름 변경 (newName 필요)
• move: 이동 (newParentFolderId 필요)
• copy: 복사 (newParentFolderId 필요)
• delete: 삭제

shareItem

파일 또는 폴더의 공유 링크를 생성하거나 이메일로 초대를 전송합니다.

• 공유 링크: type(view/edit), scope(organization/anonymous) 지정
• 이메일 초대: email 주소 입력

리스트

createList

사이트에 새 SharePoint 리스트를 생성합니다. 표시 이름과 리스트 템플릿 유형을 지정합니다.

listLists

사이트의 SharePoint 리스트 목록을 조회합니다. listId와 함께 includeColumns/includeContentTypes를 지정하면 특정 리스트의 스키마 상세 정보를 조회할 수 있습니다.

queryListItems

리스트 아이템을 조회합니다. itemId로 단일 아이템을 조회하거나, OData 필터/select/expand를 사용해 다중 아이템을 쿼리할 수 있습니다.

saveListItem

리스트 아이템을 생성하거나 업데이트합니다. itemId를 생략하면 새 아이템을 생성하고, 입력하면 기존 아이템을 업데이트합니다. Key/Value 필드 형식을 사용합니다.

deleteListItem

리스트 아이템을 삭제합니다.

manageItemComments

리스트 아이템의 댓글을 조회하거나 추가합니다. comment를 생략하면 기존 댓글 목록을 반환하고, 입력하면 새 댓글을 추가합니다.

페이지

createPage

사이트에 새 SharePoint 모던 페이지를 생성합니다. 제목과 선택적으로 설명을 지정할 수 있습니다.

getPages

사이트 페이지 목록을 조회합니다. pageId를 지정하면 해당 페이지의 웹 파트 내용까지 포함한 상세 정보를 반환합니다.

검색

searchContent

KQL(Keyword Query Language) 구문을 사용하여 사이트, 리스트 아이템, 드라이브 아이템 전체에서 콘텐츠를 검색합니다.

휴지통

manageRecycleBin

사이트 휴지통의 삭제된 항목을 조회하거나 복구합니다. recycleBinItemId와 action='restore'를 지정하면 특정 항목을 복구할 수 있습니다.

사용 예시

• 사용자가 Prompt로 “SharePoint 영업팀 사이트에서 2025년 매출 보고서 찾아줘”라고 입력합니다.
• LLM은 MCP를 통해 searchContent 도구를 호출하여 KQL 검색을 수행합니다.
• Tool 호출 결과를 기반으로 채팅에서 응답합니다.

그 외 사용 예시:

• “문서 라이브러리에 있는 계약서 파일 내용 읽어줘”
• “프로젝트 폴더 안에 ‘회의록.docx’ 파일 만들어줘”
• “최근 삭제된 파일 목록 보여줘”

주의사항

• Microsoft 365 계정 및 적절한 SharePoint 권한이 필요합니다.
• 파일 삭제 시 휴지통으로 이동되며, manageRecycleBin으로 복구할 수 있습니다.