Google Drive
Google Drive와 연결하여 클라우드 파일 저장소를 관리할 수 있습니다.
주요 기능
- 파일 및 폴더 생성, 조회, 수정, 삭제
- 파일 검색 및 메타데이터 관리
- 파일 공유 및 권한 설정
- 파일 복사, 이동, 이름 변경
- 버전 관리 및 파일 잠금
- 공유 드라이브 관리
- 배치 작업 지원
기본 정보
인증 방식
OAuth 2.0을 사용하여 인증합니다.
필요한 권한
https://www.googleapis.com/auth/drive
: Google Drive 전체 접근 권한
지원하는 MCP 도구
기본 파일/폴더 관리
roots
드라이브 루트 목록을 조회합니다. (내 드라이브, 공유된 항목)
file_metadata
파일의 메타데이터를 조회합니다.
folder_children
폴더 내용 목록을 조회합니다.
search
Google Drive에서 파일을 검색합니다.
file_content
Google Drive 파일의 내용을 조회합니다.
create
파일 또는 폴더를 생성합니다.
delete
파일을 휴지통 이동 또는 영구 삭제합니다.
copy
파일 또는 폴더를 새 위치로 복사합니다.
rename
파일 또는 폴더 이름을 변경합니다.
file_move
파일을 다른 폴더로 이동합니다.
star
파일 또는 폴더를 즐겨찾기에서 추가 또는 제거합니다.
restore
휴지통에서 파일을 복원합니다.
버전 관리
versions_list
파일의 모든 버전 목록을 조회합니다.
file_lock
파일을 잠금/잠금 해제합니다. (Google Workspace 전용)
권한 관리
share
파일 권한을 관리합니다.
permissions_list
파일 또는 폴더의 모든 권한 목록을 조회합니다.
permission_update
파일 또는 폴더의 사용자 권한을 업데이트합니다.
permission_delete
권한 ID로 파일 또는 폴더의 사용자 접근 권한을 제거합니다.
permission_add_domain
도메인의 모든 사용자와 파일 또는 폴더를 공유합니다.
공유 드라이브 관리
shared_drives_list
접근 가능한 모든 공유 드라이브 목록을 조회합니다.
shared_drive_get
특정 공유 드라이브의 메타데이터를 조회합니다.
shared_drive_files
공유 드라이브의 파일 목록을 조회합니다.
배치 작업
batch_get_metadata
단일 요청으로 여러 파일의 메타데이터를 조회합니다.
batch_update_permissions
여러 파일의 권한을 한 번에 업데이트합니다.
batch_delete
여러 파일 또는 폴더를 한 번에 삭제합니다.
batch_copy
여러 파일을 대상 폴더로 복사합니다.
batch_move
여러 파일을 대상 폴더로 이동합니다.
사용 예시
예를 들어,
- Prompt로 “내 드라이브의 파일 목록을 조회해줘” 라고 입력하면,
- LLM은 MCP를 통해
roots
및folder_children
도구를 호출하여 파일 목록을 조회합니다. - 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.
주의사항
- 배치 작업 시 대량의 파일 처리에 주의하세요.
- 파일 삭제는 복구가 가능하지만, 영구 삭제는 복구가 불가능하므로 신중하게 사용하세요.
- 파일 잠금 기능은 Google Workspace 계정에서만 사용 가능합니다.
Last updated on