Herramientas MCP de Drive para agentes de IA
Conoce las 42 herramientas MCP de TrekMail Drive para agentes de IA: cargas, enlaces compartidos, operaciones masivas, borrado seguro y acceso de lectura.
Detalles del artículo
Tipo, dificultad, planes e información de última actualización.
▼
Detalles del artículo
Tipo, dificultad, planes e información de última actualización.
- Tipo
- Referencia
- Dificultad
- Intermedio
- Planes
- Starter · Pro · Agency · + Drive Add-on
- Última actualización
- 10 de sep. de 2026
El servidor MCP de TrekMail presenta TrekMail a los agentes de IA como herramientas estructuradas para almacenar archivos, crear enlaces públicos, realizar limpiezas seguras y gestionar contraseñas de dispositivos de sincronización. Una conexión solo ve las herramientas permitidas por sus credenciales, conjuntos de herramientas seleccionados, transporte y controles de seguridad. Comprueba la lista de herramientas disponible para el agente en lugar de confiar en una cantidad fija del catálogo.
MCP suele ser más sencillo que REST sin procesar para los agentes. En vez de pedir a un agente que construya solicitudes HTTP, le proporcionas herramientas como drive_file_upload, drive_share_create o drive_bulk_move. En segundo plano, la API sigue aplicando ámbitos de token, idempotencia, registro de auditoría y controles de seguridad.
Cobertura de las herramientas
| Grupo de herramientas | Herramientas | Qué pueden hacer los agentes |
|---|---|---|
| Espacios y uso | drive_spaces_list, drive_storage_summary, drive_space_usage |
Descubrir Drive de la cuenta, los espacios de buzón permitidos y el estado de la cuota |
| Exploración y selección | drive_browse_folder, drive_folder_tree, drive_select_all_ids |
Recorrer carpetas y preparar operaciones masivas con seguridad |
| Archivos | drive_file_get, drive_file_download_url, drive_file_rename, drive_file_move, drive_file_trash, drive_file_restore, drive_file_purge |
Leer metadatos, descargar, cambiar el nombre, mover, enviar a la papelera, restaurar o purgar permanentemente un archivo |
| Carpetas | drive_folder_create, drive_folder_update, drive_folder_move, drive_folder_trash, drive_folder_restore, drive_folder_purge |
Crear y gestionar árboles de carpetas |
| Uso compartido en equipo | drive_folder_share_with_account, drive_folder_stop_sharing |
Hacer visible una carpeta de nivel superior para todos los buzones o detener la visibilidad en toda la cuenta |
| Papelera | drive_trash_list, drive_trash_empty |
Revisar la papelera o vaciarla permanentemente cuando esté habilitado el control destructivo |
| Operaciones masivas | drive_bulk_trash, drive_bulk_restore, drive_bulk_move, drive_bulk_purge |
Mover, enviar a la papelera, restaurar o purgar hasta 5.000 elementos seleccionados |
| Enlaces públicos | drive_share_create, drive_share_list, drive_share_revoke |
Crear enlaces de descarga con caducidad o límite y revocarlos más adelante |
| Cargas | drive_file_upload, drive_upload_initiate, drive_upload_complete, drive_upload_refresh_parts, drive_upload_abort |
Cargar archivos locales con un contenedor sencillo o controlar manualmente el flujo multiparte |
| Estado del complemento | drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview |
Consultar el estado y el precio del complemento de almacenamiento sin modificar la facturación |
| Dispositivos de sincronización | drive_device_list, drive_device_create, drive_device_revoke, drive_device_rotate |
Crear, revisar, revocar o rotar una contraseña independiente para una aplicación de sincronización WebDAV |
Requisitos del token
Las herramientas MCP de Drive utilizan la variable de entorno del token de operaciones:
TREKMAIL_API_TOKEN=tm_live_your_token
El token debe incluir los ámbitos de Drive correspondientes. Por ejemplo, drive_share_create necesita un ámbito de uso compartido para el espacio de Drive del archivo. drive_file_purge necesita un ámbito de purga y el control de herramientas destructivas. Las herramientas de dispositivos de sincronización necesitan drive:devices:read o drive:devices:write; la contraseña de dispositivo creada solo se muestra una vez. Sus respuestas incluyen el server_url correcto, incluida una dirección DAV con marca únicamente después de que su certificado y host restringido estén listos.
Puedes ejecutar las herramientas de Drive junto con las herramientas de mensajes si también proporcionas TREKMAIL_MESSAGE_TOKEN. Las dos familias de tokens permanecen separadas.
Controles de seguridad
En un servidor MCP stdio autoalojado, su administrador local puede exigir TREKMAIL_ALLOW_DESTRUCTIVE=true antes de ejecutar herramientas de purga permanente y vaciado de papelera. Se trata de un control de seguridad local, no de un interruptor de funciones del producto TrekMail. Las operaciones normales de papelera también modifican datos, por lo que requieren ámbitos de escritura, pero son recuperables y no necesitan ámbitos de purga.
El envío de correo y las operaciones de escritura de migración tienen controles independientes. Habilitar las herramientas destructivas de Drive no habilita automáticamente el envío ni las escrituras de migración.
Cargas mediante MCP
Para la mayoría de los flujos de trabajo, utiliza drive_file_upload. Lee un archivo local del host MCP, solicita instrucciones de carga, envía el archivo a la URL de carga devuelta, completa la carga y cancela la reserva si algo falla.
Las herramientas de bajo nivel siguen disponibles cuando una integración necesita más control, por ejemplo, cuando los bytes del archivo proceden de otro servicio o de un proceso de transferencia personalizado.
Enlaces compartidos mediante MCP
Utiliza drive_share_create para crear una URL pública de descarga. Define expires_at y max_downloads siempre que el enlace salga de tu organización. Utiliza drive_share_revoke cuando un enlace deba dejar de funcionar. El token sin procesar solo se muestra al crearlo, por lo que los agentes deben devolver inmediatamente la URL pública completa.
Límite de facturación
Las herramientas del complemento son de solo lectura: drive_addon_get, drive_addon_pricing y drive_addon_cancellation_preview. Los agentes no pueden comprar, redimensionar ni cancelar el complemento Drive mediante MCP. Esas acciones siguen estando disponibles únicamente en el panel y bajo el control del usuario.
Artículos relacionados
Ve a guías cercanas que continúan el flujo de trabajo.