Conectar agentes de IA ao TrekMail Drive

Um agente de IA pode gerenciar arquivos do Drive com segurança quando você fornece um token restrito e regras claras. Este guia se concentra na configuração específica do Drive para agentes compatíveis com MCP. Para a instalação geral do MCP, consulte Conectar agentes de IA (MCP).

Escolher a função do agente

Comece nomeando o fluxo de trabalho, não a ferramenta. Bons exemplos:

• client-delivery-links cria links públicos para arquivos aprovados.
• monthly-report-uploader envia os PDFs gerados ao Drive da conta.
• mailbox-file-assistant pesquisa o Drive de uma caixa de correio.
• storage-monitor consulta o uso e o status do complemento.

Um nome específico facilita muito a revisão do token e dos logs de auditoria mais tarde.

Criar um token com escopo limitado

Abra Agentes de IA e API → Tokens → Criar token. Para um agente exclusivo do Drive, selecione apenas escopos do Drive. A maioria dos agentes não precisa de exclusão permanente.

Exemplos:

Copie o token uma vez. O TrekMail não o mostrará novamente.

Configurar o MCP

Defina o token de operações no ambiente MCP:

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

Esse é um controle de segurança do MCP auto-hospedado, não uma opção de recurso do Drive. Mantenha TREKMAIL_ALLOW_DESTRUCTIVE=false no trabalho normal com o Drive e ative-o apenas para uma limpeza revisada que precise de ferramentas de exclusão permanente.

Se o mesmo agente também lê ou envia e-mails, adicione separadamente um token de mensagens:

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

As ferramentas do Drive não usam tokens de mensagens. As ferramentas de mensagens não usam escopos do Drive.

Testar primeiro com ferramentas inofensivas

Peça ao agente que chame:

1. drive_spaces_list
2. drive_storage_summary
3. drive_browse_folder para space="account"

Essas chamadas confirmam que o token funciona sem alterar dados. Em seguida, teste um upload pequeno em uma pasta temporária.

Fornecer regras seguras de operação ao agente

Um prompt de sistema prático para um agente do Drive deve incluir:

• Nunca excluir arquivos permanentemente, a menos que o usuário peça explicitamente.
• Preferir a lixeira à exclusão permanente.
• Adicionar validade e limites de download aos links públicos.
• Retornar imediatamente as URLs de compartilhamento criadas.
• Usar o Drive da conta para arquivos da equipe e o Drive da caixa de correio somente quando a tarefa indicar uma caixa.
• Verificar o uso do armazenamento antes de enviar arquivos grandes.

Auditar depois da configuração

Abra Agentes de IA e API → Log de auditoria e filtre pelo nome do token. Confirme que o agente chamou apenas as ferramentas do Drive esperadas. Se um token tiver escopos demais, revogue-o e crie um substituto mais restrito.