Référence du serveur MCP de Microsoft SharePoint et OneDrive

Vue d’ensemble

Outils disponibles

createFolder

Crée un dossier dans une bibliothèque de documents spécifiée en tant qu’enfant du dossier parent spécifié. Si vous ne spécifiez pas de bibliothèque de documents, le serveur utilise OneDrive de l’utilisateur. Si vous ne spécifiez pas de dossier parent, le serveur crée le dossier à la racine. Si un dossier existe déjà avec le même nom, le serveur crée le dossier avec un suffixe numérique, tel que NewFolder (1).

Paramètres obligatoires :

• folderName(chaîne) : nom du dossier à créer. Si un dossier existe déjà avec le même nom, le serveur crée le dossier avec un suffixe numérique, tel que NewFolder (1).
• documentLibraryId(chaîne) : identifiant de la bibliothèque de documents (également appelée lecteur) où vous souhaitez créer le dossier. Si vous souhaitez créer un dossier dans le lecteur de l’utilisateur ou son OneDrive, tel que « mon lecteur » ou « mon onedrive », envoyez "me" en tant que documentLibraryId.

Paramètres facultatifs :

• parentFolderId(chaîne, par défaut = « racine ») : ID du dossier parent sous lequel le nouveau dossier sera créé. La valeur par défaut est la racine de la bibliothèque de documents si elle n’est pas spécifiée.

findSite

Recherche des sites SharePoint auxquels l’utilisateur peut accéder. Cet outil peut trouver un site spécifique basé sur une requête de recherche que vous fournissez ou trouver les 20 principaux sites pertinents accessibles par l’utilisateur si vous ne fournissez pas de requête de recherche.

Paramètres obligatoires :

Aucun(e)

Paramètres facultatifs :

• searchQuery(chaîne, par défaut = nul) : requête de recherche qui peut être le nom complet ou partiel du site. Fournir une requête de recherche permet de rechercher efficacement un site, mais uniquement si l’utilisateur recherche un site spécifique. Par exemple, si l’utilisateur demande un site appelé xyz, vous passeriez xyz en tant que searchQuery. Si l’utilisateur demande simplement « mes sites », vous laissez ce paramètre vide.

listDocumentLibrariesInSite

Répertorie les bibliothèques de documents (également appelées lecteurs) dans le site SharePoint spécifié. Si vous ne spécifiez pas de site, le serveur utilise le site racine.

Paramètres obligatoires :

Aucun(e)

Paramètres facultatifs :

• siteId : ID de site (par défaut : racine)

findFileOrFolder

Recherche un fichier ou un dossier (également appelé DriveItem) auquel l’utilisateur peut accéder en passant une requête de recherche.

Paramètres obligatoires :

• searchQuery : requête de recherche qui peut être l’intégralité ou le nom de fichier partiel

renameFileOrFolder

Renommez un fichier ou un dossier (également appelé DriveItems) dans la bibliothèque de documents spécifiée. Remarque : Le nouveau nom doit respecter les conventions d’affectation de noms.

Paramètres obligatoires :

• documentLibraryId : identifiant de la bibliothèque de documents (chaîne)
• fileOrFolderId : identifiant de fichier ou de dossier (chaîne)
• newFileOrFolderName : Nouveau nom pour le fichier ou le dossier (chaîne)

deleteFileOrFolder

Supprimez un fichier ou un dossier de la bibliothèque de documents spécifiée.

Paramètres obligatoires :

• documentLibraryId : identifiant de la bibliothèque de documents (chaîne)
• fileOrFolderId : identifiant de fichier ou de dossier (chaîne)

readSmallTextFile

Lire (télécharger) un fichier texte à partir d’une bibliothèque de documents spécifique. Si vous ne spécifiez pas de bibliothèque de documents, le serveur utilise OneDrive de l’utilisateur. Vous devez fournir un fileId (driveItemId d’un fichier) pour identifier et télécharger le fichier.

Paramètres obligatoires :

• fileId(chaîne)
• documentLibraryId(chaîne) : identifiant de la bibliothèque de documents (également appelée lecteur) du fichier que vous souhaitez lire. Si l’utilisateur vous demande de lire ou de télécharger un fichier dans son lecteur ou son Onedrive par exemple - Lisez un fichier dans « mon lecteur », lisez un fichier dans « mon onedrive » que vous devez envoyer en tant que documentLibraryId.

moveSmallFile

Déplacez un fichier situé dans la bibliothèque de documents spécifiée vers un autre dossier. Cet outil prend uniquement en charge le déplacement pour les fichiers inférieurs à 5 Mo et les déplacements qui se trouvent dans le même site. Vous ne pouvez pas déplacer de fichiers entre lecteurs à l’aide de cette requête.

Paramètres obligatoires :

• documentLibraryId(chaîne) : identifiant de la bibliothèque de documents (également appelée lecteur) du fichier que vous souhaitez déplacer. Si l’utilisateur vous demande de déplacer un fichier dans son lecteur ou son Onedrive par exemple - Déplacez un fichier dans « mon lecteur », déplacez un fichier dans « mon onedrive » que vous devez envoyer en tant que documentLibraryId.
• fileId(chaîne) : identifiant du fichier à déplacer
• newParentFolderId(chaîne) : identifiant du dossier cible dans lequel déplacer le fichier. Doit se trouver dans la même bibliothèque de documents que l’emplacement d’origine du fichier.

getFileOrFolderMetadata

Obtenir les métadonnées d’un fichier ou d’un dossier à partir de la bibliothèque de documents spécifiée dans un site Sharepoint.

Paramètres obligatoires :

• FileOrFolderId(chaîne) : identifiant d’un fichier ou d’un dossier. Ils sont également appelés DriveItems. Et leur identifiant peut également être parfois appelé driveItemId.
• documentLibraryId(chaîne) : identifiant de la bibliothèque de documents (également appelée lecteur) du fichier ou du dossier dont vous avez besoin pour les métadonnées. Si l’utilisateur vous demande d’obtenir un fichier ou un dossier dans son lecteur ou son Onedrive, par exemple : « Obtenir les métadonnées d’un fichier dans mon lecteur » ou « Obtenir les métadonnées d’un dossier dans mon onedrive », vous devez envoyer « moi » comme documentLibraryId.

createSmallTextFile

Créez ou chargez un fichier texte inférieur à 5 Mo dans une bibliothèque de documents spécifique. Si vous ne spécifiez pas de bibliothèque de documents, le serveur utilise OneDrive de l’utilisateur. Vous pouvez charger le fichier dans un dossier spécifique. Si vous ne spécifiez pas de dossier, le fichier est chargé dans le dossier racine.

Paramètres obligatoires :

• filename (chaîne) : nom du fichier à créer
• contentText (chaîne) : contenu texte du fichier à créer
• documentLibraryId (chaîne) : identifiant de la bibliothèque de documents (également appelée lecteur) pour le fichier. Si un utilisateur vous demande de créer un fichier dans son lecteur ou son OneDrive, tel que « créer un fichier dans mon lecteur » ou « créer un fichier dans mon onedrive », envoyez « moi » comme documentLibraryId.

Paramètres facultatifs :

• parentfolderId(chaîne, par défaut = « racine ») : identifiant de dossier dans le lecteur pour ajouter le nouveau fichier.

getFileOrFolderMetadataByUrl

Obtenez les métadonnées d’un fichier ou d’un dossier à partir d’une URL de partage. Seuls les utilisateurs disposant d’autorisations explicites pour accéder au fichier peuvent obtenir les métadonnées.

Paramètres obligatoires :

• fileOrFolderUrl :(chaîne) : URL du fichier ou du dossier (également appelé DriveItems). L’URL n’est pas utilisée pour la partager avec l’utilisateur ; ils doivent déjà avoir un accès explicite au fichier.

shareFileOrFolder

Envoyez une invitation de partage pour accorder des autorisations sur un fichier ou un dossier au sein d’une bibliothèque de documents spécifiée. Prend en charge l’attribution de rôles et la notification des destinataires.

Paramètres obligatoires :

• documentLibraryId : identifiant de la bibliothèque de documents (chaîne, obligatoire)
• fileOrFolderId : identifiant de fichier ou de dossier (chaîne, obligatoire)
• recipientEmails :(string[], Obligatoire) : adresses e-mail des destinataires à inviter. Au moins un e-mail de destinataire est requis.

Paramètres facultatifs :

• roles(string[]) : rôles à affecter aux destinataires. Valeurs acceptées : lecture, écriture (l’écriture accorde à la fois l’accès en lecture et en écriture). La valeur par défaut est rôle de lecture si non spécifié.
• sendInvitation(bool, par défaut = true) : indique s’il faut envoyer une invitation de partage. La valeur par défaut est true si non spécifié.
• message(chaîne, valeur par défaut = « Voici le fichier sur lequel nous travaillons. »): message personnalisé à inclure dans le courrier électronique d’invitation. Est défini par défaut sur un message standard s’il n’est pas spécifié.

getFolderChildren

Énumère les 20 premiers fichiers et dossiers au sein d’un dossier parent spécifié dans une bibliothèque de documents. Si vous ne spécifiez pas de bibliothèque de documents, le serveur utilise OneDrive de l’utilisateur.

Paramètres obligatoires :

• documentLibraryId(chaîne) : identifiant de la bibliothèque de documents (également appelée lecteur) pour le dossier parent. Si un utilisateur vous demande d’obtenir des fichiers dans un dossier de son lecteur ou de son OneDrive, par exemple « obtenir des fichiers dans un dossier dans mon lecteur » ou « obtenir des fichiers dans un dossier dans mon onedrive », envoyez « moi » comme documentLibraryId.

Paramètres facultatifs :

• parentFolderId :(chaîne, par défaut = « racine ») : ID du dossier parent (DriveItem) dont les fichiers et dossiers sont répertoriés. La valeur par défaut est le dossier racine de la bibliothèque de documents si elle n’est pas spécifiée.

Écho

Renvoie le message au client.

Paramètres obligatoires :

• message : message à renvoyer

setSensitivityLabelOnFile

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

Paramètres obligatoires :

• documentLibraryId(chaîne) : identifiant de bibliothèque de documents, également appelé driveId, de la bibliothèque de documents
• fileId(chaîne) : ID de fichier, également appelé driveItemId, du fichier
• sensitivityLabelId(chaîne) : obligatoire. ID de l’étiquette de confidentialité à attribuer ou chaîne vide pour supprimer l’étiquette de confidentialité.

Paramètres facultatifs :

• assignmentMethod(chaîne, par défaut = « privilégié ») : méthode d’affectation de l’étiquette sur le document. Indique si l’affectation de l’étiquette a été effectuée automatiquement, standard ou en tant qu’opération privilégiée (l’équivalent d’une opération d’administrateur). Les valeurs possibles sont standard, privilégiées, automatiques et unknownFutureValue.
• justificationText(chaîne, par défaut = « Modifié par MCPServer ») – Facultatif. Texte de justification à des fins d’audit et est requis lors de la rétrogradation ou de la suppression d’une étiquette.

getDefaultDocumentLibraryInSite

Obtenez la bibliothèque de documents par défaut (également appelée Lecteur) dans un site SharePoint. Si vous ne spécifiez pas de site, le site racine est utilisé.

Paramètres obligatoires :

Aucun(e)

Paramètres facultatifs :

• siteId : ID de site (par défaut : racine)

Fonctionnalités clés

Gestion des commandes

• Créer des dossiers avec résolution automatique des conflits d’affectation de noms
• Énumérer les enfants du dossier (top 20)
• Déplacer des fichiers entre des dossiers (au sein du même site)

Opérations de fichier

• Créer et charger de petits fichiers texte (< 5 Mo)
• Lire et télécharger des fichiers texte
• Renommer les fichiers et dossiers
• Supprimer les fichiers et dossiers
• Obtenir des métadonnées de fichier et de dossier par ID ou URL

Découverte de sites et de bibliothèques

• Rechercher des sites SharePoint par requête de recherche
• Répertorier les bibliothèques de documents dans un site
• Obtenir la bibliothèque de documents par défaut

Partage et autorisations

• Partager des fichiers et des dossiers avec des attributions de rôle
• Envoyer des invitations de partage avec des messages personnalisés
• Contrôle d’accès via des autorisations explicites

Sécurité et conformité

• Définir des étiquettes de confidentialité sur des fichiers
• Prise en charge des méthodes d’affectation privilégiée, standard et automatique
• Texte de justification pour l’audit de conformité

Intégration

• Prise en charge SharePoint Online et OneDrive
• Connexion de serveur spécifique au client
• Abstraction DriveItem pour les fichiers et les dossiers

Notes

1. La bibliothèque de documents par défaut est « moi » (OneDrive de l’utilisateur)
2. Le dossier parent par défaut est « racine »
3. Conflits de noms de dossiers résolus avec des suffixes numériques
4. Les déplacements de fichiers sont limités à moins de 5 Mo et au sein du même site
5. Les URL de partage nécessitent des autorisations d’accès explicites
6. DriveItems représentent les fichiers et les dossiers
7. Limite maximale de 20 sur l’énumération enfants du dossier