Informazioni di riferimento sul server McP di Microsoft 365 OneDrive

Informazioni generali

Strumenti disponibili

ottieniOneDrive

Ottenere informazioni su OneDrive dell'utente, inclusi i metadati dell'unità, la quota e le informazioni sul proprietario.

Non è necessario alcun parametro.

getFolderChildrenInMyOnedrive

Enumera i primi 20 file e cartelle (DriveItems) contenuti in una cartella padre specificata in OneDrive dell'utente.

Parametri facoltativi:

• parentFolderId: ID della cartella padre i cui file e cartelle verranno elencati (impostazione predefinita: 'root')

trovaFileOCartellaNelMioDrive

Trova un file o una cartella (DriveItem) nella query di ricerca di OneDrive dell'utente. Più efficiente rispetto alla ricerca di tutti i file accessibili se si sa che l'elemento si trova in OneDrive dell'utente.

Parametri obbligatori:

• searchQuery: Query di ricerca; può essere l'intero o parziale nome di file

getFileOrFolderMetadataInMyOnedrive

Ottenere i metadati di un file o di una cartella (DriveItem) da OneDrive dell'utente.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella in OneDrive dell'utente

getFileOrFolderMetadataByUrl

Ottenere i metadati di un file o di una cartella (DriveItem) da un URL di condivisione. Solo gli utenti con autorizzazioni esplicite esistenti per accedere al file potranno ottenere i metadati.

Parametri obbligatori:

• fileOrFolderUrl: URL del file o della cartella. L'URL non verrà utilizzato per condividerlo con l'utente; deve già avere un accesso esplicito.

leggiFileDiTestoPiccoloDaMioOnedrive

Leggere (scaricare) un file di testo da OneDrive dell'utente. È necessario specificare un fileId (driveItemId) per identificare e scaricare il file.

Parametri obbligatori:

• fileId: DriveItemId del file da leggere/scaricare

creaPiccoloFileDiTestoNelMioOnedrive

Creare o caricare un file di testo di dimensioni inferiori a 5 MB in OneDrive dell'utente.

Parametri obbligatori:

• Filename: Nome del file da creare
• contentText: Contenuto di testo del file

Parametri facoltativi:

• parentFolderId: ID della cartella padre (impostazione predefinita: 'root')

creaCartellaNelMioOneDrive

Creare una nuova cartella (DriveItem) nell'OneDrive dell'utente come sottocartella della cartella principale specificata. Se esiste già una cartella con lo stesso nome, viene aggiunto un suffisso numerico(ad esempio, NewFolder (1)).

Parametri obbligatori:

• Foldername: Nome della cartella da creare

Parametri facoltativi:

• parentFolderId: ID della cartella padre (impostazione predefinita: 'root')

rinominaFileOCartellaNelMioOnedrive

Rinominare un file o una cartella (DriveItem) in OneDrive dell'utente. Il nuovo nome deve essere conforme alle convenzioni di denominazione.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella da rinominare
• newFileOrFolderName: Nuovo nome per il file o la cartella
• Etag: Valore ETag per il controllo di concorrenza. L'operazione ha esito positivo solo se l'ETag corrente di DriveItem corrisponde

eliminaFileOCartellaNelMioOnedrive

Eliminare un file o una cartella (DriveItem) da OneDrive dell'utente.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella da eliminare
• Etag: Valore ETag per il controllo di concorrenza

moveSmallFileInMyOnedrive

Spostare un file (DriveItem) in OneDrive dell'utente in un'altra cartella. Supporta solo file inferiori a 5 MB.

Parametri obbligatori:

• fileId: ID del file da spostare
• newParentFolderId: ID della cartella di destinazione (deve trovarsi in OneDrive dell'utente)
• Etag: Valore ETag per il controllo di concorrenza

condividiFileOCartellaNelMioOnedrive

Invia un invito alla condivisione per concedere autorizzazioni di lettura/scrittura per un file o una cartella (DriveItem) in OneDrive dell'utente.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella da condividere
• recipientEmails: Matrice di indirizzi di posta elettronica dei destinatari da invitare
• Ruoli: Matrice di ruoli da assegnare. Valori accettati: 'read', 'write' ('write' concede sia la lettura che la scrittura)

Parametri facoltativi:

• Messaggio: Messaggio personalizzato da includere nel messaggio di posta elettronica di invito (impostazione predefinita: "Ecco il file su cui stiamo collaborando".)
• sendInvitation: Indica se inviare un invito alla condivisione (impostazione predefinita: true)

impostareEtichettaSensibilitàSuFileNelMioOnedrive

Impostare l'etichetta di riservatezza di un file in OneDrive dell'utente.

Parametri obbligatori:

• fileId: DriveItemId del file
• sensitivityLabelId: ID dell'etichetta di riservatezza da assegnare o una stringa vuota per rimuoverla

Parametri facoltativi:

• assignmentMethod: Metodo di assegnazione: 'standard', 'privileged', 'auto' o 'unknownFutureValue' (impostazione predefinita: 'privileged')
• justificationText: Testo della giustificazione a scopo di controllo; obbligatorio durante il downgrade o la rimozione di un'etichetta (impostazione predefinita: 'Modificato da MCPServer')

Funzionalità principali

gestione OneDrive

• Ottenere informazioni su OneDrive (quota, proprietario)
• Accedere a OneDrive personale dell'utente
• Tutte le operazioni hanno come destinazione OneDrive dell'utente autenticato

Ricerca e individuazione di file

• Cercare file e cartelle in base al nome all'interno di OneDrive dell'utente
• Ottenere i metadati di file o cartelle in base all'ID o all'URL di condivisione
• Sfoglia il contenuto della cartella (fino a 20 elementi)

Operazioni con i file

• Creare file di testo (≤5 MB)
• Leggere i file di testo
• Eliminare file con controllo della concorrenza
• Rinominare i file con protezione eTag
• Spostare file tra cartelle

Gestione della cartella

• Creare cartelle con percorsi padre facoltativi
• Suffisso numerico automatico per i nomi di cartelle duplicati
• Contenuto della cartella elenco (fino a 20 elementi)
• Ottenere i metadati della cartella
• Eliminare cartelle con il controllo della simultaneità
• Rinominare le cartelle con protezione eTag

Condivisione e autorizzazioni

• Condividere file e cartelle con gli utenti
• Controllo degli accessi in base al ruolo (lettura, scrittura)
• Notifiche tramite posta elettronica per la condivisione
• Messaggi personalizzati negli inviti

Sicurezza e conformità

• Applicare e rimuovere etichette di riservatezza
• Più metodi di assegnazione (standard, con privilegi, auto)
• Supporto per la giustificazione del controllo
• Controllo di concorrenza con eTag

Note

• Tutte le operazioni sono destinate al OneDrive personale dell'utente autenticato.
• Le operazioni su file sono limitate a ≤5 MB per il caricamento e il download
• Le operazioni di eliminazione, ridenominazione e spostamento richiedono eTag per il controllo della concorrenza
• Tutte le operazioni usano l'API Microsoft Graph
• La condivisione richiede indirizzi di posta elettronica validi e autorizzazioni appropriate
• Le etichette di riservatezza richiedono licenze e configurazione appropriate
• L'elenco di cartelle restituisce un massimo di 20 elementi per impostazione predefinita
• La protezione eTag impedisce conflitti nelle operazioni simultanee