Automação de Box via Rube MCP

Automatize operações de Box, incluindo upload/download de arquivos, busca de conteúdo, gerenciamento de pastas, colaboração, consultas de metadados e solicitações de assinatura através do toolkit de Box do Composio.

Pré-requisitos

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

Configuração

Obtenha 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 toolkit box
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Box
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Upload e Download de Arquivos

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

Sequência de ferramentas:

1. BOX_SEARCH_FOR_CONTENT - Encontre a pasta de destino se o caminho for desconhecido [Pré-requisito]
2. BOX_GET_FOLDER_INFORMATION - Verifique se a pasta existe e obtenha o folder_id [Pré-requisito]
3. BOX_LIST_ITEMS_IN_FOLDER - Navegue pelo conteúdo da pasta e descubra os file_ids [Opcional]
4. BOX_UPLOAD_FILE - Faça upload de um arquivo para uma pasta específica [Obrigatório para upload]
5. BOX_DOWNLOAD_FILE - Baixe um arquivo por file_id [Obrigatório para download]
6. BOX_CREATE_ZIP_DOWNLOAD - Agrupe vários arquivos/pastas em um zip [Opcional]

Parâmetros principais:

• parent_id: ID da pasta de destino para upload (use "0" para a pasta raiz)
• file: Objeto FileUploadable com s3key, mimetype e name para uploads
• file_id: Identificador único de arquivo para downloads
• version: ID de versão de arquivo opcional para baixar versões específicas
• fields: Lista separada por vírgulas de atributos a serem retornados

Armadilhas:

• Fazer upload para uma pasta com nomes de arquivo existentes pode acionar comportamento de conflito; decida entre sobrescrever ou renomear semânticas
• Arquivos com mais de 50 MB devem usar APIs de upload em partes (não disponíveis através de ferramentas padrão)
• A parte attributes do upload deve vir antes da parte file, ou você receberá um HTTP 400 com metadata_after_file_contents
• IDs de arquivo e IDs de pasta são strings numéricas extraíveis de URLs do aplicativo web do Box (por exemplo, https://*.app.box.com/files/123 retorna file_id "123")

2. Pesquisar e Navegar Conteúdo

Quando usar: O usuário deseja encontrar arquivos, pastas ou links da web por nome, conteúdo ou metadados.

Sequência de ferramentas:

1. BOX_SEARCH_FOR_CONTENT - Pesquisa de texto completo em arquivos, pastas e links da web [Obrigatório]
2. BOX_LIST_ITEMS_IN_FOLDER - Navegue pelo conteúdo de uma pasta específica [Opcional]
3. BOX_GET_FILE_INFORMATION - Obtenha metadados detalhados para um arquivo específico [Opcional]
4. BOX_GET_FOLDER_INFORMATION - Obtenha metadados detalhados para uma pasta específica [Opcional]
5. BOX_QUERY_FILES_FOLDERS_BY_METADATA - Pesquise por valores de modelo de metadados [Opcional]
6. BOX_LIST_RECENTLY_ACCESSED_ITEMS - Liste itens acessados recentemente [Opcional]

Parâmetros principais:

• query: String de pesquisa que suporta operadores ("" correspondência exata, AND, OR, NOT - apenas maiúsculas)
• type: Filtre por "file", "folder" ou "web_link"
• ancestor_folder_ids: Limite a pesquisa a pastas específicas (IDs separados por vírgula)
• file_extensions: Filtre por tipo de arquivo (separado por vírgula, sem pontos)
• content_types: Pesquise em "name", "description", "file_content", "comments", "tags"
• created_at_range / updated_at_range: Filtros de data como timestamps RFC3339 separados por vírgula
• limit: Resultados por página (padrão 30)
• offset: Deslocamento de paginação (máximo 10000)
• folder_id: Para LIST_ITEMS_IN_FOLDER (use "0" para a raiz)

Armadilhas:

• Consultas com deslocamento > 10000 são rejeitadas com HTTP 400
• BOX_SEARCH_FOR_CONTENT requer o parâmetro query ou mdfilters
• Filtros mal configurados podem omitir silenciosamente itens esperados; valide com pequenas consultas de teste primeiro
• Operadores booleanos (AND, OR, NOT) devem ser em maiúsculas
• BOX_LIST_ITEMS_IN_FOLDER requer paginação via marker ou offset/usemarker; listagens parciais são comuns
• Pastas padrão ordenam itens por tipo primeiro (pastas antes de arquivos antes de links da web)

3. Gerenciar Pastas

Quando usar: O usuário deseja criar, atualizar, mover, copiar ou excluir pastas.

Sequência de ferramentas:

1. BOX_GET_FOLDER_INFORMATION - Verifique se a pasta existe e verifique as permissões [Pré-requisito]
2. BOX_CREATE_FOLDER - Crie uma nova pasta [Obrigatório para criar]

…