Informations de référence sur microsoft SharePoint et OneDrive MCP Server

Vue d’ensemble

Outils disponibles

créerDossier

Crée un nouveau dossier au sein d’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 le 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(string) – ID de la bibliothèque de documents (également appelée un disque) 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" comme documentLibraryId.

Paramètres facultatifs :

• parentFolderId(string, default = « root ») – ID du dossier parent sous lequel le nouveau dossier est créé. La valeur par défaut est la racine de la bibliothèque de documents si cela n’est pas spécifié.

findSite

Recherche SharePoint sites 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.

listerBibliothequesDeDocumentsDansSite

Répertorie les bibliothèques de documents (ou disques) du 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)

trouverFichierOuDossier

Recherche un fichier ou un dossier (également appelé DriveItem) que l’utilisateur peut access 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

renommerFichierOuDossier

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

Paramètres obligatoires :

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

supprimerFichierOuDossier

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

Paramètres obligatoires :

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

readSmallTextFile

Lisez (téléchargez) un fichier texte à partir d’une bibliothèque de documents spécifique. Si vous ne spécifiez pas de bibliothèque de documents, le OneDrive de l'utilisateur est utilisé. Vous devez fournir un fichier (fileIdd’un fichierdriveItemId) pour identifier et télécharger le fichier.

Paramètres obligatoires :

• fileId(chaîne)
• documentLibraryId(string) – ID de la bibliothèque de documents (également appelée disque) du fichier que vous souhaitez lire. L’utilisateur demande à lire ou télécharger un fichier dans son disque ou son OneDrive, par exemple « Lire un fichier dans mon disque » ou « Lire un fichier dans mon OneDrive », vous envoyez « moi » comme documentLibraryId.

déplacerPetitFichier

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 des fichiers entre les disques en utilisant cette requête.

Paramètres obligatoires :

• documentLibraryId(string) – ID de la bibliothèque de documents (également appelée disque) du fichier que vous souhaitez déplacer. Utilisez ce paramètre lorsqu’un utilisateur vous demande de déplacer un fichier dans son lecteur ou son OneDrive. Par exemple, « Déplacer un fichier dans mon lecteur » ou « Déplacer un fichier dans mon OneDrive », vous envoyez « moi » comme documentLibraryId.
• fileId(string) – ID 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

Obtenez les métadonnées d’un fichier ou d’un dossier dans la bibliothèque de documents spécifiée dans un site SharePoint.

Paramètres obligatoires :

• FileOrFolderId(string) – ID d’un fichier ou d’un dossier. On les appelle aussi DriveItems. Leur identifiant peut aussi parfois être appelé un driveItemId.
• documentLibraryId(string) – ID de la bibliothèque de documents (également appelée disque) du fichier ou dossier dont vous avez besoin des métadonnées. Utilisez ce paramètre lorsqu’un 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 envoyez « moi » comme documentLibraryId.

créerFichierTextePetit

Créez ou téléchargez un fichier texte de moins de 5 Mo dans une bibliothèque de documents spécifique. Si vous ne spécifiez pas de bibliothèque de documents, le OneDrive de l'utilisateur est utilisé. 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 :

• Nom du fichier (chaîne) – Nom du fichier à créer.
• contentText (chaîne) – Contenu textuel du fichier à créer.
• documentLibraryId (chaîne) – ID de la bibliothèque de documents (également appelée disque) du fichier. Si un utilisateur vous demande de créer un fichier dans son lecteur ou son OneDrive, par exemple « 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 access le fichier peuvent obtenir les métadonnées.

Paramètres obligatoires :

• fileOrFolderUrl :(string) – URL du fichier ou du dossier (également appelé DriveItems). Le paramètre d'URL n'accorde pas l'autorisation de partager l'objet avec l'utilisateur ; l’utilisateur doit déjà avoir des access explicites au fichier.

partagerFichierOuDossier

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 : ID de bibliothèque de documents (chaîne, requis)
• fileOrFolderId : ID de fichier ou de dossier (chaîne, requis)
• 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 des accès de lecture et d’écriture). La valeur par défaut est le rôle lecture si rien n'est 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ée.
• message(chaîne, valeur par défaut = « Voici le fichier sur lequel nous travaillons. »): message personnalisé à inclure dans le courrier électronique d’invitation. Par défaut, un message standard est utilisé 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 OneDrive de l'utilisateur est utilisé.

Paramètres obligatoires :

• documentLibraryId(string) – ID de la bibliothèque de documents (également appelée disque) pour le dossier parent. Si un utilisateur vous demande d’obtenir des fichiers dans un dossier dans son lecteur ou leur 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 :(string, default = « root ») – ID du dossier parent (DriveItem) dont les fichiers et dossiers sont listés. Par défaut, il revient au dossier racine de la bibliothèque de documents si ce n’est pas spécifié.

Écho

Renvoie le message au client.

Paramètres obligatoires :

• message : message à renvoyer

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(string) – L’identifiant de la bibliothèque de documents, également appelé driveId, de la bibliothèque de documents.
• fileId(chaîne) – L’identifiant du 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, privileged, auto 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.

bibliothèqueDeDocumentsParDéfautDansLeSite

Accédez à la bibliothèque de documents par défaut (également appelée espace de stockage) 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 dossiers

• 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 téléverser de petits fichiers texte (moins de 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 par 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

• support OneDrive et SharePoint Online
• Connexion de serveur spécifique au tenant
• DriveItem Abstraction pour les fichiers et dossiers

Notes

• La bibliothèque de documents par défaut est « moi » (OneDrive de l'utilisateur)
• Le dossier parent par défaut est « racine »
• Conflits de noms de dossiers résolus avec des suffixes numériques
• Les déplacements de fichiers sont limités à moins de 5 Mo et au sein du même site
• Les URL de partage nécessitent des autorisations de access explicites
• DriveItems représenter à la fois les fichiers et les dossiers
• Limite maximale de 20 pour l'énumération des éléments du dossier