Liste di SharePoint strumenti MCP server reference

Panoramica

Strumenti disponibili

sharepoint_createList

Creare un nuovo elenco SharePoint in un sito.

Parametri necessari

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

sharepoint_createListColumn

Crea una nuova colonna (columnDefinition) in una specifica lista SharePoint. Devi fornire il siteId e listId di destinazione, oltre a una definizione valida di colonna che specifichi il nome della colonna, il nome visualizzato e esattamente un tipo di colonna (come testo, numero, scelta, dateTime, personOrGroup, ricerca, booleana 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 un esistente columnDefinition da una specifica lista SharePoint. Fornire 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: Opzionale ETag per il controllo della concorrenza (ad esempio, "*")

sharepoint_editListColumn

Aggiorna una lista SharePoint esistente columnDefinition . Fornire siteId, listId, e columnId. Il corpo è parziale: includi solo le proprietà che vuoi modificare (come displayName, descrizione, nascosto, obbligatorio o impostazioni di sfaccettatura).

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

Definizioni di colonne di elenco (columnDefinition risorse) per una specifica lista di SharePoint. 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

Cerca SharePoint usando Microsoft Graph Search API con entityTypes=["site"].

Parametri obbligatori:

• requests: matrice di oggetti searchRequest

Parametri facoltativi:

• entityTypes: deve essere ["site"] per le ricerche nei siti di SharePoint
• Richiesta: Oggetto di query con stringa di ricerca in stile keyword query language (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

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: Opzionale ETag per il controllo della concorrenza (ad esempio, "*" per forzare)

Funzionalità principali

Gestione delle liste

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

Operazioni di colonna

• Crea colonne con più tipi di dati (testo, numero, scelta, dateTime, personOrGroup, ricerca, booleano, 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

Scoperta del 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 tabelle correlate
• Usa $orderby per ordinare i risultati
• Usa $top per la paginazione
• Usa $skiptoken per scorrere grandi set di risultati

Supporto per tipi di colonna

• Colonne di testo (a una riga o a più linee, testo semplice o arricchito)
• Colonne numeriche (con decimali, valori minimi e massimi)
• Colonne di scelta (caselle di spunta, menu a tendina o pulsanti radio)
• Colonne booleane
• DateTime Colonne (solo data o data e ora)
• Colonne di persona o gruppo (selezione singola o multipla)
• Ricerca delle colonne (consulta altre liste)
• Colonne di collegamento ipertestuale o immagini

Note

• Tutte le operazioni utilizzano Microsoft Graph API v1.0
• I nomi delle colonne devono essere da 1 a 64 caratteri senza spazi
• Ogni colonna deve specificare esattamente un tipo di colonna
• Il controllo della concorrenza è disponibile tramite l'intestazione If-Match
• Le ricerche sui siti richiedono consistencyLevel di impostare come eventual
• I risultati di ricerca sono limitati a 50 elementi per pagina
• Sono supportati aggiornamenti parziali per colonne e elementi di elenco