Collegare agenti IA a TrekMail Drive

Un agente IA può gestire i file di Drive in sicurezza se gli fornisci un token limitato e regole chiare. Questa guida si concentra sulla configurazione specifica di Drive per gli agenti compatibili con MCP. Per l'installazione generale di MCP, consulta Collegare gli agenti IA (MCP).

Scegliere il compito dell'agente

Inizia assegnando un nome al flusso di lavoro, non allo strumento. Ecco alcuni buoni esempi:

• client-delivery-links crea link pubblici per i file approvati.
• monthly-report-uploader carica i PDF generati nel Drive dell'account.
• mailbox-file-assistant esegue ricerche nel Drive di una casella.
• storage-monitor legge l'utilizzo e lo stato del componente aggiuntivo.

Un nome specifico semplifica molto la successiva revisione del token e dei registri di audit.

Creare un token con ambito limitato

Apri Agenti IA e API → Token → Crea token. Per un agente dedicato esclusivamente a Drive, seleziona solo ambiti Drive. La maggior parte degli agenti non necessita dell'eliminazione definitiva.

Esempi:

Copia il token una volta. TrekMail non lo mostrerà di nuovo.

Configurare MCP

Imposta il token operativo nell'ambiente MCP:

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

Questo è un controllo di sicurezza di MCP self-hosted, non un interruttore delle funzionalità di Drive. Mantieni TREKMAIL_ALLOW_DESTRUCTIVE=false per il normale lavoro in Drive e attivalo solo per una pulizia sottoposta a revisione che richiede strumenti di eliminazione definitiva.

Se lo stesso agente legge o invia anche email, aggiungi separatamente un token per i messaggi:

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

Gli strumenti Drive non usano i token per i messaggi. Gli strumenti per i messaggi non usano gli ambiti Drive.

Eseguire prima un test con strumenti innocui

Chiedi all'agente di chiamare:

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

Queste chiamate confermano il funzionamento del token senza modificare dati. Poi prova un piccolo caricamento in una cartella temporanea.

Fornire all'agente regole operative sicure

Un prompt di sistema pratico per un agente Drive dovrebbe includere:

• Non eliminare mai definitivamente i file se l'utente non lo richiede esplicitamente.
• Preferire il cestino all'eliminazione definitiva.
• Aggiungere scadenza e limiti di download ai link pubblici.
• Restituire immediatamente gli URL di condivisione creati.
• Usare il Drive dell'account per i file del team e il Drive della casella solo quando il compito indica una casella.
• Controllare l'utilizzo dello spazio prima di caricare file di grandi dimensioni.

Controllare l'audit dopo la configurazione

Apri Agenti IA e API → Registro di audit e filtra per nome del token. Verifica che l'agente abbia chiamato solo gli strumenti Drive previsti. Se un token ha troppi ambiti, revocalo e crea un sostituto più limitato.