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

Claude의 TrekMail을 열고 Connect를 선택한 뒤 로그인하고 접근을 허용하세요. API 토큰을 만들 필요가 없습니다. AI Agents & API → Tokens → Connected apps에서 권한을 확인하거나 연결을 해제할 수 있습니다.

자체 White Label 브랜드: 브랜드 대시보드의 MCP 주소를 사용하고 커넥터에 브랜드 이름을 지정하세요. custom connector로 추가해야 합니다. 공개 TrekMail 페이지는 TrekMail로 로그인하므로 자체 브랜드 연결을 대체하지 않습니다.

제한된 토큰과 명확한 규칙을 제공하면 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 도구만 호출했는지 확인하세요. 토큰에 범위가 너무 많으면 해지하고 더 제한된 대체 토큰을 만드세요.