Informazioni di riferimento su Microsoft SharePoint e OneDrive MCP Server

Panoramica

Strumenti disponibili

createFolder

Crea una nuova cartella all'interno di una raccolta documentale specificata come sottocartella della cartella principale specificata. Se non si specifica una raccolta documenti, il server usa il OneDrive dell'utente. Se non specifichi una cartella padre, il server crea la cartella nella radice. Se esiste già una cartella con lo stesso nome, il server crea la nuova cartella con un suffisso numerico, ad esempio NewFolder (1).

Parametri obbligatori:

• folderName(stringa): nome della cartella da creare. Se esiste già una cartella con lo stesso nome, il server aggiunge un suffisso numerico al nome della nuova cartella, ad esempio NewFolder (1).
• documentLibraryId(string) – ID della libreria documenti (chiamata anche unità) dove vuoi creare la cartella. Se si desidera creare una cartella nell'unità dell'utente o nel relativo OneDrive, ad esempio "my drive" o "my OneDrive", inviare "me" come documentLibraryId.

Parametri facoltativi:

• parentFolderId(stringa, default = "root") – ID della cartella genitore sotto cui viene creata la nuova cartella. L'impostazione predefinita è la radice della raccolta documenti, se non specificata.

findSite

Trova SharePoint siti a cui l'utente può accedere. Questo strumento può trovare un sito specifico in base a una query di ricerca specificata oppure trovare i primi 20 siti pertinenti accessibili dall'utente se non fornisci una query di ricerca.

Parametri obbligatori:

Nessuno

Parametri facoltativi:

• searchQuery(stringa, predefinita = null): query di ricerca che può essere il nome del sito intero o parziale. Fornire una query di ricerca consente di cercare in modo efficiente un sito, ma solo se l'utente sta cercando un sito specifico. Ad esempio, se l'utente richiede un sito denominato xyz, si passerebbe xyz come searchQuery. Se l'utente chiede solo "i miei siti", lascia vuoto questo parametro.

elencaLibrerieDocumentiNelSito

Elenca le raccolte documenti (dette anche unità) nel sito di SharePoint specificato. Se non specifichi un sito, il server usa il sito radice.

Parametri obbligatori:

Nessuno

Parametri facoltativi:

• siteId: ID sito (impostazione predefinita: radice)

findFileOrFolder

Trova un file o una cartella (detta anche DriveItem) che l'utente può access passando una query di ricerca.

Parametri obbligatori:

• searchQuery: query di ricerca che può essere il nome file intero o parziale

renameFileOrFolder

Rinomina un file o una cartella (nota anche come DriveItems) all'interno della libreria documentale specificata. Nota: il nuovo nome deve essere conforme alle convenzioni di denominazione.

Parametri obbligatori:

• documentLibraryId: ID della libreria documentale (stringa)
• fileOrFolderId: ID di file o cartella (stringa)
• newFileOrFolderName: nuovo nome per il file o la cartella (stringa)

deleteFileOrFolder

Elimina un file o una cartella dalla libreria documentale specificata.

Parametri obbligatori:

• documentLibraryId: ID della libreria documentale (stringa)
• fileOrFolderId: ID di file o cartella (stringa)

readSmallTextFile

Leggi (scarica) un file di testo da una specifica libreria di documenti. Se non si specifica una raccolta documenti, viene usato il OneDrive dell'utente. Devi fornire un fileId (driveItemId di un file ) per identificare e scaricare il file.

Parametri obbligatori:

• fileId(stringa)
• documentLibraryId(string) – ID della libreria documentale (nota anche come disco) del file che vuoi leggere. L'utente chiede di leggere o scaricare un file nel proprio drive o nel proprio OneDrive, come "Leggere un file nel proprio drive" o "Leggere un file nel proprio OneDrive" inviato in "me" come documentLibraryId.

moveSmallFile

Sposta un file situato nella libreria documentale specificata in un'altra cartella. Questo strumento supporta solo lo spostamento per i file inferiori a 5 MB e gli spostamenti all'interno dello stesso sito. Non puoi spostare file tra unità usando questa richiesta.

Parametri obbligatori:

• documentLibraryId(string) – ID della libreria documentale (nota anche come disco) del file che vuoi spostare. Utilizza questo parametro quando un utente ti chiede di spostare un file nel suo Drive o nel suo OneDrive. Ad esempio, "Spostare un file nella mia unità" o "Spostare un file nel mio OneDrive", inviare "me" come documentLibraryId.
• fileId(stringa) – ID del file da spostare.
• newParentFolderId(stringa): ID della cartella di destinazione in cui spostare il file. Deve trovarsi nella stessa raccolta documenti del percorso originale del file.

getFileOrFolderMetadata

Ottieni i metadati di un file o di una cartella dalla libreria documentale specificata in un sito SharePoint.

Parametri obbligatori:

• FileOrFolderId(string) – ID di un file o di una cartella. Sono anche chiamati DriveItems. Il loro ID può anche essere talvolta chiamato driveItemId.
• documentLibraryId(stringa) – ID della libreria documentale (nota anche come drive) del file o cartella per cui hai bisogno dei metadati. Usare questo parametro quando un utente chiede di accedere a un file o una cartella nel Drive o nel relativo OneDrive. Ad esempio, "Recupera metadati di un file nel mio drive" o "Recupera metadati di una cartella nel mio OneDrive" inserisci "me" come documentLibraryId.

createSmallTextFile

Crea o carica un file di testo inferiore a 5 MB in una specifica libreria di documenti. Se non si specifica una raccolta documenti, viene usato il OneDrive dell'utente. Puoi caricare il file in una cartella specifica. Se non specifichi una cartella, il file viene caricato nella cartella radice.

Parametri obbligatori:

• filename (string) – Nome del file da creare.
• contentText (stringa) – Contenuto testuale del file da creare.
• documentLibraryId (stringa) – ID della libreria documenti (chiamata anche disco) per il file. Se un utente chiede di creare un file nel loro drive o nel loro OneDrive, ad esempio "creare un file nel mio drive" o "creare un file nel mio OneDrive", inviare "me" come documentLibraryId.

Parametri facoltativi:

• parentfolderId(stringa, predefinita = "radice"): ID cartella all'interno dell'unità per aggiungere il nuovo file.

getFileOrFolderMetadataByUrl

Recupera i metadati per un file o una cartella da un URL di condivisione. Solo gli utenti con autorizzazioni esplicite per accedere al file possono ottenere i metadati.

Parametri obbligatori:

• fileOrFolderUrl:(string) – URL del file o della cartella (noto anche come DriveItems). Il parametro URL non concede l'autorizzazione per condividere l'oggetto con l'utente; L'utente deve avere già access esplicito nel file.

condividiFileOCartella

Invia un invito di condivisione per concedere permessi su un file o una cartella all'interno di una libreria documentale specificata. Supporta l'assegnazione di ruoli e la notifica dei destinatari.

Parametri obbligatori:

• documentLibraryId: ID biblioteca documenti (stringa, obbligatorio)
• fileOrFolderId: ID del file o della cartella (stringa, richiesto)
• recipientEmails:(stringa[], obbligatoria): indirizzi e-mail dei destinatari da invitare. È necessario almeno un indirizzo e-mail del destinatario.

Parametri facoltativi:

• roles(stringa[]): ruoli da assegnare ai destinatari. Valori accettati: lettura, scrittura (scrittura concede accesso sia in lettura che in scrittura). Il valore predefinito è il ruolo di lettura, se non specificato.
• sendInvitation(bool, predefinito = vero): indica se inviare un invito alla condivisione. Il valore predefinito è Vero se non specificato.
• message(stringa, predefinito = "Ecco il file su cui stiamo collaborando."): messaggio personalizzato da includere nel messaggio di invito. L'impostazione predefinita è un messaggio standard se non specificato.

getFolderChildren

Elenca i primi 20 file e cartelle all'interno di una cartella genitore specificata in una libreria documentale. Se non si specifica una raccolta documenti, viene usato il OneDrive dell'utente.

Parametri obbligatori:

• documentLibraryId(string) – ID della libreria di documenti (chiamata anche drive) per la cartella genitore. Se un utente chiede di ottenere i file in una cartella nel suo drive o nel suo OneDrive, ad esempio "recuperare i file in una cartella nel mio drive" o "recuperare i file in una cartella nel mio OneDrive", inviare "me" come documentLibraryId.

Parametri facoltativi:

• parentFolderId:(string, default = "root") – ID della cartella genitore (DriveItem) i cui file e cartelle sono elencati. Di default si trova nella cartella radice della libreria documenti se non specificato.

Echo

Invia il messaggio al client.

Parametri obbligatori:

• message: messaggio da inviare

impostaEtichettaSensibilitàSulFile

Imposta l'etichetta di sensibilità di un file dalla libreria documentale specificata.

Parametri obbligatori:

• documentLibraryId(string) – L'ID della libreria documenti, noto anche come driveId, della libreria documenti.
• fileId(stringa) – L'ID file, noto anche come driveItemId, del file.
• sensitivityLabelId(stringa): obbligatorio. ID dell'etichetta di riservatezza da assegnare o una stringa vuota per rimuovere l'etichetta di riservatezza.

Parametri facoltativi:

• assignmentMethod(stringa, predefinito = "privileged") - Il metodo di assegnazione dell'etichetta sul documento. Indica se l'assegnazione dell'etichetta è stata eseguita automaticamente, standard o come operazione con privilegi (equivalente a un'operazione di amministratore). I valori consentiti sono standard, privileged, auto e unknownFutureValue.
• justificationText(stringa, predefinita = "Changed by MCPServer") – Opzionale. Il testo della giustificazione a scopo di controllo è obbligatorio quando si esegue il downgrade o la rimozione di un'etichetta.

getDefaultDocumentLibraryInSite

Ottieni la raccolta documenti predefinita (chiamata anche raccolta) in un sito di SharePoint. Se non specifichi un sito, viene usato il sito radice.

Parametri obbligatori:

Nessuno

Parametri facoltativi:

• siteId: ID sito (impostazione predefinita: radice)

Funzionalità chiave

Gestione della cartella

• Creare cartelle con risoluzione automatica dei conflitti di denominazione
• Enumerare gli elementi figlio della cartella (primi 20)
• Spostare file tra cartelle (all'interno dello stesso sito)

Operazioni con i file

• Creare e caricare piccoli file di testo (meno di 5 MB)
• Leggere e scaricare file di testo
• Rinominare file e cartelle
• Eliminare file e cartelle
• Recuperare i metadati di file e cartelle in base all'ID o all'URL

Individuazione di siti e raccolte

• Trovare SharePoint siti tramite query di ricerca
• Elenca le raccolte di documenti in un sito
• Recuperare la raccolta documenti predefinita

Condivisione e autorizzazioni

• Condividere file e cartelle con assegnazioni di ruolo
• Inviare inviti di condivisione con messaggi personalizzati
• Access control tramite autorizzazioni esplicite

Sicurezza e conformità

• Impostare le etichette di riservatezza nei file
• Supporto per metodi di assegnazione automatica, standard e con privilegi
• Testo della giustificazione per il controllo della conformità

Integrazione

• supporto online OneDrive e SharePoint
• Connessione al server specifica del tenant
• DriveItem astrazione per file e cartelle

Note

• La raccolta documenti predefinita è 'me' (OneDrive dell'utente)
• La cartella padre predefinita è 'radice'
• Conflitti di nomi di cartella risolti con suffissi numerici
• Lo spostamento dei file è limitato a meno di 5 MB e all'interno dello stesso sito
• Gli URL di condivisione richiedono autorizzazioni access esplicite
• DriveItems rappresentano sia file che cartelle
• Limite massimo di 20 elementi per l'enumerazione degli elementi figli delle cartelle