Visão geral das ferramentas MCP do Drive para agentes de IA
Conheça as 42 ferramentas MCP do TrekMail Drive para agentes de IA: uploads, links partilhados, operações em massa, exclusão segura e acesso de leitura.
Detalhes do artigo
Tipo, dificuldade, planos e data da última atualização.
▼
Detalhes do artigo
Tipo, dificuldade, planos e data da última atualização.
- Tipo
- Referência
- Dificuldade
- Intermediário
- Planos
- Starter · Pro · Agency · + Drive Add-on
- Última atualização
- 10 de set de 2026
O servidor MCP do TrekMail disponibiliza o TrekMail aos agentes de IA como ferramentas estruturadas para armazenamento de arquivos, links públicos, limpeza segura e senhas de dispositivos de sincronização. Uma conexão vê apenas as ferramentas permitidas por suas credenciais, conjuntos de ferramentas selecionados, transporte e controles de segurança. Consulte a lista de ferramentas disponibilizada ao agente em vez de depender de uma contagem fixa do catálogo.
O MCP costuma ser mais simples para agentes do que o REST bruto. Em vez de pedir a um agente que monte solicitações HTTP, você oferece ferramentas como drive_file_upload, drive_share_create ou drive_bulk_move. Nos bastidores, a API continua aplicando escopos de token, idempotência, logs de auditoria e controles de segurança.
Cobertura das ferramentas
| Grupo de ferramentas | Ferramentas | O que os agentes podem fazer |
|---|---|---|
| Espaços e uso | drive_spaces_list, drive_storage_summary, drive_space_usage |
Descobrir o Drive da conta, os espaços de caixas de correio permitidos e o status da cota |
| Navegação e seleção | drive_browse_folder, drive_folder_tree, drive_select_all_ids |
Navegar por pastas e preparar operações em massa com segurança |
| Arquivos | drive_file_get, drive_file_download_url, drive_file_rename, drive_file_move, drive_file_trash, drive_file_restore, drive_file_purge |
Ler metadados, baixar, renomear, mover, enviar à lixeira, restaurar ou excluir permanentemente um arquivo |
| Pastas | drive_folder_create, drive_folder_update, drive_folder_move, drive_folder_trash, drive_folder_restore, drive_folder_purge |
Criar e gerenciar árvores de pastas |
| Compartilhamento em equipe | drive_folder_share_with_account, drive_folder_stop_sharing |
Tornar uma pasta de nível superior visível para todas as caixas de correio ou encerrar a visibilidade em toda a conta |
| Lixeira | drive_trash_list, drive_trash_empty |
Revisar a lixeira ou esvaziá-la permanentemente quando o controle destrutivo estiver habilitado |
| Operações em massa | drive_bulk_trash, drive_bulk_restore, drive_bulk_move, drive_bulk_purge |
Mover, enviar à lixeira, restaurar ou excluir permanentemente até 5.000 itens selecionados |
| Links públicos | drive_share_create, drive_share_list, drive_share_revoke |
Criar links de download com validade ou limite e revogá-los depois |
| Uploads | drive_file_upload, drive_upload_initiate, drive_upload_complete, drive_upload_refresh_parts, drive_upload_abort |
Enviar arquivos locais com um wrapper simples ou conduzir manualmente o fluxo multipartes |
| Status do complemento | drive_addon_get, drive_addon_pricing, drive_addon_cancellation_preview |
Consultar o estado e o preço do complemento de armazenamento sem alterar o faturamento |
| Dispositivos de sincronização | drive_device_list, drive_device_create, drive_device_revoke, drive_device_rotate |
Criar, revisar, revogar ou trocar uma senha separada para um aplicativo de sincronização WebDAV |
Requisitos do token
As ferramentas MCP do Drive usam a variável de ambiente do token de operações:
TREKMAIL_API_TOKEN=tm_live_your_token
O token deve incluir os escopos correspondentes do Drive. Por exemplo, drive_share_create exige um escopo de compartilhamento para o espaço do Drive do arquivo. drive_file_purge exige um escopo de exclusão permanente e o controle de ferramentas destrutivas. As ferramentas de dispositivos de sincronização precisam de drive:devices:read ou drive:devices:write; a senha de dispositivo criada é exibida apenas uma vez. As respostas incluem o server_url correto, inclusive um endereço DAV personalizado somente depois que o certificado e o host restrito estiverem prontos.
Você pode executar ferramentas do Drive junto com ferramentas de mensagens fornecendo também TREKMAIL_MESSAGE_TOKEN. As duas famílias de tokens permanecem separadas.
Controles de segurança
Em um servidor MCP stdio auto-hospedado, o administrador local pode exigir TREKMAIL_ALLOW_DESTRUCTIVE=true antes da execução das ferramentas de exclusão permanente e de esvaziamento da lixeira. Esse é um controle de segurança local, não uma opção de recurso do produto TrekMail. As operações normais da lixeira também alteram dados e, por isso, exigem escopos de escrita, mas são recuperáveis e não precisam de escopos de exclusão permanente.
O envio de e-mails e as operações de escrita de migração têm controles separados. Habilitar as ferramentas destrutivas do Drive não habilita automaticamente o envio nem as escritas de migração.
Uploads por MCP
Para a maioria dos fluxos de trabalho, use drive_file_upload. Ela lê um arquivo local do host MCP, solicita instruções de upload, envia o arquivo para a URL de upload retornada, conclui o upload e cancela a reserva se algo falhar.
As ferramentas de baixo nível continuam disponíveis quando uma integração precisa de mais controle, por exemplo, quando os bytes do arquivo vêm de outro serviço ou de um processo de transferência personalizado.
Links de compartilhamento por MCP
Use drive_share_create para criar uma URL pública de download. Defina expires_at e max_downloads sempre que o link sair da sua organização. Use drive_share_revoke quando um link precisar parar de funcionar. O token bruto é mostrado apenas na criação, portanto os agentes devem retornar imediatamente a URL pública completa.
Limite de faturamento
As ferramentas do complemento são somente leitura: drive_addon_get, drive_addon_pricing e drive_addon_cancellation_preview. Os agentes não podem comprar, redimensionar nem cancelar o complemento Drive por MCP. Essas ações continuam restritas ao painel e sob controle do usuário.
Artigos relacionados
Vá para guias próximos que dão continuidade ao fluxo de trabalho.