AI 에이전트를 TrekMail Drive에 연결하기

제한된 토큰과 명확한 규칙을 제공하면 AI 에이전트가 Drive 파일을 안전하게 관리할 수 있습니다. 이 가이드에서는 MCP 호환 에이전트의 Drive 전용 설정을 설명합니다. 일반적인 MCP 설치는 AI 에이전트 연결(MCP)을 참조하세요.

에이전트의 작업 선택

도구가 아니라 워크플로에 먼저 이름을 지정하세요. 좋은 예는 다음과 같습니다.

• client-delivery-links는 승인된 파일의 공개 링크를 만듭니다.
• monthly-report-uploader는 생성된 PDF를 Account Drive에 업로드합니다.
• mailbox-file-assistant는 한 사서함의 Drive를 검색합니다.
• storage-monitor는 사용량과 추가 기능 상태를 읽습니다.

목적이 분명한 이름을 사용하면 나중에 토큰과 감사 로그를 훨씬 쉽게 검토할 수 있습니다.

범위가 제한된 토큰 생성

AI 에이전트 및 API → 토큰 → 토큰 생성을 여세요. Drive 전용 에이전트에는 Drive 범위만 선택하세요. 대부분의 에이전트에는 영구 삭제 권한이 필요하지 않습니다.

예:

토큰을 한 번 복사하세요. TrekMail은 다시 표시하지 않습니다.

MCP 구성

MCP 환경에 운영 토큰을 설정하세요.

TREKMAIL_BASE_URL=https://trekmail.net
TREKMAIL_API_TOKEN=tm_live_your_token
TREKMAIL_ALLOW_DESTRUCTIVE=false

이는 자체 호스팅 MCP의 안전 제어이며 Drive 기능 스위치가 아닙니다. 일반적인 Drive 작업에서는 TREKMAIL_ALLOW_DESTRUCTIVE=false를 유지하고 영구 삭제 도구가 필요한 검토된 정리 작업에서만 활성화하세요.

같은 에이전트가 이메일도 읽거나 발송한다면 메시지 토큰을 별도로 추가하세요.

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

Drive 도구는 메시지 토큰을 사용하지 않습니다. 메시지 도구는 Drive 범위를 사용하지 않습니다.

먼저 안전한 도구로 테스트

에이전트에 다음을 호출하도록 요청하세요.

1. drive_spaces_list
2. drive_storage_summary
3. space="account"를 사용하는 drive_browse_folder

이 호출을 통해 데이터를 변경하지 않고 토큰의 작동을 확인할 수 있습니다. 그런 다음 임시 폴더에 작은 파일을 업로드해 테스트하세요.

에이전트에 안전한 운영 규칙 제공

Drive 에이전트를 위한 실용적인 시스템 프롬프트에는 다음 규칙이 포함되어야 합니다.

• 사용자가 명시적으로 요청하지 않는 한 파일을 영구 삭제하지 않습니다.
• 영구 삭제보다 휴지통을 우선합니다.
• 공개 링크에 만료일과 다운로드 횟수 제한을 추가합니다.
• 생성된 공유 URL을 즉시 반환합니다.
• 팀 파일에는 Account Drive를 사용하고 작업에서 사서함을 지정한 경우에만 Mailbox Drive를 사용합니다.
• 큰 파일을 업로드하기 전에 저장 공간 사용량을 확인합니다.

설정 후 감사

AI 에이전트 및 API → 감사 로그를 열고 토큰 이름으로 필터링하세요. 에이전트가 예상한 Drive 도구만 호출했는지 확인하세요. 토큰에 범위가 너무 많으면 해지하고 더 제한된 대체 토큰을 만드세요.