Informazioni di riferimento sul server McP di SharePoint per Microsoft 365

Importante

• Si tratta di una funzionalità di anteprima.
• Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono soggette a condizioni per l'utilizzo supplementari e sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso iniziale e fornire feedback.

Informazioni generali

ID del server	Nome visualizzato	Descrizione
mcp_SharePointRemoteServer	Server MCP di Microsoft SharePoint	Server MCP per le operazioni di SharePoint. Utilizzare questo server per la gestione di siti, elenchi, elementi di elenco, colonne, raccolte documenti, file, cartelle e condivisione file. Le operazioni di file sono limitate a ≤5 MB.

Annotazioni

Il server Microsoft SharePoint e OneDrive MCP è deprecato a partire dal 13 marzo 2026. Se si tratta di una connessione esistente, è ancora supportata. Per configurare nuove connessioni, usare il nuovo Server MCP di Microsoft SharePoint e microsoft OneDrive MCP Server.

Strumenti disponibili

findSite

Trovare i siti di SharePoint accessibili all'utente. Restituisce siti specifici corrispondenti a una query di ricerca o i primi 20 siti pertinenti se non viene fornita alcuna query.

Parametri facoltativi:

• searchQuery: Query di ricerca (nome intero o parziale del sito). Omettere di restituire i primi 20 siti accessibili

getSiteByPath

Risolvere un sito di SharePoint usando il nome host esatto e il percorso relativo al server. Usare solo quando si dispone della struttura completa dell'URL del sito. Usare findSite quando è noto solo un nome di sito.

Parametri obbligatori:

• Hostname: Nome host esatto (ad esempio, 'contoso.sharepoint.com')
• serverRelativePath: Percorso relativo al server ,ad esempio 'sites/Marketing'. La barra iniziale è facoltativa.

elencaSottoSiti

Elencare tutti i siti secondari (siti figlio) di un sito di SharePoint.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint padre (formato: 'nome host,siteCollectionId,webId')

elencaLibrerieDocumentiNelSito

Elenca le raccolte documenti (unità disco) nel sito di SharePoint specificato.

Parametri facoltativi:

• Siteid: ID del sito di SharePoint (impostazione predefinita: 'root')

getDefaultDocumentLibraryInSite

Accedere alla raccolta documenti predefinita (archivio) in un sito di SharePoint.

Parametri facoltativi:

• Siteid: ID del sito di SharePoint (impostazione predefinita: 'root')

getFolderChildren

Enumera i primi 20 file e cartelle (DriveItems) contenuti in una cartella padre specificata in una libreria documenti.

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (drive)

Parametri facoltativi:

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

findFileOrFolder

Trova un file o una cartella (DriveItem) accessibile all'utente tramite query di ricerca. Ricerche tramite tutti i siti e le raccolte di documenti a cui l'utente ha accesso.

Parametri obbligatori:

• searchQuery: Query di ricerca (nome intero o parziale del file)

getFileOrFolderMetadata

Ottenere i metadati di un file o di una cartella (DriveItem) da una raccolta documenti specificata (drive) in SharePoint.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella (DriveItem)
• documentLibraryId: ID della raccolta documenti (archivio)

getFileOrFolderMetadataByUrl

Ottenere i metadati di un file o di una cartella da un URL di condivisione. Saranno consentiti solo gli utenti con autorizzazioni esplicite esistenti per accedere al file.

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.

readSmallTextFile

Leggere (scaricare) un file di testo di dimensioni inferiori a 5 MB da una raccolta documenti specifica (drive).

Parametri obbligatori:

• fileId: ID del file (DriveItem) da leggere/scaricare
• documentLibraryId: ID della raccolta documenti (drive)

readSmallBinaryFile

Leggere un file binario di dimensioni inferiori a 5 MB da una specifica biblioteca di documenti (drive). Il contenuto del file viene restituito come stringa con codifica base64.

Parametri obbligatori:

• fileId: ID del file (DriveItem) da leggere/scaricare
• documentLibraryId: ID della raccolta documenti (drive)

createSmallTextFile

Creare o caricare un file di testo di dimensioni inferiori a 5 MB in una raccolta documenti specifica (drive).

Parametri obbligatori:

• Filename: Nome del file incluso l'estensione
• contentText: Contenuto di testo del file
• documentLibraryId: ID della raccolta documenti (disco)

Parametri facoltativi:

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

createSmallBinaryFile

Creare un file binario di dimensioni inferiori a 5 MB codificandone il contenuto in base64 in una specifica raccolta documenti (drive).

Parametri obbligatori:

• Filename: Nome del file incluso l'estensione
• base64Content: Contenuto di file binari codificato come stringa base64
• documentLibraryId: ID della raccolta documenti (disco)

Parametri facoltativi:

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

createFolder

Creare una nuova cartella (DriveItem) all'interno di una raccolta documenti (drive) specificata. Se esiste una cartella con lo stesso nome, viene aggiunto un suffisso numerico(ad esempio, NewFolder (1)).

Parametri obbligatori:

• Foldername: Nome della cartella
• documentLibraryId: ID della raccolta documenti (disco)

Parametri facoltativi:

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

renameFileOrFolder

Rinominare un file o una cartella (DriveItem) all'interno di una raccolta documenti specificata (unità). Il nuovo nome deve essere conforme alle convenzioni di denominazione.

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (disco)
• fileOrFolderId: ID del file o della cartella da rinominare
• newFileOrFolderName: Nuovo nome

Parametri facoltativi:

• Etag: ETag per il controllo della concorrenza

deleteFileOrFolder

Eliminare un file o una cartella (DriveItem) da una raccolta documenti specificata (drive).

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (disco)
• fileOrFolderId: ID del file o della cartella da eliminare

Parametri facoltativi:

• Etag: ETag per il controllo della concorrenza

moveSmallFile

Spostare un file (DriveItem) in un'altra cartella all'interno della stessa raccolta documenti. Supporta solo file inferiori a 5 MB. Impossibile spostarsi tra le unità.

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (disco)
• fileId: ID del file da spostare
• newParentFolderId: ID della cartella di destinazione (deve trovarsi nella stessa raccolta documenti)

Parametri facoltativi:

• Etag: ETag per il controllo della concorrenza

copyFileOrFolder

Copiare un file o una cartella (DriveItem) in una cartella di destinazione. Supporta la copia tra raccolte documenti diverse all'interno di SharePoint. Questa operazione è asincrona; usare checkOperationStatus per monitorare lo stato di avanzamento.

Parametri obbligatori:

• sourcedoclibid: ID della raccolta documenti di origine (drive)
• sourcefileid: ID del file o della cartella di origine da copiare
• destdoclibid: ID della raccolta documenti di destinazione (disco)
• destfolderid: ID della cartella di destinazione (deve esistere)

Parametri facoltativi:

• newfilename: Nuovo nome per l'elemento copiato

checkOperationStatus

Controllare lo stato di un'operazione asincrona , ad esempio una copia, usando il token dell'operazione restituito dall'operazione originale.

Parametri obbligatori:

• operationToken: Token dell'operazione restituito da un'operazione asincrona, ad esempio copyFileOrFolder

uploadFileFromUrl

Caricare un file da un URL di SharePoint o OneDrive in una cartella destinata in una libreria documenti. Il file viene copiato dall'URL di origine; non vengono apportate modifiche all'originale.

Parametri obbligatori:

• sourceUrl: URL di origine (deve essere un URL di SharePoint o OneDrive valido)
• destinationDocumentLibraryId: ID della raccolta documenti di destinazione. Usare "me" per l'OneDrive dell'utente

Parametri facoltativi:

• destinationFolderId: ID della cartella di destinazione (impostazione predefinita: 'root')
• Filename: Nuovo nome del file; per impostazione predefinita il nome del file originale

condividiFileOCartella

Invia un invito alla condivisione per concedere autorizzazioni di lettura/scrittura per un file o una cartella (DriveItem) all'interno di una raccolta documenti specificata (drive).

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (disco)
• fileOrFolderId: ID del file o della cartella da condividere
• recipientEmails: Matrice di indirizzi di posta elettronica dei destinatari
• Ruoli: Matrice di ruoli: 'read', 'write' (write concede sia lettura che scrittura)

Parametri facoltativi:

• Messaggio: Messaggio personalizzato per il 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)

impostaEtichettaSensibilitàSulFile

Impostare l'etichetta di riservatezza di un file dalla libreria documenti specificata (raccolta).

Parametri obbligatori:

• documentLibraryId: ID della raccolta documenti (disco)
• fileId: DriveItemId del file
• sensitivityLabelId: ID dell'etichetta di riservatezza o stringa vuota da rimuovere

Parametri facoltativi:

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

listLists

Ottenere tutti gli elenchi di SharePoint disponibili in un sito specifico. Usare per individuare gli elenchi presenti all'interno di un sito.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint (formato: 'nome host,siteCollectionId,webId')

creaLista

Creare un nuovo elenco di SharePoint all'interno di un sito.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• Displayname: Nome visualizzato del nuovo elenco

Parametri facoltativi:

• Colonne: Raccolta di colonne come coppie chiave-valore: [{ Key: 'JobTitle', Value: 'text' }]. Tipi validi: 'text', 'multilineText', 'number', 'boolean', 'dateTime', 'choice', 'lookup', 'personOrGroup', 'hyperlink', 'currency', 'calculated'
• Modello: Tipo di modello elenco (impostazione predefinita: 'genericList'). Opzioni: ElencoGenerico, BibliotecaDocumenti, Eventi, Attività, Annunci, Contatti, Collegamenti, Sondaggio, MonitoraggioProblemi, BachecaDiscussioni

deleteList

Eliminare un elenco di SharePoint da un sito. Elimina l'intero contenitore elenco e tutti gli elementi al suo interno. Non è possibile annullare l'operazione.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco da eliminare

Parametri facoltativi:

• Etag: ETag per il controllo della concorrenza

sendInviteForList

Invia un invito alla condivisione per concedere le autorizzazioni per un elenco di SharePoint.

Parametri obbligatori:

• listId: ID dell'elenco di SharePoint da condividere
• recipientEmails: Matrice di indirizzi di posta elettronica dei destinatari
• Ruolo: Ruolo: 'leggi' (solo visualizzazione), 'contribuisci' (visualizza, aggiungi, aggiorna, elimina elementi), 'modifica' (modifica completa inclusa la struttura dell'elenco)

Parametri facoltativi:

• siteUrl: URL del sito di SharePoint contenente l'elenco
• sendEmail: Indica se inviare una notifica tramite posta elettronica (impostazione predefinita: true)

listListItems

Ottieni elementi (righe/record) da uno specifico elenco di SharePoint.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint

getListItem

Ottenere un singolo elemento (riga/record) da un elenco di SharePoint in base al relativo ID.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• Itemid: ID della voce di elenco specifica

createListItem

Creare un nuovo elemento (riga/record) in un elenco di SharePoint.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• Campi: Coppie chiave-valore per i valori di campo: [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Il campo 'Title' è in genere obbligatorio

aggiornaElementoElenco

Aggiornare un elemento esistente (riga/record) in un elenco di SharePoint. Vengono aggiornati solo i campi specificati; i campi omessi mantengono i valori.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• Itemid: ID dell'elemento da aggiornare
• Campi: Coppie chiave-valore di campi da aggiornare

Parametri facoltativi:

• Etag: ETag per il controllo della concorrenza

eliminaElementoLista

Eliminare un elemento (riga/record) da un elenco di SharePoint.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• Itemid: ID dell'elemento da eliminare

Parametri facoltativi:

• Etag: ETag per il controllo della concorrenza

listColumns

Ottieni tutte le colonne da un elenco di SharePoint.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint

creaColonna

Creare una nuova colonna in un elenco di SharePoint. Supporta molti tipi di colonna, tra cui testo, numero, scelta, dateTime, booleano, utente, ricerca, calcolata e altro ancora.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• Nome: Nome colonna interno (identificatore programmatico)
• Tipo di colonna: Tipo di colonna: testo, nota, numero, intero, booleano, dataOra, scelta, multiscelta, valuta, ricerca, utente, url, calcolato, termine, multitermine, posizione, geolocalizzazione, miniatura, contatore, calcolato, contentTypeId, file, allegato, guid, risultatoScelta, statoApprovazione

Parametri facoltativi:

• columnProperties: Impostazioni specifiche del tipo (ad esempio, { "maxLength": 255 } per il testo, { "choices": ["A","B","C"] } per la scelta)
• Descrizione: Descrizione della colonna
• displayName: Nome visualizzato nell'interfaccia utente (il valore predefinito è 'name')
• Obbligatorio: Impostare la colonna obbligatoria (impostazione predefinita: false)
• Nascosto: Nascondere la colonna dalle visualizzazioni (impostazione predefinita: false)

updateColumn

Aggiornare una colonna esistente in un elenco di SharePoint.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• columnId: ID della colonna da aggiornare

Parametri facoltativi:

• Columntype: Tipo di colonna (obbligatorio quando si specifica 'columnProperties')
• columnProperties: Proprietà specifiche del tipo da aggiornare
• Descrizione: Nuova descrizione
• Displayname: Nuovo nome visualizzato
• Nascosto: Nascondere o visualizzare la colonna
• Obbligatorio: Rendi obbligatoria o facoltativa la colonna

deleteColumn

Eliminare una colonna da un elenco di SharePoint. Avviso: Rimuove tutti i dati archiviati in tale colonna per tutti gli elementi.

Parametri obbligatori:

• Siteid: ID del sito di SharePoint
• listId: ID dell'elenco di SharePoint
• columnId: ID della colonna da eliminare

Funzionalità principali

Gestione del sito

• Trovare siti in base al nome o esplorare i siti accessibili
• Ottieni il sito per percorso URL esatto
• Elencare siti figlio e sottositi
• Navigazione completa nella gerarchia dei siti

Gestione della raccolta documenti

• Elencare tutte le raccolte di documenti in un sito
• Recuperare la raccolta documenti predefinita
• Sfoglia il contenuto della cartella (fino a 20 elementi)
• Creare e gestire strutture di cartelle

Operazioni con i file

• Creare file di testo e binari (≤5 MB)
• Leggere file di testo e binari (≤5 MB)
• Eliminare, rinominare e spostare file
• Copiare file e cartelle tra raccolte documenti
• Caricare file da URL di SharePoint o OneDrive
• Cercare file e cartelle in tutti i siti accessibili
• Ottenere i metadati di file e cartelle

Operazioni asincrone

• Copiare file e cartelle in modo asincrono nelle raccolte di documenti
• Controllare lo stato delle operazioni asincrone usando i token dell'operazione

Elencare le operazioni

• Creare, leggere ed eliminare elenchi
• Supporto per più modelli di elenco (generico, raccolta documenti, eventi, attività)
• Condividere elenchi con autorizzazioni basate sui ruoli
• Gestire gli elementi elenco (creazione, lettura, aggiornamento, eliminazione)

Gestione delle colonne

• Creare colonne con un'ampia gamma di tipi (testo, nota, numero, booleano, dateTime, scelta, ricerca, utente, URL, calcolato e altro ancora)
• Aggiornare le proprietà e i metadati delle colonne
• Configurare i requisiti e la visibilità delle colonne
• Proprietà di colonna specifiche del tipo

Condivisione e autorizzazioni

• Condividere file, cartelle ed elenchi con gli utenti
• Controllo degli accessi in base al ruolo (lettura, scrittura, collaborazione, modifica)
• 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

• Le operazioni su file sono limitate a ≤5 MB per il caricamento e il download
• Le operazioni di spostamento funzionano solo all'interno della stessa raccolta documenti
• Le operazioni di copia sono asincrone; usare checkOperationStatus per monitorare lo stato di avanzamento
• Le operazioni di copia supportano la copia tra raccolte all'interno di SharePoint
• uploadFileFromUrl richiede un URL di origine di SharePoint o OneDrive valido
• Gli eTag forniscono il controllo della concorrenza per gli aggiornamenti e le eliminazioni
• Suffisso numerico automatico per i nomi di cartelle duplicati
• Impossibile annullare l'eliminazione dell'elenco
• L'eliminazione della colonna rimuove tutti i dati archiviati in tale colonna
• Le operazioni di ricerca restituiscono i primi 20 risultati per impostazione predefinita
• Tutte le operazioni usano l'API Microsoft Graph

Annotazioni

I nomi e i parametri degli strumenti MCP sono soggetti a modifiche e le dipendenze codificate staticamente devono essere evitate. Verrà mantenuto il supporto per lo scenario.