SharePoint liste les outils MCP Server référence

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

Vue d’ensemble

ID du serveur	Nom d’affichage	Description
mcp_SharePointListsTools	Microsoft SharePoint liste MCP serveur	Serveur MCP fournissant des outils SharePoint Microsoft Graph pour les listes.

Outils disponibles

sharepoint_createList

Créer une liste SharePoint sur un site.

Paramètres obligatoires

• siteId : ID unique du site
• displayName : nom d’affichage de la liste
• Liste : Listez des informations telles que le modèle (par exemple, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Créez une nouvelle colonne (columnDefinition) dans une liste SharePoint spécifique. Vous devez fournir le siteId et listId cibles, ainsi qu’une définition de colonne valide qui spécifie le nom de la colonne, son nom d’affichage, et exactement un type de colonne (comme texte, numéro, choix, dateTime, personOrGrouprecherche, booléen, ou hyperlinkOrPicture).

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste
• name : API/nom statique de la colonne (aucun espace, 1 à 64 caractères)

Paramètres facultatifs :

• displayName : nom d’affichage destiné aux utilisateurs
• description : description de la colonne
• enforceUniqueValues : si la valeur est true, les valeurs doivent être uniques
• hidden : si la valeur est true, la colonne est masquée
• indexed : si la valeur est true, les valeurs sont indexées
• required : si la valeur est true, une valeur est requise
• readOnly : si la valeur est true, les valeurs ne peuvent pas être modifiées
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture : paramètres du type de colonne (un requis)

sharepoint_createListItem

Créer un élément dans une liste SharePoint.

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste
• fields : valeurs des champs pour l’élément de liste (mappage clé/valeur)

sharepoint_deleteListColumn

Supprimez un existant columnDefinition d’une liste SharePoint spécifique. Fournir siteId, listId, et columnId. Cette action supprime définitivement la colonne du schéma de liste.

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste
• columnId : ID unique de la colonne à supprimer

sharepoint_deleteListItem

Supprimez un élément de liste.

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste
• itemId : ID unique de l’élément de liste

Paramètres facultatifs :

• ifMatch : Optionnel ETag pour le contrôle de la concurrence (par exemple, « * »)

sharepoint_editListColumn

Mettez à jour un existant columnDefinition sur une liste SharePoint spécifique. Fournir siteId, listId, et columnId. Le corps est partiel - incluez uniquement les propriétés que vous souhaitez modifier (comme displayName, description, caché, requis ou réglages de facett).

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste
• columnId : ID unique de la colonne à mettre à jour

Paramètres facultatifs :

• displayName : nom d’affichage destiné aux utilisateurs
• description : description de la colonne
• hidden : si la valeur est true, la colonne est masquée
• required : si la valeur est true, une valeur est requise
• enforceUniqueValues : si la valeur est true, les valeurs doivent être uniques
• indexed : si la valeur est true, les valeurs sont indexées
• readOnly : si la valeur est true, les valeurs ne peuvent pas être modifiées
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture : paramètres du type de colonne à mettre à jour

sharepoint_getSiteByPath

Résoudre un site SharePoint à l’aide de son nom d’hôte et de son chemin d’accès relatif au serveur.

Paramètres obligatoires :

• hostname : nom d’hôte du locataire SharePoint (par exemple, contoso.sharepoint.com)
• serverRelativePath : chemin d’accès relatif au serveur vers le site (par exemple, sites/marketing)

sharepoint_listListColumns

Définitions de colonnes de liste (columnDefinition ressources) pour une liste SharePoint spécifique. Nécessite siteId et listId. Prend en charge des paramètres OData tels que $select, $top et $skiptoken.

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste

Paramètres facultatifs :

• select : liste de propriétés à renvoyer, séparées par des virgules
• filter : expression de filtre OData pour restreindre les résultats
• orderBy : liste de propriétés, séparées par des virgules, pour définir l’ordre de tri
• top : format de page (1-999)
• skiptoken : jeton opaque pour passer à l’ensemble suivant

sharepoint_listListItems

Éléments d’une liste SharePoint.

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste

Paramètres facultatifs :

• expand : paramètre OData expand facultatif (par exemple, fields)
• top : format de page facultatif
• filter : expression de filtre OData facultative
• select : clause OData select facultative

sharepoint_listLists

Répertorier toutes les listes SharePoint d’un site.

Paramètres obligatoires :

• siteId : ID unique du site

sharepoint_listSubsites

Répertorier les sites enfants (sous-sites) d’un site donné.

Paramètres obligatoires :

• siteId : ID unique du site

sharepoint_search

Recherchez SharePoint en utilisant l’API Microsoft Graph Search avec entityTypes=["site"].

Paramètres obligatoires :

• requests : tableau d’objets searchRequest

Paramètres facultatifs :

• entityTypes : doit être ["site"] pour les recherches de site SharePoint
• Requête : Objet de requête avec chaîne de recherche de type langage de requête mot-clé (KQL)
• from : décalage basé sur zéro du premier résultat
• size : nombre de résultats à retourner (1 à 50)
• fields : liste facultative de champs à sélectionner dans la réponse

sharepoint_searchSitesByName

Rechercher des sites SharePoint par nom d’affichage ou URL partielle (langage naturel).

Paramètres obligatoires :

• search : nom d’affichage, nom partiel ou URL partielle du site SharePoint à rechercher

Paramètres facultatifs :

• consistencyLevel : requis par Microsoft Graph (valeur par défaut : eventual)

14. sharepoint_updateListItem

Mettre à jour les champs d’un élément de liste existant.

Paramètres obligatoires :

• siteId : ID unique du site
• listId : ID unique de la liste
• itemId : ID unique de l’élément de liste
• fields : valeurs de champ à mettre à jour (partiel)

Paramètres facultatifs :

• ifMatch : Optionnel ETag pour le contrôle de la concurrence (par exemple, « * » pour forcer)

Fonctionnalités clés

Gestion de la liste

• Créer des listes SharePoint avec des modèles
• Répertorier toutes les listes d’un site
• Prise en charge de divers modèles de listes (genericList, documentLibrary, issueTracking)

Opérations de colonne

• Créez des colonnes avec plusieurs types de données (texte, nombre, choix, dateTime, personOrGroup, recherche, booléen, hyperlinkOrPicture)
• Modifier des colonnes existantes
• Supprimer des colonnes
• Répertorier toutes les colonnes d’une liste
• Validation de colonnes et contraintes d’unicité

Opérations sur les éléments

• Créer des éléments de liste avec des valeurs de champ
• Mettre à jour les éléments de liste existants (mises à jour partielles)
• Supprimer des éléments de liste
• Répertorier des éléments de liste avec filtrage et pagination
• Contrôle de la concurrence via ETag

Découverte du site

• Rechercher des sites par nom ou URL
• Résoudre des sites par nom d’hôte et chemin d’accès
• Répertorier les sous-sites
• Recherche de style KQL avec l’API Microsoft Graph Search

Prise en charge des requêtes OData

• Utiliser $select pour choisir des propriétés
• Utilisez $filter pour filtrer les résultats
• Utilisez $expand pour inclure des tableaux associés
• Utilisez $orderby pour trier les résultats
• Utilisez $top pour la pagination
• Utilisez $skiptoken pour feuilleter de grands ensembles de résultats

Support des types de colonnes

• Colonnes de texte (ligne simple ou multiligne, texte simple ou enrichi)
• Colonnes numérotées (avec décimales, valeurs minimales et maximales)
• Colonnes de choix (cases à cocher, menu déroulant ou boutons radio)
• Colonnes booléennes
• DateTime Colonnes (date seulement ou date et heure)
• Colonnes de personne ou de groupe (une ou plusieurs sélections uniques)
• Colonnes de recherche (référence à d’autres listes)
• Liens hypertextes ou colonnes d’images

Notes

• Toutes les opérations utilisent Microsoft Graph API v1.0
• Les noms des colonnes doivent être de 1 à 64 caractères sans espaces
• Chaque colonne doit spécifier exactement un type de colonne
• Le contrôle de concurrence est disponible via l’en-tête If-Match
• Les recherches de site nécessitent consistencyLevel de définir la fonction eventual
• Les résultats de recherche sont limités à 50 éléments par page
• Des mises à jour partielles sont prises en charge pour les colonnes et les éléments de liste