Informazioni di riferimento sul server MCP di Microsoft SharePoint e OneDrive

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

Panoramica

ID del server	Nome visualizzato	Descrizione
mcp_ODSPRemoteServer	Server MCP di Microsoft SharePoint e OneDrive	Server MCP che fornisce strumenti per l'uso con il contenuto di SharePoint e OneDrive. Questo server si connette al server MCP di SharePoint Online specifico del tenant. Individua e rende disponibili automaticamente tutti gli strumenti che supportano l'integrazione dei file di OneDrive e SharePoint esposti dall'endpoint MCP ODSP.

Strumenti disponibili

createFolder

Crea una nuova cartella all'interno di una raccolta documenti specificata come figlio della cartella padre specificata. Se non specifichi una raccolta documenti, il server usa 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(stringa): ID della raccolta documenti (detta anche unità) in cui si vuole creare la cartella. Se vuoi creare una cartella nell'unità dell'utente o nel loro OneDrive, ad esempio "la mia unità" o "il mio onedrive", invia "me" come documentLibraryId.

Parametri facoltativi:

• parentFolderId(stringa, predefinita = "radice"): ID della cartella padre in cui verrà creata la nuova cartella. L'impostazione predefinita è la radice della raccolta documenti, se non specificata.

findSite

Trova i siti di SharePoint 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ò 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.

listDocumentLibrariesInSite

Elenca 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) a cui l'utente può accedere 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 (denominata anche DriveItems) all'interno della raccolta documenti specificata. Nota: il nuovo nome deve essere conforme alle convenzioni di denominazione.

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (stringa)
• fileOrFolderId: ID file o cartella (stringa)
• newFileOrFolderName: nuovo nome per il file o la cartella (stringa)

deleteFileOrFolder

Elimina un file o una cartella dalla raccolta documenti specificata.

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (stringa)
• fileOrFolderId: ID file o cartella (stringa)

readSmallTextFile

Leggi (scaricare) un file di testo da una raccolta documenti specifica. Se non specifichi una raccolta documenti, viene utilizzato OneDrive dell'utente. È necessario specificare un fileId (driveItemId di un file) per identificare e scaricare il file.

Parametri obbligatori:

• fileId(stringa)
• documentLibraryId(stringa): ID della raccolta documenti (detta anche unità) del file che vuoi leggere. Se l'utente chiede di leggere o scaricare un file nell'unità o nel proprio Onedrive, ad esempio, leggi un file nella "mia unità", leggi un file nel "mio onedrive" è consigliabile inviare "me" come documentLibraryId.

moveSmallFile

Sposta un file che si trova nella raccolta documenti 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(stringa): ID della raccolta documenti (detta anche unità) del file che vuoi spostare. Se l'utente chiede di spostare un file nell'unità o nel proprio Onedrive, ad esempio, sposta un file nella "mia unità", sposta un file nel "mio onedrive" è consigliabile 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

Recupera i metadati di un file o di una cartella dalla raccolta documenti specificata in un sito di SharePoint.

Parametri obbligatori:

• FileOrFolderId(stringa): ID di un file o di una cartella. Si chiamano anche DriveItems. E il relativo ID può anche essere definito anche driveItemId.
• documentLibraryId(stringa): ID della raccolta documenti (chiamata anche unità) del file o della cartella di cui sono necessari i metadati. Se l'utente chiede di ottenere un file o una cartella nell'unità o nel proprio Onedrive, ad esempio "Recupera metadati di un file nell'unità" o "Recupera metadati di una cartella nel mio onedrive", devi inviare in "me" come documentLibraryId.

createSmallTextFile

Crea o carica un file di testo di dimensioni inferiori a 5 MB in una raccolta documenti specifica. Se non specifichi una raccolta documenti, viene utilizzato 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 (stringa): nome del file da creare
• contentText (stringa): contenuto di testo del file da creare
• documentLibraryId (stringa): ID della raccolta documenti (detta anche unità) per il file. Se un utente chiede di creare un file nell'unità o nel proprio OneDrive, ad esempio "crea un file nella mia unità" o "crea un file nel mio onedrive", invia "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:(stringa): URL del file o della cartella (detto anche DriveItems). L'URL non viene riscattato per condividerlo con l'utente; in quanto devono avere già accesso esplicito al file.

shareFileOrFolder

Invia un invito alla condivisione per concedere le autorizzazioni per un file o una cartella all'interno di una raccolta documenti specificata. Supporta l'assegnazione di ruoli e la notifica dei destinatari.

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (stringa, obbligatoria)
• fileOrFolderId: ID file o cartella (stringa, obbligatoria)
• 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 l'accesso in lettura e 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

Enumera i primi 20 file e cartelle all'interno di una cartella padre specificata in una raccolta documenti. Se non specifichi una raccolta documenti, viene utilizzato OneDrive dell'utente.

Parametri obbligatori:

• documentLibraryId(stringa): ID della raccolta documenti (denominata anche unità) per la cartella padre. Se un utente chiede di ottenere file in una cartella nell'unità o nel proprio OneDrive, ad esempio "recupera i file in una cartella nella mia unità" o "recupera i file in una cartella nel mio onedrive", invia "me" come documentLibraryId.

Parametri facoltativi:

• parentFolderId:(stringa, predefinita = "radice"): ID della cartella padre (DriveItem) i cui file e cartelle sono elencati. L'impostazione predefinita è la cartella radice della raccolta documenti, se non specificata.

Echo

Invia il messaggio al client.

Parametri obbligatori:

• message: messaggio da inviare

setSensitivityLabelOnFile

Imposta l'etichetta di riservatezza di un file dalla raccolta documenti specificata.

Parametri obbligatori:

• documentLibraryId(stringa): ID della raccolta documenti, noto anche come driveId, della raccolta documenti
• fileId(stringa): 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"): metodo di assegnazione dell'etichetta nel documento. Indica se l'assegnazione dell'etichetta è stata eseguita automaticamente, standard o come operazione con privilegi (equivalente a un'operazione di amministratore). I valori possibili sono standard, con privilegi, automatica e unknownFutureValue.
• justificationText(stringa, predefinita = "Changed by MCPServer"): facoltativo. Il testo della giustificazione a scopo di controllo è obbligatorio quando si esegue il downgrade o la rimozione di un'etichetta.

getDefaultDocumentLibraryInSite

Recupera la raccolta documenti predefinita (chiamata anche Unità) 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 file di testo di piccole dimensioni (< 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 siti di SharePoint tramite query di ricerca
• Elencare le raccolte 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
• Controllo di accesso 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 di OneDrive e SharePoint Online
• Connessione al server specifica del tenant
• Astrazione driveItem per file e cartelle

Note

1. La raccolta documenti predefinita è "me" (OneDrive dell'utente)
2. La cartella padre predefinita è 'radice'
3. Conflitti di nomi di cartella risolti con suffissi numerici
4. Lo spostamento dei file è limitato a meno di 5 MB e all'interno dello stesso sito
5. Gli URL di condivisione richiedono autorizzazioni di accesso esplicite
6. DriveItems rappresenta sia file che cartelle
7. Limite massimo di 20 per l'enumerazione di elementi figlio di cartelle