AI-agents verbinden met TrekMail Drive

Een AI-agent kan Drive-bestanden veilig beheren als je deze een beperkt token en duidelijke regels geeft. Deze handleiding richt zich op de Drive-specifieke configuratie voor MCP-compatibele agents. Zie AI-agents verbinden (MCP) voor de algemene MCP-installatie.

De taak van de agent kiezen

Geef eerst de workflow een naam, niet de tool. Goede voorbeelden zijn:

• client-delivery-links maakt openbare links voor goedgekeurde bestanden.
• monthly-report-uploader uploadt gegenereerde PDF's naar Account Drive.
• mailbox-file-assistant zoekt in de Drive van één mailbox.
• storage-monitor leest het gebruik en de add-onstatus.

Een gerichte naam maakt het later veel eenvoudiger om tokens en auditlogboeken te controleren.

Een token met beperkte scopes maken

Open AI-agents en API → Tokens → Token maken. Selecteer voor een agent die alleen Drive gebruikt uitsluitend Drive-scopes. De meeste agents hebben permanent wissen niet nodig.

Voorbeelden:

Kopieer het token eenmaal. TrekMail toont het niet opnieuw.

MCP configureren

Stel het operationele token in je MCP-omgeving in:

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

Dit is een zelfgehoste MCP-veiligheidscontrole, geen functieschakelaar van Drive. Behoud TREKMAIL_ALLOW_DESTRUCTIVE=false voor normaal Drive-werk en schakel dit alleen in voor een gecontroleerde opschoonactie waarvoor tools voor permanent wissen nodig zijn.

Als dezelfde agent ook e-mail leest of verzendt, voeg je afzonderlijk een berichtentoken toe:

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

Drive-tools gebruiken geen berichtentokens. Berichtentools gebruiken geen Drive-scopes.

Eerst testen met onschadelijke tools

Vraag de agent om het volgende aan te roepen:

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

Deze aanroepen bevestigen dat het token werkt zonder gegevens te wijzigen. Test daarna een kleine upload in een tijdelijke map.

De agent veilige werkregels geven

Een praktische systeemprompt voor een Drive-agent moet het volgende bevatten:

• Wis bestanden nooit permanent, tenzij de gebruiker hier expliciet om vraagt.
• Geef de voorkeur aan de prullenbak boven permanent verwijderen.
• Voeg een vervaldatum en downloadlimieten toe aan openbare links.
• Geef gemaakte deel-URL's direct terug.
• Gebruik Account Drive voor teambestanden en Mailbox Drive alleen als de taak een mailbox noemt.
• Controleer het opslaggebruik voordat je grote bestanden uploadt.

Na de configuratie controleren

Open AI-agents en API → Auditlogboek en filter op tokennaam. Controleer of de agent alleen de verwachte Drive-tools heeft aangeroepen. Als een token te veel scopes heeft, trek je het in en maak je een beperkter vervangend token.