Automação do Dropbox via Rube MCP

Automatize operações do Dropbox, incluindo upload/download de arquivos, pesquisa, gerenciamento de pastas, links de compartilhamento, operações em lote e recuperação de metadados através do kit de ferramentas Dropbox da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Dropbox via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas dropbox
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas dropbox
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Dropbox
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Pesquisar Arquivos e Pastas

Quando usar: O usuário deseja encontrar arquivos ou pastas por nome, conteúdo ou tipo

Sequência de ferramentas:

1. DROPBOX_SEARCH_FILE_OR_FOLDER - Pesquisar por string de consulta com escopo de caminho e filtros opcionais [Obrigatório]
2. DROPBOX_SEARCH_CONTINUE - Paginar resultados adicionais usando o cursor [Obrigatório se has_more]
3. DROPBOX_GET_METADATA - Validar e obter o caminho canônico para um resultado de pesquisa [Opcional]
4. DROPBOX_READ_FILE - Ler o conteúdo do arquivo para verificar se é o documento pretendido [Opcional]

Parâmetros chave:

• query: String de pesquisa (não diferencia maiúsculas de minúsculas, 1+ caracteres sem espaço em branco)
• options.path: Escopo da pesquisa para uma pasta (por exemplo, "/Documents"); string vazia para a raiz
• options.file_categories: Filtrar por tipo ("image", "document", "pdf", "folder", etc.)
• options.file_extensions: Filtrar por extensão (por exemplo, ["jpg", "png"])
• options.filename_only: Definir true para corresponder apenas a nomes de arquivos (não conteúdo)
• options.max_results: Resultados por página (padrão 100, máximo 1000)

Armadilhas:

• A pesquisa retorna has_more: true com um cursor quando existem mais resultados; DEVE continuar para evitar a perda silenciosa de correspondências
• Máximo de 10.000 correspondências no total em todas as páginas de pesquisa + search_continue
• O DROPBOX_GET_METADATA retornado path_display pode diferir em maiúsculas/minúsculas da entrada do usuário; sempre use o caminho canônico retornado
• O conteúdo do arquivo de DROPBOX_READ_FILE pode ser retornado como file_content_bytes codificado em base64; decodifique antes de analisar

2. Upload e Download de Arquivos

Quando usar: O usuário deseja fazer upload de arquivos para o Dropbox ou baixá-los dele

Sequência de ferramentas:

1. DROPBOX_UPLOAD_FILE - Fazer upload de um arquivo para um caminho especificado [Obrigatório para upload]
2. DROPBOX_READ_FILE - Baixar/ler um arquivo do Dropbox [Obrigatório para download]
3. DROPBOX_DOWNLOAD_ZIP - Baixar uma pasta inteira como um arquivo zip [Opcional]
4. DROPBOX_SAVE_URL - Salvar um arquivo de uma URL pública diretamente no Dropbox [Opcional]
5. DROPBOX_GET_SHARED_LINK_FILE - Baixar um arquivo de uma URL de link compartilhado [Opcional]
6. DROPBOX_EXPORT_FILE - Exportar arquivos não baixáveis como Dropbox Paper para markdown/HTML [Opcional]

Parâmetros chave:

• path: Caminho do Dropbox (deve começar com /, por exemplo, "/Documents/report.pdf")
• mode: "add" (padrão, falhar em conflito) ou "overwrite" para uploads
• autorename: true para renomear automaticamente em caso de conflito em vez de falhar
• content: Objeto FileUploadable com s3key, mimetype e name para uploads
• url: URL pública para DROPBOX_SAVE_URL
• export_format: "markdown", "html" ou "plain_text" para documentos Paper

Armadilhas:

• DROPBOX_SAVE_URL é assíncrono e pode levar até 15 minutos para arquivos grandes
• A pasta DROPBOX_DOWNLOAD_ZIP deve ter menos de 20 GB, sem nenhum arquivo individual com mais de 4 GB e menos de 10.000 entradas
• O conteúdo de DROPBOX_READ_FILE pode ser codificado em base64; verifique o formato da resposta
• Downloads de links compartilhados via DROPBOX_GET_SHARED_LINK_FILE podem exigir link_password para links protegidos

3. Compartilhar Arquivos e Gerenciar Links

Quando usar: O usuário deseja criar links de compartilhamento ou gerenciar links compartilhados existentes

Sequência de ferramentas:

1. DROPBOX_GET_METADATA - Confirmar se o arquivo/pasta existe e obter o caminho canônico [Pré-requisito]
2. DROPBOX_LIST_SHARED_LINKS - Verificar links compartilhados existentes para evitar duplicatas [Pré-requisito]
3. DROPBOX_CREATE_SHARED_LINK - Criar um novo link compartilhado [Obrigatório]
4. DROPBOX_GET_SHARED_LINK_METADATA - Resolver uma URL de link compartilhado para metadados [Opcional]
5. DROPBOX_LIST_SHARED_FOLDERS - Listar todas as pastas compartilhadas às quais o usuário tem acesso [Opcional]

Parâmetros chave:

…