Référence du serveur MCP pour SharePoint Lists Tools

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	Serveur MCP Microsoft SharePoint Lists	Serveur MCP fournissant des outils SharePoint Microsoft Graph pour les listes. 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
• list : informations sur la liste, telles que le modèle (par exemple, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Créer une colonne (columnDefinition) dans une liste SharePoint spécifique. Vous devez fournir le siteId et le listId cibles, ainsi qu’une définition de colonne valide qui précise le nom de la colonne, son nom d’affichage et un seul type de colonne (par exemple : text, number, choice, dateTime, personOrGroup, lookup, boolean 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

Supprimer une columnDefinition existante 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 : ETag facultatif pour le contrôle de concurrence (par exemple, « * »)

sharepoint_editListColumn

Mettre à jour une columnDefinition existante 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 les paramètres displayName, description, hidden, required ou facet).

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

Répertorier les définitions de colonnes (ressources columnDefinition) 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

Rechercher dans SharePoint à l’aide de 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
• query : objet de requête avec une chaîne de recherche de style 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

13. 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 : ETag facultatif pour le contrôle de concurrence (par exemple, « * » pour forcer)

Principales fonctionnalités

Gestion des listes

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

Opérations sur les colonnes

• Créer des colonnes avec plusieurs types de données (text, number, choice, dateTime, personOrGroup, lookup, boolean, 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 d'élément

• 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 concurrence via ETag

Découverte de sites

• 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.
• Utiliser $filter pour filtrer les résultats.
• Utiliser $expand pour inclure des entités associées.
• Utiliser $orderby pour trier les résultats.
• Utiliser $top pour la pagination.
• Utiliser $skiptoken pour parcourir de grands jeux de résultats.

Prise en charge des types de colonne

• Colonnes de type texte (ligne unique ou multilignes, texte brut ou enrichi).
• Colonnes de type nombre (avec décimales, valeurs minimale et maximale).
• Colonnes de type choix (cases à cocher, liste déroulante ou boutons radio).
• Colonnes booléennes.
• Colonnes de type DateTime (date seule ou date et heure).
• Colonnes Personne ou Groupe (sélection unique ou multiple).
• Colonnes de type recherche (référencent d’autres listes).
• Colonnes Lien hypertexte ou Image.

Notes

1. Toutes les opérations utilisent l’API Microsoft Graph v1.0.
2. Les noms de colonnes doivent comporter entre 1 et 64 caractères sans espaces.
3. Chaque colonne doit spécifier exactement un type de colonne.
4. Le contrôle de concurrence est disponible via l’en-tête If-Match.
5. Les recherches de site requièrent que le paramètre consistencyLevel soit défini sur eventual.
6. Les résultats de recherche sont limités à 50 éléments par page.
7. Les mises à jour partielles sont prises en charge pour les colonnes et les éléments de liste.