Referência do OneDrive Work IQ (versão prévia)

Importante

• Este é um recurso em versão preliminar.
• As versões prévias do recurso não foram criadas para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos estão sujeitos a termos de uso suplementares e são disponibilizados antes de um lançamento oficial, de maneira que os clientes possam ter acesso antecipado e fazer comentários.

Visão geral

ID de servidor	Nome de exibição	Descrição
mcp_OneDriveRemoteServer	Work IQ OneDrive	Servidor MCP para operações de OneDrive. Use este servidor para gerenciar arquivos e pastas no OneDrive pessoal do usuário. Todas as operações de arquivo limitadas a ≤5MB.

Observação

• As conexões existentes que usam versões anteriores de servidores MCP da Microsoft, como o servidor MCP do Microsoft Teams, permanecem com suporte.
• Para todas as novas conexões, use os servidores MCP mais recentes do Work IQ, como o Work IQ Teams.

Ferramentas disponíveis

getOnedrive

Obtenha informações sobre o OneDrive do usuário, incluindo metadados de unidade, cota e informações de proprietário.

Nenhum parâmetro é necessário.

getFolderChildrenInMyOnedrive

Enumera os 20 principais arquivos e pastas, conhecidos como DriveItems, contidos em uma pasta pai especificada no OneDrive do usuário.

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai cujos arquivos e pastas serão listados (padrão: 'raiz')

procurarArquivoOuPastaNoMeuDrive

Localiza um arquivo ou pasta (DriveItem) no OneDrive do usuário por consulta de pesquisa. Mais eficiente do que pesquisar todos os arquivos acessíveis se você souber que o item está no OneDrive do usuário.

Parâmetros requeridos:

• Searchquery: Consulta de pesquisa; pode ser o nome inteiro ou parcial do arquivo

obterMetadadosDeArquivoOuPastaNoMeuOnedrive

Obtenha metadados de um arquivo ou pasta (DriveItem) do OneDrive do usuário.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta no OneDrive do usuário

getFileOrFolderMetadataByUrl

Obtenha metadados de um arquivo ou pasta (DriveItem) de uma URL de compartilhamento. Somente usuários com permissões explícitas existentes para acessar o arquivo terão permissão para obter os metadados.

Parâmetros requeridos:

• fileOrFolderUrl: URL do arquivo ou pasta. A URL não será resgatada para compartilhá-la com o usuário; eles já devem ter acesso explícito

LeituraDeArquivoTextoPequenoDoMeuOnedrive

Leia (baixe) um arquivo de texto do OneDrive do usuário. Você precisa fornecer um fileId (driveItemId) para identificar e baixar o arquivo.

Parâmetros requeridos:

• fileId: O driveItemId do arquivo a ser lido/baixado

criarArquivoPequenoDeTextoNoMeuOnedrive

Crie ou carregue um arquivo de texto de tamanho inferior a 5 MB no OneDrive do usuário.

Parâmetros requeridos:

• Filename: Nome do arquivo a ser criado
• Contenttext: Conteúdo de texto do arquivo

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai (padrão: 'raiz')

createFolderInMyOnedrive

Crie uma nova pasta (DriveItem) no OneDrive do usuário como filho da pasta pai especificada. Se já existir uma pasta com o mesmo nome, um sufixo numérico será adicionado (por exemplo, NewFolder (1)).

Parâmetros requeridos:

• Foldername: Nome da pasta a ser criada

Parâmetros opcionais:

• Parentfolderid: ID da pasta pai (padrão: 'raiz')

renomearArquivoOuPastaNoMeuOnedrive

Renomeie um arquivo ou pasta (DriveItem) no OneDrive do usuário. O novo nome deve estar em conformidade com as convenções de nomenclatura.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta a ser renomeada
• newFileOrFolderName: O novo nome para o arquivo ou pasta
• Etag: Valor de ETag para controle de simultaneidade. A operação só terá êxito se a ETag atual do DriveItem for correspondente

excluirArquivoOuPastaNoMeuOnedrive

Exclua um arquivo ou pasta (DriveItem) do OneDrive do usuário.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta a ser excluída
• Etag: Valor de ETag para controle de simultaneidade

moveSmallFileInMyOnedrive

Mova um arquivo (DriveItem) no OneDrive do usuário para outra pasta. Só dá suporte a arquivos com menos de 5 MB.

Parâmetros requeridos:

• Idarquivo: ID do arquivo a ser movido
• newParentFolderId: ID da pasta de destino (deve estar no OneDrive do usuário)
• Etag: Valor de ETag para controle de simultaneidade

compartilharArquivoOuPastaNoMeuOnedrive

Envia um convite de compartilhamento para conceder permissões de leitura/gravação em um arquivo ou pasta (DriveItem) no OneDrive do usuário.

Parâmetros requeridos:

• fileOrFolderId: ID do arquivo ou pasta a ser compartilhada
• recipientEmails: Matriz de endereços de email de destinatários a serem convidados
• roles: matriz de funções a ser atribuída. Valores aceitos: 'leitura', 'gravação' (gravação concede acesso de leitura e gravação)

Parâmetros opcionais:

• Mensagem: Mensagem personalizada a ser incluída no email de convite (padrão: 'Aqui está o arquivo no qual estamos colaborando.')
• sendInvitation: Se é necessário enviar um convite de compartilhamento (padrão: true)

definirEtiquetaDeSensibilidadeNoArquivoNoMeuOnedrive

Defina o rótulo de confidencialidade de um arquivo no OneDrive do usuário.

Parâmetros requeridos:

• fileId: A driveItemId do arquivo
• sensitivityLabelId: ID do rótulo de confidencialidade a ser atribuído ou cadeia de caracteres vazia para removê-la

Parâmetros opcionais:

• assignmentMethod: Método de atribuição: 'standard', 'privileged', 'auto' ou 'unknownFutureValue' (padrão: 'privileged')
• justificationText: Texto de justificativa para fins de auditoria; necessário ao fazer downgrade ou remover um rótulo (padrão: 'Alterado por MCPServer')

Características principais

gerenciamento de OneDrive

• Obter informações do OneDrive (cota, proprietário)
• Acessar o OneDrive pessoal do usuário
• Todas as operações têm como destino o OneDrive do usuário autenticado

Pesquisa e descoberta de arquivos

• Pesquisar arquivos e pastas por nome no OneDrive do usuário
• Obter metadados de arquivo ou pasta por ID ou URL de compartilhamento
• Procurar conteúdo de pasta (até 20 itens)

Operações de arquivo

• Criar arquivos de texto (≤5MB)
• Ler arquivos de texto
• Excluir arquivos com controle de concorrência
• Renomear arquivos com proteção de eTag
• Mover arquivos entre pastas

Gerenciamento de pastas

• Criar pastas com caminhos pai opcionais
• Sufixo numérico automático para nomes de pasta duplicados
• Listar o conteúdo da pasta (até 20 itens)
• Obter metadados de pasta
• Excluir pastas com controle de concorrência
• Renomear pastas com proteção de eTag

Compartilhamento e permissões

• Compartilhar arquivos e pastas com usuários
• Controle de acesso baseado em função (leitura, gravação)
• Notificações por email para compartilhamento
• Mensagens personalizadas em convites

Segurança e conformidade

• Aplicar e remover rótulos de confidencialidade
• Vários métodos de atribuição (padrão, privilegiado, automático)
• Suporte para justificativas em auditoria
• Controle de simultaneidade com eTags

Observações

• Todas as operações têm como destino o OneDrive pessoal do usuário autenticado
• As operações de arquivo são limitadas a ≤5MB para upload e download
• Operações de exclusão, renomeação e movimentação exigem eTags para controle de concorrência
• Todas as operações usam a API do Microsoft Graph
• O compartilhamento requer endereços de email válidos e permissões apropriadas
• Rótulos de confidencialidade exigem licenciamento e configuração adequados
• A listagem de pastas retorna no máximo 20 itens por padrão
• A proteção de eTag impede conflitos em operações simultâneas

Observação

Os nomes e parâmetros de ferramentas MCP estão sujeitos a alterações e dependências codificadas devem ser evitadas. O suporte ao cenário será mantido.