SharePoint 자동화
사이트, 목록, 문서, 폴더 및 페이지 관리를 포함한 SharePoint 작업을 자동화합니다. SharePoint REST API 및 OneDrive를 통한 Microsoft Graph와 통합됩니다.
도구 키트 문서: composio.dev/toolkits/share_point
설정
이 기술을 사용하려면 https://rube.app/mcp에 연결된 Rube MCP 서버가 필요합니다.
도구를 실행하기 전에 share_point 및 one_drive 도구 키트에 대한 활성 연결이 있는지 확인하세요. 활성 연결이 없으면 RUBE_MANAGE_CONNECTIONS를 통해 새 연결을 시작하세요.
참고: 많은 OneDrive/SharePoint 도구는 조직용 Microsoft 365 계정(Azure AD/Entra ID)에서만 작동합니다. 개인 Microsoft 계정은 지원되지 않습니다.
핵심 워크플로
1. 사이트 목록 및 탐색
사이트 세부 정보를 검색하고 하위 사이트를 열거하여 SharePoint 토폴로지를 검색합니다.
도구:
ONE_DRIVE_GET_SITE_DETAILS-- 사이트 ID로 특정 사이트의 메타데이터 가져오기ONE_DRIVE_LIST_SITE_SUBSITES-- 부모 사이트의 모든 하위 사이트 나열
주요 매개변수:
site_id(필수) -- 복합 형식:hostname,site-collection-guid,web-guid(예:"contoso.sharepoint.com,da60e844-...,712a596e-...")
예시:
도구: ONE_DRIVE_GET_SITE_DETAILS
인수:
site_id: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
2. 목록 관리
목록을 생성하고, 기존 목록을 열거하며, 목록 항목을 검색합니다.
도구:
SHARE_POINT_LIST_ALL_LISTS-- 사이트의 모든 목록 검색 (OData filter, select, orderby, top 지원)SHARE_POINT_SHAREPOINT_CREATE_LIST-- 지정된 템플릿으로 새 목록 생성ONE_DRIVE_LIST_SITE_LISTS-- Microsoft Graph를 통해 사이트의 모든 목록 나열ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS-- 특정 목록에서 항목 검색
SHARE_POINT_SHAREPOINT_CREATE_LIST의 주요 매개변수:
name(필수) -- 목록 이름template(필수) -- 템플릿 유형:"genericList","documentLibrary","tasks"등description-- 선택적 설명
SHARE_POINT_LIST_ALL_LISTS의 주요 매개변수:
filter-- OData 필터, 예:"Hidden eq false"select-- 반환할 속성, 예:"Title,Id"orderby-- 정렬 표현식, 예:"Title desc"top-- 결과 수 제한
예시:
도구: SHARE_POINT_SHAREPOINT_CREATE_LIST
인수:
name: "프로젝트 작업"
template: "tasks"
description: "1분기 인도물 작업 추적"
3. 폴더 및 파일 관리
폴더를 생성하고, 폴더 내의 파일을 나열하며, 문서 라이브러리를 탐색합니다.
도구:
SHARE_POINT_SHAREPOINT_CREATE_FOLDER-- 문서 라이브러리에 새 폴더 생성SHARE_POINT_LIST_FILES_IN_FOLDER-- 서버 상대 URL로 폴더 내 파일 나열SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL-- 경로로 폴더 메타데이터 가져오기
SHARE_POINT_SHAREPOINT_CREATE_FOLDER의 주요 매개변수:
folder_name(필수) -- 생성할 폴더 이름document_library-- 대상 라이브러리 (기본값:"Shared Documents")relative_path-- 라이브러리 내 추가 경로
SHARE_POINT_LIST_FILES_IN_FOLDER의 주요 매개변수:
folder_name(필수) -- 서버 상대 URL, 예:"/Shared Documents"select-- 쉼표로 구분된 속성, 예:"Name,ServerRelativeUrl,Length"top-- 결과 수 제한orderby-- 정렬 표현식, 예:"Name desc"
예시:
도구: SHARE_POINT_LIST_FILES_IN_FOLDER
인수:
folder_name: "/Shared Documents/Reports"
select: "Name,ServerRelativeUrl,Length"
top: 50
4. SharePoint 콘텐츠 검색
키워드 쿼리 언어(KQL)를 사용하여 사이트 전체에서 문서, 목록 항목 및 기타 콘텐츠를 검색합니다.
도구: SHARE_POINT_SEARCH_QUERY
주요 매개변수:
querytext(필수) -- KQL 쿼리, 예:"project report","FileType:docx","Author:\"John Doe\""rowlimit-- 요청당 최대 결과 수 (기본값 ~50, 최대 500)startrow-- 페이지 매기기를 위한 0부터 시작하는 오프셋selectproperties-- 반환할 속성, 예:"Title,Author,Path"refinementfilters-- 결과 범위 좁히기, 예:"FileType:equals(\"docx\")"
예시:
도구: SHARE_POINT_SEARCH_QUERY
인수:
querytext: "IsDocument:1 FileType:pdf"
rowlimit: 25
selectproperties: "Title,Author,Path,LastModifiedTime"
5. 목록 변경 사항 추적 (델타 쿼리)
델타 쿼리를 사용하여 전체 목록을 읽지 않고 증분 변경 사항(생성, 업데이트, 삭제된 항목)을 가져옵니다.
도구: ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA
주요 매개변수:
site_id(필수) -- 복합 사이트 IDlist_id(필수) -- 목록 GUIDtoken-- 초기 동기화 시 생략; 빈 응답과 토큰을 받으려면"latest"전달; 이전 토큰을 전달하면 해당 시점 이후의 변경 사항expand-- 예:"fields($select=ColumnA,ColumnB)"top-- 응답당 최대 항목 수
6. 사이트 페이지 콘텐츠 검색
캔버스 웹 파트를 포함한 최신 SharePoint 사이트 페이지 콘텐츠를 읽습니다.
도구: SHARE_POINT_GET_SITE_PAGE_CONTENT
주요 매개변수:
page_file_name--.aspx확장자를 포함한 파일 이름, 예:"Home.aspx"item_id-- 대안: 페이지의 목록 항목 IDrender_as--"raw"(기본값),"text"또는"html"site-- 선택적 사이트 이름 범위
알려진 문제점
| 문제점 | 세부 사항 |
|---|---|
| 사이트 ID 형식 | 복합 형식이어야 함: hostname,site-collection-guid,web-guid. 잘못된 형식은 400 오류를 발생시킵니다. |
| 개인 계정 미지원 | ONE_DRIVE_LIST_SITE_LISTS 및 Graph 기반 도구는 조직용 M365 계정에서만 작동하며, 개인 MSA/Outlook.com 계정에서는 작동하지 않습니다. |
| OData 필터 구문 | SharePoint OData 필터는 특정 구문을 사용합니다. 필터를 점진적으로 테스트하세요. 지원되지 않는 표현식은 자동으로 빈 결과를 반환할 수 있습니다. |
| 페이지 매기기 | 목록 작업에서 서버 측 페이지 매기기를 위해 skiptoken을 사용하세요. 불완전한 페이지 매기기 설정은 결과를 놓칠 수 있습니다. |
| 폴더 경로 | 절대 URL이 아닌 서버 상대 URL(예: /Shared Documents)을 사용해야 합니다. |
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
ONE_DRIVE_GET_SITE_DETAILS | SharePoint 사이트의 메타데이터 가져오기 |
ONE_DRIVE_LIST_SITE_SUBSITES | 부모 사이트의 하위 사이트 나열 |
ONE_DRIVE_LIST_SITE_LISTS | 사이트의 모든 목록 나열 (Graph API) |
ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA | 증분 목록 변경 사항 추적 |
ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS | 목록에서 항목 검색 |
ONE_DRIVE_LIST_DRIVES | 사용자/사이트/그룹에 사용 가능한 드라이브 나열 |
ONE_DRIVE_LIST_SITE_COLUMNS | 사이트의 열 정의 나열 |
SHARE_POINT_LIST_ALL_LISTS | 사이트의 모든 목록 검색 (REST API) |
SHARE_POINT_SHAREPOINT_CREATE_LIST | 새 SharePoint 목록 생성 |
SHARE_POINT_SHAREPOINT_CREATE_FOLDER | 문서 라이브러리에 폴더 생성 |
SHARE_POINT_LIST_FILES_IN_FOLDER | 폴더 내 파일 나열 |
SHARE_POINT_SEARCH_QUERY | KQL을 사용하여 콘텐츠 검색 |
SHARE_POINT_GET_SITE_PAGE_CONTENT | 사이트 페이지 콘텐츠 검색 |
SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL | 경로로 폴더 메타데이터 가져오기 |
Composio 제공