Riferimenti del server MCP per gli strumenti di SharePoint

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_SharePointListsTools	Server MCP degli elenchi di Microsoft SharePoint	Server MCP che fornisce gli strumenti SharePoint di Microsoft Graph per gli elenchi. Server MCP che fornisce gli strumenti SharePoint di Microsoft Graph per gli elenchi.

Strumenti disponibili

sharepoint_createList

Creare un nuovo elenco SharePoint in un sito.

Parametri necessari

• siteId: ID univoco del sito
• displayName: nome visualizzato dell'elenco
• list: elenca informazioni come il modello (ad esempio, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Crea una nuova colonna (columnDefinition) in un elenco di SharePoint specifico. È necessario specificare il valore siteId e listId di destinazione, oltre a una definizione di colonna valida che specifica il nome della colonna, il nome visualizzato e esattamente un tipo di colonna, ad esempio text, number, choice, dateTime, personOrGroup, lookup, boolean o hyperlinkOrPicture.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco
• name: NOME API/statico della colonna (senza spazi, 1-64 caratteri)

Parametri facoltativi:

• displayName: nome visualizzato rivolto all'utente
• description: descrizione della colonna
• enforceUniqueValues: se true, i valori devono essere univoci
• hidden: se true, la colonna è nascosta
• indexed: se true, i valori vengono indicizzati
• required: se true, è necessario un valore
• readOnly: se true, i valori non possono essere modificati
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: impostazioni del tipo di colonna (una richiesta)

sharepoint_createListItem

Creare un nuovo elemento in un elenco di SharePoint.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco
• fields: valori di campo per l'elemento di elenco (mappa chiave/mappa valori)

sharepoint_deleteListColumn

Elimina una columnDefinition esistente da un elenco di SharePoint specifico. Specifica siteId, listId e columnId. Questa azione rimuove definitivamente la colonna dallo schema dell'elenco.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco
• columnId: ID univoco della colonna da eliminare

sharepoint_deleteListItem

Eliminare una voce di elenco.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco
• itemId: ID univoco dell'elemento dell'elenco

Parametri facoltativi:

• ifMatch: ETag facoltativo per il controllo di concorrenza (ad esempio, "*")

sharepoint_editListColumn

Aggiorna columnDefinition esistente su un elenco di SharePoint specifico. Specifica siteId, listId e columnId. Il corpo è parziale: includi solo le proprietà da modificare, ad esempio displayName, description, hidden, required o impostazioni del facet.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco
• columnId: ID univoco della colonna da aggiornare

Parametri facoltativi:

• displayName: nome visualizzato rivolto all'utente
• description: descrizione della colonna
• hidden: se true, la colonna è nascosta
• required: se true, è necessario un valore
• enforceUniqueValues: se true, i valori devono essere univoci
• indexed: se true, i valori vengono indicizzati
• readOnly: se true, i valori non possono essere modificati
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: aggiorna le impostazioni del tipo di colonna

sharepoint_getSiteByPath

Risolvi un sito di SharePoint usando il nome host e il percorso relativo al server.

Parametri obbligatori:

• hostname: nome host del tenant di SharePoint (ad esempio, contoso.sharepoint.com)
• serverRelativePath: percorso relativo al server del sito (ad esempio, sites/Marketing)

sharepoint_listListColumns

Elenca le definizioni di colonna (risorse columnDefinition) per un elenco di SharePoint specifico. Richiede siteId e listId. Supporta parametri OData come $select, $top e $skiptoken.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco

Parametri facoltativi:

• select: elenco delimitato da virgole di proprietà da restituire
• filter: espressione di filtro OData per limitare i risultati
• orderBy: elenco delimitato da virgole di proprietà da ordinare per
• top: Dimensioni della pagina (1-999)
• skiptoken: token opaco per il paging al set successivo

sharepoint_listListItems

Elenca gli elementi da un elenco di SharePoint.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco

Parametri facoltativi:

• expand: espansione OData facoltativa (ad esempio, campi)
• top: Dimensioni della pagina facoltative
• filter: espressione di filtro OData facoltativa
• select: Clausola di selezione OData facoltativa

sharepoint_listLists

Elenca tutti gli elenchi di SharePoint in un sito.

Parametri obbligatori:

• siteId: ID univoco del sito

sharepoint_listSubsites

Elenca i siti figlio (siti secondari) per un determinato sito.

Parametri obbligatori:

• siteId: ID univoco del sito

sharepoint_search

Esegui ricerche in SharePoint usando l'API Cerca di Microsoft Graph con entityTypes=["site"].

Parametri obbligatori:

• requests: matrice di oggetti searchRequest

Parametri facoltativi:

• entityTypes: deve essere ["site"] per le ricerche nei siti di SharePoint
• query: eseguire query su un oggetto con una stringa di ricerca in stile KQL
• from: offset in base zero del primo risultato
• size: Numero di risultati da restituire (1-50)
• fields: elenco facoltativo di campi da selezionare nella risposta

13. sharepoint_searchSitesByName

Esegui ricerche nei siti di SharePoint in base al nome visualizzato o all'URL parziale (linguaggio naturale).

Parametri obbligatori:

• search: nome visualizzato o nome parziale/URL del sito di SharePoint da cercare

Parametri facoltativi:

• consistencyLevel: obbligatorio da Microsoft Graph (impostazione predefinita: finale)

14. sharepoint_updateListItem

Aggiorna i campi di una voce di elenco esistente.

Parametri obbligatori:

• siteId: ID univoco del sito
• listId: ID univoco dell'elenco
• itemId: ID univoco dell'elemento dell'elenco
• fields: valori dei campi da aggiornare (parziale)

Parametri facoltativi:

• ifMatch: ETag facoltativo per il controllo di concorrenza (ad esempio, "*" da forzare)

Funzionalità chiave    

Gestione degli elenchi

• Creare nuovi elenchi di SharePoint con modelli
• Elenca tutti gli elenchi in un sito
• Supporto per vari modelli di elenco (genericList, documentLibrary, issueTracking)

Operazioni di colonne

• Crea colonne con più tipi di dati (text, number, choice, dateTime, personOrGroup, lookup, boolean, hyperlinkOrPicture)
• Modifica colonne esistenti
• Eliminare colonne
• Elenca tutte le colonne in un elenco
• Vincoli di convalida e univocità delle colonne

Operazioni sugli elementi

• Creare elementi dell'elenco con valori di campo
• Aggiorna le voci di elenco esistenti (aggiornamenti parziali)
• Elimina gli elementi dell'elenco
• Elementi dell'elenco con filtro e impaginazione
• Controllo della concorrenza tramite ETag

Individuazione sito

• Esegui ricerche nei siti in base al nome o all'URL
• Risolvi i siti in base al nome host e al percorso
• Elenca siti secondari
• Ricerca in stile KQL con l'API Cerca di Microsoft Graph

Supporto di query OData

• Usa $select per scegliere le proprietà.
• Usa $filter per filtrare i risultati.
• Usa $expand per includere entità correlate.
• Usa $orderby per ordinare i risultati.
• Usa $top per l'impaginazione.
• Usa $skiptoken per scorrere set di risultati di grandi dimensioni.

Supporto per tipi di colonna

• Colonne di testo (riga singola o multilinea, testo normale o rtf).
• Colonne numeri (con cifre decimali, valori minimi e massimi).
• Colonne di scelta (caselle di controllo, elenco a discesa o pulsanti di opzione).
• Colonne booleane.
• Colonne DateTime (solo data o data e ora).
• Colonne Persona o Gruppo (selezione singola o multipla).
• Colonne di ricerca (fanno riferimento ad altri elenchi).
• Colonne Collegamento ipertestuale o Immagine.

Note

1. Tutte le operazioni usano l'API Microsoft Graph v1.0.
2. I nomi delle colonne devono avere da 1 a 64 caratteri senza spazi.
3. Ogni colonna deve specificare esattamente un tipo di colonna.
4. Il controllo di concorrenza è disponibile tramite l'intestazione If-Match.
5. Per le ricerche del sito è necessario avere consistencyLevel impostato su eventual.
6. I risultati della ricerca sono limitati a 50 elementi per pagina.
7. Gli aggiornamenti parziali sono supportati per le colonne e gli elementi di elenco.