Référence OneDrive Work IQ (préversion)

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_OneDriveRemoteServer	Work IQ OneDrive	Serveur MCP pour les opérations de OneDrive. Utilisez ce serveur pour gérer les fichiers et les dossiers dans les OneDrive personnels de l'utilisateur. Toutes les opérations de fichier 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

getOnedrive

Obtenez des informations sur OneDrive de l’utilisateur, notamment les métadonnées de lecteur, le quota et les informations de propriétaire.

Aucun paramètre requis.

getFolderChildrenInMyOnedrive

Énumère les 20 premiers fichiers et dossiers (DriveItems) contenus dans un dossier parent spécifié dans OneDrive de l’utilisateur.

Paramètres facultatifs :

• parentFolderId : ID du dossier parent dont les fichiers et dossiers sont répertoriés (valeur par défaut : « racine »)

rechercherFichierOuDossierDansMonDrive

Recherche un fichier ou un dossier (DriveItem) dans la requête OneDrive de l’utilisateur. Plus efficace que de rechercher tous les fichiers accessibles si vous savez que l’élément se trouve dans OneDrive de l’utilisateur.

Paramètres obligatoires :

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

obtenirLesMétadonnéesDuFichierOuDossierDansMonOnedrive

Obtenir les métadonnées d’un fichier ou d’un dossier (DriveItem) à partir de OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier dans OneDrive de l’utilisateur

getFileOrFolderMetadataByUrl

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

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

readSmallTextFileFromMyOnedrive

Lisez (téléchargez) un fichier texte à partir de OneDrive de l’utilisateur. Vous devez fournir un fileId (driveItemId) pour identifier et télécharger le fichier.

Paramètres obligatoires :

• fileId : DriveItemId du fichier à lire/télécharger

créerPetitFichierTexteDansMonOnedrive

Créez ou chargez un fichier texte de taille inférieure à 5 Mo sur OneDrive de l’utilisateur.

Paramètres obligatoires :

• Fichier: Nom du fichier à créer
• contentText : Contenu texte du fichier

Paramètres facultatifs :

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

créerUnDossierDansMonOnedrive

Créez un dossier (DriveItem) dans OneDrive de l’utilisateur en tant qu’enfant du dossier parent spécifié. Si un dossier portant le même nom existe déjà, un suffixe numérique est ajouté (par exemple, NewFolder (1)).

Paramètres obligatoires :

• Foldername: Nom du dossier à créer

Paramètres facultatifs :

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

renommerFichierOuDossierDansMonOnedrive

Renommez un fichier ou un dossier (DriveItem) dans OneDrive de l’utilisateur. Le nouveau nom doit se conformer aux conventions d’affectation de noms.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier à renommer
• newFileOrFolderName : Nouveau nom du fichier ou du dossier
• ETag: Valeur ETag pour le contrôle de la concurrence. L’opération réussit uniquement si l’ETag actuel de DriveItem correspond à

supprimerFichierOuDossierDansMonOnedrive

Supprimez un fichier ou un dossier (DriveItem) de OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier à supprimer
• Etag: Valeur ETag pour le contrôle de la concurrence

déplacerPetitFichierDansMonOneDrive

Déplacez un fichier (DriveItem) dans OneDrive de l’utilisateur vers un autre dossier. Prend uniquement en charge les fichiers inférieurs à 5 Mo.

Paramètres obligatoires :

• fileId : ID du fichier à déplacer
• newParentFolderId : ID du dossier cible (doit se trouver dans OneDrive de l’utilisateur)
• Etag: Valeur ETag pour le contrôle de la concurrence

partagerFichierOuDossierDansMonOnedrive

Envoie une invitation de partage pour accorder des autorisations de lecture/écriture sur un fichier ou un dossier (DriveItem) dans OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileOrFolderId : ID du fichier ou du dossier à partager
• recipientEmails : Tableau d’adresses e-mail des destinataires à inviter
• Rôles: Tableau de rôles à attribuer. Valeurs acceptées : 'read', 'write' (le paramètre 'write' accorde à la fois les droits de lecture et d'écriture)

Paramètres facultatifs :

• Message: Message personnalisé à inclure dans 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éfinirLibelléDeConfidentialitéSurFichierDansMonOneDrive

Définissez l’étiquette de confidentialité d’un fichier dans OneDrive de l’utilisateur.

Paramètres obligatoires :

• fileId : DriveItemId du fichier
• sensitivityLabelId: ID de l’étiquette de sensibilité à affecter, ou chaîne vide pour la supprimer

Paramètres facultatifs :

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

Fonctionnalités clés

gestion des OneDrive

• Obtenir des informations sur OneDrive (quota, propriétaire)
• Accéder à OneDrive personnel de l’utilisateur
• Toutes les opérations ciblent oneDrive de l’utilisateur authentifié

Recherche et découverte de fichiers

• Rechercher des fichiers et des dossiers par nom dans OneDrive de l’utilisateur
• Obtenir des métadonnées de fichier ou de dossier par ID ou URL de partage
• Parcourir le contenu du dossier (jusqu’à 20 éléments)

Opérations de fichier

• Créer des fichiers texte (≤5 Mo)
• Lire des fichiers texte
• Supprimer des fichiers avec contrôle de concurrence
• Renommer des fichiers avec la protection eTag
• Déplacer des fichiers entre des dossiers

Gestion des dossiers

• Créer des dossiers avec des chemins parent facultatifs
• Suffixe numérique automatique pour les noms de dossiers en double
• Répertorier le contenu du dossier (jusqu’à 20 éléments)
• Obtenir les métadonnées de dossier
• Supprimer des dossiers avec contrôle de concurrence
• Renommer des dossiers avec la protection eTag

Partage et autorisations

• Partager des fichiers et des dossiers avec des utilisateurs
• Contrôle d’accès en fonction du rôle (lecture, écriture)
• 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

• Toutes les opérations ciblent le OneDrive personnel de l’utilisateur authentifié
• Les opérations de fichier sont limitées à ≤5 Mo pour le chargement et le téléchargement
• Les opérations de suppression, de renommage et de déplacement nécessitent des eTags pour le contrôle d’accès concurrentiel
• Toutes les opérations utilisent l’API Microsoft Graph
• Le partage nécessite des adresses e-mail valides et des autorisations appropriées
• Les étiquettes de confidentialité nécessitent une licence et une configuration appropriées
• La liste des dossiers retourne au maximum 20 éléments par défaut
• La protection eTag empêche les conflits dans les opérations simultanées

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.