Panoramica degli strumenti MCP di Drive per agenti IA

Il server MCP di TrekMail espone TrekMail agli agenti IA sotto forma di strumenti strutturati per l'archiviazione dei file, i link pubblici, la pulizia sicura e le password dei dispositivi di sincronizzazione. Una connessione vede solo gli strumenti consentiti dalle sue credenziali, dai set di strumenti selezionati, dal trasporto e dai controlli di sicurezza. Controlla l'elenco degli strumenti esposti all'agente invece di fare affidamento su un numero fisso nel catalogo.

Per gli agenti, MCP è solitamente più semplice di REST non elaborato. Anziché chiedere a un agente di creare richieste HTTP, gli fornisci strumenti come drive_file_upload, drive_share_create o drive_bulk_move. Dietro le quinte, l'API continua ad applicare gli ambiti dei token, l'idempotenza, la registrazione degli audit e i controlli di sicurezza.

Copertura degli strumenti

Requisiti del token

Gli strumenti MCP di Drive usano la variabile d'ambiente del token operativo:

TREKMAIL_API_TOKEN=tm_live_your_token

Il token deve includere gli ambiti Drive corrispondenti. Ad esempio, drive_share_create richiede un ambito di condivisione per lo spazio Drive del file. drive_file_purge richiede un ambito di eliminazione definitiva e il controllo degli strumenti distruttivi. Gli strumenti dei dispositivi di sincronizzazione richiedono drive:devices:read o drive:devices:write; la password del dispositivo creata viene mostrata una sola volta. Le loro risposte includono il server_url corretto, compreso un indirizzo DAV personalizzato solo dopo che il relativo certificato e l'host con restrizioni sono pronti.

Puoi eseguire gli strumenti Drive insieme agli strumenti per i messaggi fornendo anche TREKMAIL_MESSAGE_TOKEN. Le due famiglie di token restano separate.

Controlli di sicurezza

In un server MCP stdio self-hosted, l'amministratore locale può richiedere TREKMAIL_ALLOW_DESTRUCTIVE=true prima di eseguire gli strumenti per l'eliminazione definitiva e lo svuotamento del cestino. Si tratta di un controllo di sicurezza locale, non di un interruttore delle funzionalità del prodotto TrekMail. Anche le normali operazioni sul cestino modificano i dati e richiedono quindi ambiti di scrittura, ma sono recuperabili e non richiedono ambiti di eliminazione definitiva.

L'invio di email e le operazioni di scrittura della migrazione dispongono di controlli separati. L'attivazione degli strumenti distruttivi di Drive non abilita automaticamente l'invio o le scritture di migrazione.

Caricamenti tramite MCP

Per la maggior parte dei flussi di lavoro, usa drive_file_upload. Legge un file locale dall'host MCP, richiede le istruzioni di caricamento, invia il file all'URL di caricamento restituito, completa il caricamento e annulla la prenotazione se qualcosa non va.

Gli strumenti di basso livello restano disponibili quando un'integrazione richiede più controllo, ad esempio quando i byte del file provengono da un altro servizio o da un processo di trasferimento personalizzato.

Link di condivisione tramite MCP

Usa drive_share_create per creare un URL pubblico di download. Imposta expires_at e max_downloads ogni volta che il link esce dalla tua organizzazione. Usa drive_share_revoke quando un link deve smettere di funzionare. Il token non elaborato viene mostrato solo alla creazione, quindi gli agenti devono restituire immediatamente l'URL pubblico completo.

Limite della fatturazione

Gli strumenti del componente aggiuntivo sono di sola lettura: drive_addon_get, drive_addon_pricing e drive_addon_cancellation_preview. Gli agenti non possono acquistare, ridimensionare o annullare il componente aggiuntivo Drive tramite MCP. Queste azioni rimangono disponibili solo nella dashboard e sotto il controllo dell'utente.