Conectar agentes de IA a TrekMail Drive

Un agente de IA puede gestionar archivos de Drive de forma segura si le proporcionas un token restringido y reglas claras. Esta guía se centra en la configuración específica de Drive para agentes compatibles con MCP. Para la instalación general de MCP, consulta Conectar agentes de IA (MCP).

Elegir la función del agente

Empieza por nombrar el flujo de trabajo, no la herramienta. Estos son algunos buenos ejemplos:

• client-delivery-links crea enlaces públicos para archivos aprobados.
• monthly-report-uploader carga los PDF generados en Drive de la cuenta.
• mailbox-file-assistant busca en el Drive de un buzón.
• storage-monitor consulta el uso y el estado del complemento.

Un nombre específico facilita mucho la revisión del token y de los registros de auditoría más adelante.

Crear un token con ámbito limitado

Abre Agentes de IA y API → Tokens → Crear token. Para un agente exclusivo de Drive, selecciona únicamente ámbitos de Drive. La mayoría de los agentes no necesitan purga.

Ejemplos:

Copia el token una vez. TrekMail no volverá a mostrarlo.

Configurar MCP

Define el token de operaciones en tu entorno MCP:

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

Este es un control de seguridad de MCP autoalojado, no un interruptor de funciones de Drive. Mantén TREKMAIL_ALLOW_DESTRUCTIVE=false para el trabajo normal con Drive y actívalo únicamente en una limpieza revisada que necesite herramientas de purga.

Si el mismo agente también lee o envía correo, añade por separado un token de mensajes:

TREKMAIL_MESSAGE_TOKEN=tm_msg_your_message_token

Las herramientas de Drive no utilizan tokens de mensajes. Las herramientas de mensajes no utilizan ámbitos de Drive.

Probar primero con herramientas inofensivas

Pide al agente que llame a:

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

Estas llamadas confirman que el token funciona sin modificar datos. Después, prueba una carga pequeña en una carpeta temporal.

Dar al agente reglas de funcionamiento seguras

Un prompt de sistema práctico para un agente de Drive debe incluir:

• Nunca purgar archivos a menos que el usuario lo pida explícitamente.
• Preferir la papelera a la eliminación permanente.
• Añadir caducidad y límites de descarga a los enlaces públicos.
• Devolver inmediatamente las URL de uso compartido creadas.
• Usar Drive de la cuenta para archivos del equipo y Drive del buzón solo cuando la tarea indique un buzón.
• Comprobar el uso del almacenamiento antes de cargar archivos grandes.

Auditar después de la configuración

Abre Agentes de IA y API → Registro de auditoría y filtra por el nombre del token. Comprueba que el agente solo haya llamado a las herramientas de Drive previstas. Si un token tiene demasiados ámbitos, revócalo y crea uno nuevo más restringido.