Automação do OneDrive via Rube MCP

Automatize operações do OneDrive, incluindo upload/download de arquivos, busca, gerenciamento de pastas, links de compartilhamento, gerenciamento de permissões e navegação de drives através do kit de ferramentas OneDrive da Composio.

Pré-requisitos

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

Configuração

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

Fluxos de Trabalho Principais

1. Buscar e Navegar Arquivos

Quando usar: O usuário deseja encontrar arquivos ou navegar pelo conteúdo de pastas no OneDrive

Sequência de ferramentas:

1. ONE_DRIVE_GET_DRIVE - Verificar acesso ao drive e obter detalhes do drive [Pré-requisito]
2. ONE_DRIVE_SEARCH_ITEMS - Busca por palavras-chave em nomes de arquivos, metadados e conteúdo [Obrigatório]
3. ONE_DRIVE_ONEDRIVE_LIST_ITEMS - Listar todos os itens na raiz de um drive [Opcional]
4. ONE_DRIVE_GET_ITEM - Obter metadados detalhados para um item específico, expandir filhos [Opcional]
5. ONE_DRIVE_ONEDRIVE_FIND_FILE - Encontrar um arquivo específico pelo nome exato em uma pasta [Opcional]
6. ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Encontrar uma pasta específica pelo nome [Opcional]
7. ONE_DRIVE_LIST_DRIVES - Listar todos os drives acessíveis [Opcional]

Parâmetros-chave:

• q: Consulta de busca (apenas palavras-chave simples, NÃO sintaxe KQL)
• search_scope: "root" (hierarquia de pastas) ou "drive" (inclui itens compartilhados)
• top: Máximo de itens por página (padrão 200)
• skip_token: Token de paginação de @odata.nextLink
• select: Campos separados por vírgula a serem retornados (por exemplo, "id,name,webUrl,size")
• orderby: Ordem de classificação (por exemplo, "name asc", "name desc")
• item_id: ID do item para GET_ITEM
• expand_relations: Array como ["children"] ou ["thumbnails"] para GET_ITEM
• user_id: "me" (padrão) ou ID/e-mail de usuário específico

Armadilhas:

• ONE_DRIVE_SEARCH_ITEMS NÃO suporta operadores KQL (folder:, file:, filetype:, path:); estes são tratados como texto literal
• Caracteres curinga (*, ?) NÃO são suportados e são removidos automaticamente; use palavras-chave de extensão de arquivo em vez disso (por exemplo, "pdf" em vez de "*.pdf")
• ONE_DRIVE_ONEDRIVE_LIST_ITEMS retorna apenas conteúdo de nível raiz; use ONE_DRIVE_GET_ITEM recursivo com expand_relations: ["children"] para níveis mais profundos
• Pastas grandes são paginadas; sempre siga skip_token / @odata.nextLink até que se esgotem
• Alguns formatos de ID de drive podem retornar erros "ObjectHandle is Invalid" devido a limitações da API do Microsoft Graph

2. Upload e Download de Arquivos

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

Sequência de ferramentas:

1. ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Localizar a pasta de destino [Pré-requisito]
2. ONE_DRIVE_ONEDRIVE_UPLOAD_FILE - Fazer upload de um arquivo para uma pasta especificada [Obrigatório para upload]
3. ONE_DRIVE_DOWNLOAD_FILE - Baixar um arquivo por ID do item [Obrigatório para download]
4. ONE_DRIVE_GET_ITEM - Obter detalhes do arquivo antes do download [Opcional]

Parâmetros-chave:

• file: Objeto FileUploadable com s3key, mimetype e name para uploads
• folder: Caminho de destino (por exemplo, "/Documents/Reports") ou ID da pasta para uploads
• item_id: Identificador exclusivo do arquivo para downloads
• file_name: Nome de arquivo desejado com extensão para downloads
• drive_id: ID de drive específico (para SharePoint ou OneDrive for Business)
• user_id: "me" (padrão) ou identificador de usuário específico

Armadilhas:

• O upload renomeia automaticamente em caso de conflito (sem opção de sobrescrever por padrão)
• Arquivos grandes são tratados automaticamente via chunking
• drive_id substitui user_id quando ambos são fornecidos
• IDs de item variam por plataforma: OneDrive for Business usa o prefixo 01..., OneDrive Pessoal usa o formato HASH!NUMBER
• IDs de item diferenciam maiúsculas de minúsculas; use exatamente como retornado pela API

3. Compartilhar Arquivos e Gerenciar Permissões

Quando usar: O usuário deseja compartilhar arquivos/pastas ou gerenciar quem tem acesso

Sequência de ferramentas:

1. ONE_DRIVE_ONEDRIVE_FIND_FILE ou ONE_DRIVE_ONEDRIVE_FIND_FOLDER - Localizar o item [Pré-requisito]
2. ONE_DRIVE_GET_ITEM_PERMISSIONS - Verificar permissões atuais [Pré-requisito]

…