Référence SharePoint Work IQ (aperçu)

Important

• Il s’agit d’une fonctionnalité en version préliminaire.
• Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Aperçu

ID du serveur	Nom d'affichage	Description
mcp_SharePointRemoteServer	Work IQ SharePoint	Serveur MCP pour les opérations de SharePoint. Utilisez ce serveur pour gérer les sites, listes, éléments de liste, colonnes, bibliothèques de documents, fichiers, dossiers et partage de fichiers. Les opérations de fichier sont limitées à ≤5 Mo.

Note

• Les connexions existantes qui utilisent les versions précédentes des serveurs Microsoft MCP, telles que le serveur MCP Microsoft Teams, restent prises en charge.
• Pour toutes les nouvelles connexions, utilisez les derniers serveurs MCP Work IQ, tels que Work IQ Teams.

Outils disponibles

findSite

Recherchez les sites SharePoint accessibles à l’utilisateur. Retourne des sites spécifiques correspondant à une requête de recherche ou les 20 principaux sites pertinents si aucune requête n’est fournie.

Paramètres facultatifs :

• searchQuery : Requête de recherche (nom de site entier ou partiel). Omettre de retourner les 20 principaux sites accessibles

getSiteByPath

Résolvez un site SharePoint à l’aide de son nom d’hôte exact et de son chemin d’accès relatif au serveur. Utilisez uniquement lorsque vous disposez de la structure complète de l’URL du site. Utilisez findSite quand seul un nom de site est connu.

Paramètres obligatoires :

• Hostname: Nom d’hôte exact (par exemple, « contoso.sharepoint.com »)
• serverRelativePath : Chemin d’accès relatif au serveur (par exemple, « sites/marketing »). La barre oblique de début est facultative.

listSubsites

Répertoriez tous les sous-sites (sites enfants) d’un site SharePoint.

Paramètres obligatoires :

• siteId : ID du site SharePoint parent (format : ' hostname,siteCollectionId,webId')

listerBibliothequesDeDocumentsDansSite

Veuillez répertorier les bibliothèques de documents (lecteurs) du site SharePoint spécifié.

Paramètres facultatifs :

• siteId : ID du site SharePoint (valeur par défaut : « racine »)

bibliothèqueDeDocumentsParDéfautDansLeSite

Obtenez la bibliothèque de documents par défaut dans un site SharePoint.

Paramètres facultatifs :

• siteId : ID du site SharePoint (valeur par défaut : « racine »)

getFolderChildren

Énumère les 20 premiers fichiers et dossiers (DriveItems) contenus dans un dossier parent spécifié dans une bibliothèque de documents (lecteur).

Paramètres obligatoires :

• documentLibraryId : ID de la bibliothèque de documents (lecteur)

Paramètres facultatifs :

• parentFolderId : ID du dossier parent (valeur par défaut : « racine »)

trouverFichierOuDossier

Recherche un fichier ou un dossier (DriveItem) accessible à l’utilisateur par requête de recherche. Les recherches sur tous les sites et bibliothèques de documents auxquels l’utilisateur a accès.

Paramètres obligatoires :

• searchQuery : Requête de recherche (nom de fichier entier ou partiel)

getFileOrFolderMetadata

Obtenir les métadonnées d’un fichier ou d’un dossier (DriveItem) à partir d’une bibliothèque de documents (lecteur) spécifiée dans SharePoint.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier (DriveItem)
• documentLibraryId : ID de la bibliothèque de documents (lecteur)

getFileOrFolderMetadataByUrl

Obtenir les métadonnées d’un fichier ou d’un dossier à partir d’une URL de partage. Seuls les utilisateurs disposant d’autorisations explicites existantes pour accéder au fichier seront autorisés.

Paramètres obligatoires :

• fileOrFolderUrl : URL du fichier ou du dossier. L’URL ne sera pas utilisée pour la partager avec l’utilisateur ; ils doivent déjà avoir un accès explicite

readSmallTextFile

Lire (télécharger) un fichier texte de taille inférieure à 5 Mo à partir d’une bibliothèque de documents spécifique (lecteur).

Paramètres obligatoires :

• fileId : ID du fichier (DriveItem) à lire/télécharger
• documentLibraryId : ID de la bibliothèque de documents (lecteur)

readSmallBinaryFile

Lit un fichier binaire de taille inférieure à 5 Mo à partir d’une bibliothèque de documents spécifique (lecteur). Le contenu du fichier est retourné sous forme de chaîne encodée en base64.

Paramètres obligatoires :

• fileId : ID du fichier (DriveItem) à lire/télécharger
• documentLibraryId : ID de la bibliothèque de documents (lecteur)

créerFichierTextePetit

Créez ou chargez un fichier texte de taille inférieure à 5 Mo dans une bibliothèque de documents spécifique (lecteur).

Paramètres obligatoires :

• Fichier: Nom du fichier, y compris l’extension
• contentText : Contenu texte du fichier
• documentLibraryId : ID de la bibliothèque de documents (lecteur)

Paramètres facultatifs :

• parentfolderId : ID du dossier parent (valeur par défaut : « racine »)

créerPetitFichierBinaire

Créez un fichier binaire de taille inférieure à 5 Mo en encodant son contenu en base64 dans une bibliothèque de documents spécifique (drive).

Paramètres obligatoires :

• Fichier: Nom du fichier, y compris l’extension
• base64Content : Contenu de fichier binaire encodé sous forme de chaîne base64
• documentLibraryId : ID de la bibliothèque de documents (lecteur)

Paramètres facultatifs :

• parentfolderId : ID du dossier parent (valeur par défaut : « racine »)

créerDossier

Créez un nouveau dossier (élément de disque) dans une bibliothèque de documents spécifiée (disque). Si un dossier portant le même nom existe, un suffixe numérique est ajouté (par exemple, NewFolder (1)).

Paramètres obligatoires :

• Foldername: Nom du dossier
• documentLibraryId : ID de la bibliothèque de documents (lecteur)

Paramètres facultatifs :

• parentFolderId : ID du dossier parent (valeur par défaut : « racine »)

renommerFichierOuDossier

Renommez un fichier ou un dossier (DriveItem) dans une bibliothèque de documents spécifiée (lecteur). Le nouveau nom doit se conformer aux conventions d’affectation de noms.

Paramètres obligatoires :

• documentLibraryId : ID de la bibliothèque de documents (lecteur)
• fileOrFolderId : ID du fichier ou du dossier à renommer
• newFileOrFolderName : Nouveau nom

Paramètres facultatifs :

• Etag: ETag pour le contrôle de concurrence

supprimerFichierOuDossier

Supprimez un fichier ou un dossier (DriveItem) d’une bibliothèque de documents (lecteur) spécifiée.

Paramètres obligatoires :

• documentLibraryId : ID de la bibliothèque de documents (lecteur)
• fileOrFolderId : ID du fichier ou du dossier à supprimer

Paramètres facultatifs :

• Etag: ETag pour le contrôle de concurrence

déplacerPetitFichier

Déplacez un fichier (DriveItem) vers un autre dossier dans la même bibliothèque de documents. Prend uniquement en charge les fichiers inférieurs à 5 Mo. Impossible de se déplacer entre les lecteurs.

Paramètres obligatoires :

• documentLibraryId : ID de la bibliothèque de documents (lecteur)
• fileId : ID du fichier à déplacer
• newParentFolderId : ID du dossier cible (doit se trouver dans la même bibliothèque de documents)

Paramètres facultatifs :

• Etag: ETag pour le contrôle de concurrence

copierFichierOuDossier

Copiez un fichier ou un dossier (DriveItem) dans un dossier de destination. Prend en charge la copie entre différentes bibliothèques de documents dans SharePoint. Cette opération est asynchrone ; utilisez checkOperationStatus pour surveiller la progression.

Paramètres obligatoires :

• sourcedoclibid : ID de la bibliothèque de documents source (disque)
• sourcefileid : ID du fichier ou dossier source à copier
• destdoclibid : ID de la bibliothèque de documents de destination (lecteur)
• destfolderid : ID du dossier de destination (doit exister)

Paramètres facultatifs :

• newfilename : Nouveau nom de l’élément copié

checkOperationStatus

Vérifiez l’état d’une opération asynchrone (par exemple, une copie) à l’aide du jeton d’opération retourné par l’opération d’origine.

Paramètres obligatoires :

• operationToken : Jeton d’opération retourné à partir d’une opération asynchrone comme copyFileOrFolder

téléchargerFichierDepuisURL

Chargez un fichier à partir d’une URL SharePoint ou OneDrive vers un dossier de destination dans une bibliothèque de documents (lecteur). Le fichier est copié à partir de l’URL source ; aucune modification n’est apportée à l’original.

Paramètres obligatoires :

• sourceUrl : URL source (doit être une URL SharePoint ou OneDrive valide)
• destinationDocumentLibraryId : ID de la bibliothèque de documents de destination. Utiliser « moi » pour OneDrive de l’utilisateur

Paramètres facultatifs :

• destinationFolderId : ID du dossier de destination (valeur par défaut : « racine »)
• Fichier: Nouveau nom de fichier ; valeur par défaut du nom de fichier d’origine

partagerFichierOuDossier

Envoie une invitation de partage pour accorder des autorisations de lecture/écriture sur un fichier ou un dossier (DriveItem) au sein d’une bibliothèque de documents (lecteur) spécifiée.

Paramètres obligatoires :

• documentLibraryId : ID de la bibliothèque de documents (lecteur)
• fileOrFolderId : ID du fichier ou du dossier à partager
• recipientEmails : Tableau d’adresses e-mail des destinataires
• Rôles : Liste de rôles : « lecture », « écriture » (le rôle d'écriture accorde à la fois lecture et écriture)

Paramètres facultatifs :

• Message: Message personnalisé pour l’e-mail d’invitation (par défaut : « Voici le fichier sur lequel nous travaillons. »)
• sendInvitation : Indique s’il faut envoyer une invitation de partage (valeur par défaut : true)

définirÉtiquetteDeConfidentialitéSurFichier

Définissez l'étiquette de sensibilité d'un fichier à partir de la bibliothèque de documents spécifiée.

Paramètres obligatoires :

• documentLibraryId : ID de la bibliothèque de documents (lecteur)
• fileId : DriveItemId du fichier
• sensitivityLabelId : ID de l’étiquette de confidentialité ou chaîne vide à supprimer

Paramètres facultatifs :

• assignmentMethod : Méthode d’affectation : 'standard', 'privileged', 'auto' ou 'unknownFutureValue' (valeur par défaut : 'privileged')
• justificationText : Texte de justification pour l’audit ; obligatoire lors de la rétrogradation ou de la suppression (valeur par défaut : « Modifié par MCPServer »)

listLists

Obtenez toutes les listes SharePoint disponibles sur un site spécifique. Permet de découvrir les listes qui existent dans un site.

Paramètres obligatoires :

• siteId : ID du site SharePoint (format : ' hostname,siteCollectionId,webId')

créerListe

Créez une liste SharePoint au sein d’un site.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• Displayname: Nom complet de la nouvelle liste

Paramètres facultatifs :

• Colonnes: Collection de colonnes en tant que paires clé-valeur : [{ Key: 'JobTitle', Value: 'text' }]. Types valides : texte, multiligneText, nombre, booléen, dateTime, choix, recherche, personOrGroup, lien hypertexte, devise, calculé
• Modèle: Type de modèle de liste (valeur par défaut : « genericList »). Options : ListeGénérique, BibliothèqueDeDocuments, Événements, Tâches, Annonces, Contacts, Liens, Enquête, SuiviDesProblèmes, ForumDeDiscussion

deleteList

Supprimez une liste SharePoint d’un site. Supprime l’intégralité du conteneur de liste et tous les éléments qu’il contient. Impossible d’annuler.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste à supprimer

Paramètres facultatifs :

• Etag: ETag pour le contrôle de concurrence

'envoyerInvitationPourListe'

Envoie une invitation de partage pour accorder des autorisations sur une liste SharePoint.

Paramètres obligatoires :

• listId : ID de la liste SharePoint à partager
• recipientEmails : Tableau d’adresses e-mail des destinataires
• Rôle: Rôle : « lecture » (affichage uniquement), « contribuer » (affichage, ajouter, mettre à jour, supprimer des éléments), « modifier » (modification complète, y compris la structure de liste)

Paramètres facultatifs :

• siteUrl : URL du site SharePoint contenant la liste
• sendEmail : Indique s’il faut envoyer une notification par e-mail (valeur par défaut : true)

listerÉlémentsListe

Obtenir des éléments (lignes/enregistrements) à partir d’une liste SharePoint spécifique.

Paramètres obligatoires :

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

getListItem

Obtenez un seul élément (ligne/enregistrement) à partir d’une liste SharePoint par son ID.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Itemid: ID de l’élément de liste spécifique

createListItem

Créez un élément (ligne/enregistrement) dans une liste SharePoint.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Champs : Paires clé-valeur pour les données des champs : [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Le champ « Titre » est généralement requis

updateListItem

Mettez à jour un élément existant (ligne/enregistrement) dans une liste SharePoint. Seuls les champs spécifiés sont mis à jour ; Les champs omis conservent leurs valeurs.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Itemid: ID de l’élément à mettre à jour
• Champs: Paires clé-valeur de champs à mettre à jour

Paramètres facultatifs :

• Etag: ETag pour le contrôle de concurrence

deleteListItem

Supprimez un élément (ligne/enregistrement) d’une liste SharePoint.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Itemid: ID de l’élément à supprimer

Paramètres facultatifs :

• Etag: ETag pour le contrôle de concurrence

listColumns

Obtenir toutes les colonnes d’une liste SharePoint.

Paramètres obligatoires :

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

createColumn

Créez une colonne dans une liste SharePoint. Prend en charge de nombreux types de colonnes, notamment le texte, le nombre, le choix, la dateTime, la valeur booléenne, l’utilisateur, la recherche, le calcul, etc.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Nom: Nom de colonne interne (identificateur programmatique)
• columnType : Type de colonne : texte, remarque, nombre, entier, booléen, dateTime, choix, multichoice, devise, recherche, utilisateur, URL, calculé, terme, multiterm, emplacement, géolocalisation, miniature, compteur, calculé, contentTypeId, fichier, pièce jointe, guid, outcomeChoice, approvalStatus

Paramètres facultatifs :

• columnProperties : Paramètres spécifiques au type (par exemple, { "maxLength": 255 } pour le texte, { "choices": ["A","B","C"] } pour le choix)
• Description: Description de la colonne
• Displayname: Nom complet affiché dans l’interface utilisateur (valeur par défaut « name »)
• Obligatoire: Définir la colonne requise (valeur par défaut : false)
• Cachés: Masquer la colonne des vues (valeur par défaut : false)

updateColumn

Mettez à jour une colonne existante dans une liste SharePoint.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Columnid: ID de la colonne à mettre à jour

Paramètres facultatifs :

• columnType : Type de colonne (obligatoire lors de la fourniture de « columnProperties »)
• columnProperties : Propriétés spécifiques au type à mettre à jour
• Description: Nouvelle description
• displayName: Nouveau nom d'affichage
• Caché: Masquer ou afficher les colonnes
• Obligatoire: Rendre la colonne obligatoire ou facultative

supprimerColonne

Supprimez une colonne d’une liste SharePoint. Avertissement: Supprime toutes les données stockées dans cette colonne pour tous les éléments.

Paramètres obligatoires :

• siteId : ID du site SharePoint
• listId : ID de la liste SharePoint
• Columnid: ID de la colonne à supprimer

Fonctionnalités clés

Gestion des sites

• Rechercher des sites par nom ou parcourir des sites accessibles
• Obtenir le site par chemin d’URL exact
• Répertorier les sites enfants et les sous-sites
• Navigation complète de la hiérarchie de site

Gestion des bibliothèques de documents

• Répertorier toutes les bibliothèques de documents dans un site
• Obtenir la bibliothèque de documents par défaut
• Parcourir le contenu du dossier (jusqu’à 20 éléments)
• Créer et gérer des structures de dossiers

Opérations de fichier

• Créer des fichiers texte et binaires (≤5 Mo)
• Lire des fichiers texte et binaires (≤5 Mo)
• Supprimer, renommer et déplacer des fichiers
• Copier des fichiers et des dossiers dans des bibliothèques de documents
• Charger des fichiers à partir d’URL SharePoint ou OneDrive
• Rechercher des fichiers et des dossiers sur tous les sites accessibles
• Obtenir les métadonnées de fichier et de dossier

Opérations asynchrones

• Copier des fichiers et des dossiers de manière asynchrone dans les bibliothèques de documents
• Vérifier l’état des opérations asynchrones à l’aide de jetons d’opération

Répertorier les opérations

• Créer, lire et supprimer des listes
• Prise en charge de plusieurs modèles de liste (générique, bibliothèque de documents, événements, tâches)
• Partager des listes avec des autorisations basées sur des rôles
• Gérer les éléments de liste (créer, lire, mettre à jour, supprimer)

Gestion des colonnes

• Créer des colonnes avec un large éventail de types (texte, remarque, nombre, booléen, dateTime, choix, recherche, utilisateur, URL, calculé, etc.)
• Mettre à jour les propriétés et les métadonnées de colonne
• Configurer les exigences et la visibilité des colonnes
• Propriétés de colonne spécifiques au type

Partage et autorisations

• Partager des fichiers, des dossiers et des listes avec des utilisateurs
• Contrôle d’accès en fonction du rôle (lecture, écriture, contribution, modification)
• Notifications par e-mail pour le partage
• Messages personnalisés dans les invitations

Sécurité et conformité

• Appliquer et supprimer des étiquettes de confidentialité
• Méthodes d’affectation multiples (standard, privilégié, automatique)
• Prise en charge de la justification de l’audit
• Contrôle de la concurrence avec eTags

Remarques

• Les opérations de fichier sont limitées à ≤5 Mo pour le chargement et le téléchargement
• Les opérations de déplacement fonctionnent uniquement dans la même bibliothèque de documents
• Les opérations de copie sont asynchrones ; utiliser checkOperationStatus pour surveiller la progression
• Les opérations de copie prennent en charge la copie inter-bibliothèques dans SharePoint
• uploadFileFromUrl nécessite une URL source SharePoint ou OneDrive valide
• Les eTags fournissent un contrôle de concurrence pour les mises à jour et les suppressions
• Suffixe numérique automatique pour les noms de dossiers en double
• La suppression de liste ne peut pas être annulée
• La suppression de colonne supprime toutes les données stockées dans cette colonne
• Les opérations de recherche retournent les 20 premiers résultats par défaut
• Toutes les opérations utilisent l’API Microsoft Graph

Note

Les noms et paramètres des outils MCP sont susceptibles de changer, et les dépendances codées en dur doivent être évitées. La prise en charge des scénarios sera maintenue.