Überblick über Drive-MCP-Tools für KI-Agenten

Der TrekMail-MCP-Server stellt KI-Agenten TrekMail als strukturierte Tools für Dateispeicherung, öffentliche Links, sicheres Aufräumen und Passwörter für Synchronisierungsgeräte bereit. Eine Verbindung sieht nur die Tools, die ihre Anmeldedaten, ausgewählten Toolsets, der Transport und die Sicherheitsmechanismen zulassen. Prüfen Sie die für den Agenten bereitgestellte Toolliste, statt sich auf eine feste Kataloganzahl zu verlassen.

MCP ist für Agenten meist einfacher als direkte REST-Aufrufe. Anstatt einen Agenten HTTP-Anfragen erstellen zu lassen, geben Sie ihm Tools wie drive_file_upload, drive_share_create oder drive_bulk_move. Im Hintergrund setzt die API weiterhin Token-Berechtigungsbereiche, Idempotenz, Audit-Protokollierung und Sicherheitsmechanismen durch.

Tool-Abdeckung

Tokenanforderungen

Drive-MCP-Tools verwenden die Umgebungsvariable für das Ops-Token:

TREKMAIL_API_TOKEN=tm_live_your_token

Das Token muss die passenden Drive-Berechtigungsbereiche enthalten. drive_share_create erfordert beispielsweise einen Freigabebereich für den Drive-Bereich der Datei. drive_file_purge erfordert einen Löschbereich und den Mechanismus für destruktive Tools. Tools für Synchronisierungsgeräte benötigen drive:devices:read oder drive:devices:write; das erstellte Gerätepasswort wird nur einmal angezeigt. Ihre Antworten enthalten die korrekte server_url, einschließlich einer gebrandeten DAV-Adresse erst dann, wenn deren Zertifikat und eingeschränkter Host bereit sind.

Sie können Drive-Tools zusammen mit Nachrichtentools ausführen, indem Sie zusätzlich TREKMAIL_MESSAGE_TOKEN bereitstellen. Die beiden Tokenfamilien bleiben getrennt.

Sicherheitsmechanismen

Bei einem selbst gehosteten stdio-MCP-Server kann dessen lokaler Administrator TREKMAIL_ALLOW_DESTRUCTIVE=true verlangen, bevor Tools zum endgültigen Löschen und Leeren des Papierkorbs ausgeführt werden. Dies ist eine lokale Sicherheitskontrolle und kein Funktionsschalter des TrekMail-Produkts. Normale Papierkorbvorgänge verändern ebenfalls Daten und benötigen daher Schreibbereiche, sind jedoch rückgängig zu machen und erfordern keine Löschbereiche.

Für den E-Mail-Versand und schreibende Migrationsvorgänge gelten separate Mechanismen. Das Aktivieren destruktiver Drive-Tools aktiviert weder den Versand noch schreibende Migrationen automatisch.

Uploads über MCP

Verwenden Sie für die meisten Abläufe drive_file_upload. Das Tool liest eine lokale Datei vom MCP-Host, fordert Uploadanweisungen an, sendet die Datei an die zurückgegebene Upload-URL, schließt den Upload ab und bricht die Reservierung ab, falls ein Fehler auftritt.

Low-Level-Tools bleiben verfügbar, wenn eine Integration mehr Kontrolle benötigt, beispielsweise wenn die Dateibytes von einem anderen Dienst oder einem benutzerdefinierten Übertragungsprozess kommen.

Freigabelinks über MCP

Erstellen Sie mit drive_share_create eine öffentliche Download-URL. Legen Sie expires_at und max_downloads immer fest, wenn der Link Ihre Organisation verlässt. Verwenden Sie drive_share_revoke, sobald ein Link nicht mehr funktionieren soll. Das Roh-Token wird nur bei der Erstellung angezeigt, daher sollten Agenten die vollständige öffentliche URL sofort zurückgeben.

Abrechnungsgrenze

Die Add-on-Tools sind schreibgeschützt: drive_addon_get, drive_addon_pricing und drive_addon_cancellation_preview. Agenten können das Drive-Add-on nicht über MCP kaufen, vergrößern, verkleinern oder kündigen. Diese Aktionen sind weiterhin nur im Dashboard und unter Kontrolle des Benutzers möglich.