AI 에이전트를 위한 Drive MCP 도구 개요
AI 에이전트를 위한 42개 TrekMail Drive MCP 도구의 개요로, 업로드, 공유 링크, 대량 작업, 안전한 삭제 및 Drive 추가 기능 읽기 액세스를 다룹니다.
문서 정보
유형, 난이도, 요금제, 최종 업데이트 정보입니다.
▼
문서 정보
유형, 난이도, 요금제, 최종 업데이트 정보입니다.
- 유형
- 참조 자료
- 난이도
- 중급
- 요금제
- Starter · Pro · Agency · + Drive Add-on
- 최종 업데이트
- 2026년 9월 10일
TrekMail MCP 서버는 파일 저장, 공개 링크, 안전한 정리 및 동기화 장치 비밀번호를 위한 구조화된 도구로 TrekMail을 AI 에이전트에 제공합니다. 연결에는 자격 증명, 선택한 도구 세트, 전송 방식 및 안전 게이트가 허용하는 도구만 표시됩니다. 고정된 카탈로그 개수에 의존하지 말고 에이전트에 노출된 도구 목록을 확인하세요.
에이전트에는 일반적으로 원시 REST보다 MCP가 더 간편합니다. 에이전트에게 HTTP 요청을 작성하도록 하는 대신 drive_file_upload, drive_share_create, drive_bulk_move 같은 도구를 제공합니다. 내부적으로 API는 계속해서 토큰 범위, 멱등성, 감사 로깅 및 안전 게이트를 적용합니다.
도구 지원 범위
| 도구 그룹 | 도구 | 에이전트가 할 수 있는 작업 |
|---|---|---|
| 공간 및 사용량 | drive_spaces_list, drive_storage_summary, drive_space_usage |
계정 Drive, 허용된 사서함 공간 및 할당량 상태 확인 |
| 탐색 및 선택 | drive_browse_folder, drive_folder_tree, drive_select_all_ids |
폴더를 탐색하고 대량 작업을 안전하게 준비 |
| 파일 | drive_file_get, drive_file_download_url, drive_file_rename, drive_file_move, drive_file_trash, drive_file_restore, drive_file_purge |
메타데이터를 읽고 파일을 다운로드, 이름 변경, 이동, 휴지통으로 이동, 복원 또는 영구 삭제 |
| 폴더 | drive_folder_create, drive_folder_update, drive_folder_move, drive_folder_trash, drive_folder_restore, drive_folder_purge |
폴더 트리를 만들고 관리 |
| 팀 공유 | drive_folder_share_with_account, drive_folder_stop_sharing |
최상위 폴더를 모든 사서함에 표시하거나 계정 전체 공개를 중지 |
| 휴지통 | drive_trash_list, drive_trash_empty |
휴지통을 검토하거나 파괴적 작업 게이트가 활성화된 경우 영구적으로 비우기 |
| 대량 작업 | drive_bulk_trash, drive_bulk_restore, drive_bulk_move, drive_bulk_purge |
선택한 항목을 최대 5,000개까지 이동, 휴지통으로 이동, 복원 또는 영구 삭제 |
| 공개 링크 | drive_share_create, drive_share_list, drive_share_revoke |
만료 또는 다운로드 횟수 제한이 있는 링크를 만들고 나중에 해지 |
| 업로드 | drive_file_upload, drive_upload_initiate, drive_upload_complete, drive_upload_refresh_parts, drive_upload_abort |
간단한 래퍼로 로컬 파일을 업로드하거나 멀티파트 흐름을 수동으로 제어 |
| 추가 기능 상태 | drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview |
결제를 변경하지 않고 저장 공간 추가 기능 상태와 가격 확인 |
| 동기화 장치 | drive_device_list, drive_device_create, drive_device_revoke, drive_device_rotate |
WebDAV 동기화 앱의 별도 비밀번호를 생성, 검토, 해지 또는 교체 |
토큰 요구 사항
Drive MCP 도구는 운영 토큰 환경 변수를 사용합니다.
TREKMAIL_API_TOKEN=tm_live_your_token
토큰에는 일치하는 Drive 범위가 포함되어야 합니다. 예를 들어 drive_share_create에는 파일의 Drive 공간에 대한 공유 범위가 필요합니다. drive_file_purge에는 영구 삭제 범위와 파괴적 도구 게이트가 필요합니다. 동기화 장치 도구에는 drive:devices:read 또는 drive:devices:write가 필요하며, 생성된 장치 비밀번호는 한 번만 표시됩니다. 응답에는 올바른 server_url이 포함되며, 브랜드 DAV 주소는 인증서와 제한된 호스트가 준비된 뒤에만 포함됩니다.
TREKMAIL_MESSAGE_TOKEN도 제공하면 Drive 도구와 메시지 도구를 함께 실행할 수 있습니다. 두 토큰 계열은 서로 분리된 상태로 유지됩니다.
안전 게이트
자체 호스팅 stdio MCP 서버에서는 로컬 관리자가 영구 삭제 및 휴지통 비우기 도구를 실행하기 전에 TREKMAIL_ALLOW_DESTRUCTIVE=true를 요구할 수 있습니다. 이는 로컬 안전 제어이며 TrekMail 제품 기능 스위치가 아닙니다. 일반 휴지통 작업도 데이터를 변경하므로 쓰기 범위가 필요하지만 복구할 수 있고 영구 삭제 범위는 필요하지 않습니다.
이메일 발송과 마이그레이션 쓰기 작업에는 별도의 게이트가 있습니다. Drive 파괴적 도구를 켜도 발송이나 마이그레이션 쓰기가 자동으로 활성화되지는 않습니다.
MCP를 통한 업로드
대부분의 워크플로에는 drive_file_upload를 사용하세요. 이 도구는 MCP 호스트에서 로컬 파일을 읽고 업로드 지침을 요청한 다음, 반환된 업로드 URL로 파일을 보내고 업로드를 완료하며 문제가 생기면 예약을 중단합니다.
다른 서비스에서 파일 바이트를 가져오거나 사용자 지정 전송 프로세스를 사용하는 경우처럼 통합에 더 많은 제어가 필요할 때는 저수준 도구도 계속 사용할 수 있습니다.
MCP를 통한 공유 링크
공개 다운로드 URL을 만들려면 drive_share_create를 사용하세요. 링크가 조직 외부로 나갈 때마다 expires_at과 max_downloads를 설정하세요. 링크 작동을 중지해야 할 때는 drive_share_revoke를 사용하세요. 원시 토큰은 생성 시 한 번만 표시되므로 에이전트는 완전한 공개 URL을 즉시 반환해야 합니다.
결제 경계
추가 기능 도구는 읽기 전용입니다. 해당 도구는 drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview입니다. 에이전트는 MCP를 통해 Drive 추가 기능을 구매하거나 용량을 변경하거나 취소할 수 없습니다. 이러한 작업은 계속해서 대시보드에서만 가능하며 사용자가 제어합니다.
관련 문서
워크플로를 이어가는 인근 가이드로 이동하세요.