Microsoft 365 OneDrive MCP-Serverreferenz

Übersicht

Verfügbare Tools

getOnedrive

Abrufen von Informationen zum OneDrive des Benutzers, einschließlich Laufwerkmetadaten, Kontingent und Besitzerinformationen.

Es müssen keine Parameter angegeben werden.

getFolderChildrenInMyOnedrive

Listet die obersten 20 Dateien und Ordner (DriveItems) auf, die in einem angegebenen übergeordneten Ordner im OneDrive des Benutzers enthalten sind.

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners, dessen Dateien und Ordner aufgelistet werden (Standard: 'root')

DateiOderOrdnerInMeinemDriveFinden

Sucht eine Datei oder einen Ordner (DriveItem) im OneDrive des Benutzers nach Suchabfrage. Effizienter als alle barrierefreien Dateien zu durchsuchen, wenn Sie wissen, dass sich das Element im OneDrive des Benutzers befindet.

Erforderliche Parameter:

• searchQuery: Suchabfrage; kann der gesamte oder teilweise Dateiname sein.

getFileOrFolderMetadataInMyOnedrive

Abrufen von Metadaten einer Datei oder eines Ordners (DriveItem) aus dem OneDrive des Benutzers.

Erforderliche Parameter:

• fileOrFolderId: ID der Datei oder des Ordners im OneDrive des Benutzers

getFileOrFolderMetadataByUrl

Abrufen von Metadaten einer Datei oder eines Ordners (DriveItem) aus einer Freigabe-URL. Nur Benutzer mit vorhandenen expliziten Berechtigungen für den Zugriff auf die Datei dürfen die Metadaten abrufen.

Erforderliche Parameter:

• fileOrFolderUrl: DIE URL der Datei oder des Ordners. Die URL wird nicht eingelöst, um sie für den Benutzer zu teilen. sie müssen bereits über expliziten Zugriff verfügen.

Kleine Textdatei aus meinem OneDrive lesen

Lesen (Herunterladen) einer Textdatei aus dem OneDrive des Benutzers. Sie müssen eine fileId (driveItemId) bereitstellen, um die Datei zu identifizieren und herunterzuladen.

Erforderliche Parameter:

• fileId: DriveItemId der Datei zum Lesen/Herunterladen

KleineTextdateiInMeinemOnedriveErstellen

Erstellen oder Hochladen einer Textdatei mit einer Größe von weniger als 5 MB auf das OneDrive des Benutzers.

Erforderliche Parameter:

• Dateiname: Name der zu erstellenden Datei
• contentText: Textinhalt der Datei

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners (Standard: 'root')

Ordner in meinem OneDrive erstellen

Erstellen Sie einen neuen Ordner (DriveItem) im OneDrive des Benutzers als untergeordnetes Element des angegebenen übergeordneten Ordners. Wenn bereits ein Ordner mit demselben Namen vorhanden ist, wird ein numerisches Suffix hinzugefügt (z. B. NewFolder (1)).

Erforderliche Parameter:

• Foldername: Name des zu erstellenden Ordners

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners (Standard: 'root')

BenennenSieDateiOderOrdnerInMeinemOneDriveUm

Benennen Sie eine Datei oder einen Ordner (DriveItem) im OneDrive des Benutzers um. Der neue Name muss den Benennungskonventionen entsprechen.

Erforderliche Parameter:

• fileOrFolderId: ID der umzubenennende Datei oder des Ordners
• newFileOrFolderName: Der neue Name für die Datei oder den Ordner
• Etag: ETag-Wert zur Steuerung von Parallelität. Der Vorgang ist nur erfolgreich, wenn das aktuelle ETag des DriveItem-Objekts übereinstimmt.

DateiOderOrdnerInMeinemOneDriveLöschen

Löschen Sie eine Datei oder einen Ordner (DriveItem) aus dem OneDrive des Benutzers.

Erforderliche Parameter:

• fileOrFolderId: ID der zu löschenden Datei oder des Zu löschenden Ordners
• ETag: ETag-Wert für Gleichzeitigkeitsteuerung

KleineDateiInMeinemOneDriveVerschieben

Verschieben sie eine Datei (DriveItem) im OneDrive des Benutzers in einen anderen Ordner. Unterstützt nur Dateien unter 5 MB.

Erforderliche Parameter:

• fileId: ID der zu verschiebenden Datei
• newParentFolderId: ID des Zielordners (muss sich im OneDrive des Benutzers befinden)
• Etag: ETag-Wert für paralleles Steuerelement

DateiOderOrdnerInMeinemOnedriveTeilen

Sendet eine Freigabeeinladung, um Lese-/Schreibberechtigungen für eine Datei oder einen Ordner (DriveItem) im OneDrive des Benutzers zu erteilen.

Erforderliche Parameter:

• fileOrFolderId: ID der zu teilenden Datei oder des Ordners
• recipientEmails: Array von E-Mail-Adressen von Empfängern, die eingeladen werden sollen
• Rollen: Array von Rollen, die zugewiesen werden sollen. Akzeptierte Werte: 'lesen', 'schreiben' (schreiben gewährt sowohl Lese- als auch Schreibzugriff)

Optionale Parameter:

• Nachricht: Benutzerdefinierte Nachricht, die in die Einladungs-E-Mail aufgenommen werden soll (Standard: "Hier ist die Datei, an der wir zusammenarbeiten".)
• sendInvitation: Gibt an, ob eine Freigabeaufladung gesendet werden soll (Standard: true)

EmpfindlichkeitsbezeichnungAufDateiInMeinemOneDriveFestlegen

Legen Sie die Vertraulichkeitsbezeichnung einer Datei im OneDrive des Benutzers fest.

Erforderliche Parameter:

• fileId: Die driveItemId der Datei
• sensitivityLabelId: ID der zuzuweisenden Vertraulichkeitsbezeichnung oder leere Zeichenfolge, um sie zu entfernen

Optionale Parameter:

• assignmentMethod: Zuordnungsmethode: 'standard', 'privileged', 'auto' oder 'unknownFutureValue' (Standard: 'privileged')
• justificationText: Begründungstext für Auditzwecke; erforderlich beim Herabstufen oder Entfernen einer Bezeichnung (Standard: 'Geändert von MCPServer')

Wichtigste Funktionen

verwaltung von OneDrive

• Abrufen von OneDrive-Informationen (Kontingent, Besitzer)
• Zugreifen auf das persönliche OneDrive des Benutzers
• Alle Vorgänge zielen auf das OneDrive eines authentifizierten Benutzers ab.

Dateisuche und -auffindung

• Durchsuchen von Dateien und Ordnern anhand des Namens im OneDrive des Benutzers
• Abrufen von Datei- oder Ordnermetadaten nach ID oder Freigabe-URL
• Durchsuchen von Ordnerinhalten (bis zu 20 Elemente)

Dateivorgänge

• Erstellen von Textdateien (≤5MB)
• Lesen von Textdateien
• Löschen von Dateien mit Nebenläufigkeitskontrolle
• Umbenennen von Dateien mit eTag-Schutz
• Verschieben von Dateien zwischen Ordnern

Ordnerverwaltung

• Ordner erstellen, einschließlich optionaler übergeordneter Pfade
• Automatisches numerisches Suffix für doppelte Ordnernamen
• Listenordnerinhalte (bis zu 20 Elemente)
• Abrufen von Ordnermetadaten
• Ordner mit Nebenläufigkeitskontrolle löschen
• Umbenennen von Ordnern mit eTag-Schutz

Freigabe und Berechtigungen

• Freigeben von Dateien und Ordnern für Benutzer
• Rollenbasierte Zugriffssteuerung (Lesen, Schreiben)
• E-Mail-Benachrichtigungen für das Teilen
• Benutzerdefinierte Nachrichten in Einladungen

Sicherheit und Konformität

• Anwenden und Entfernen von Sicherheitskennzeichnungen
• Mehrere Zuordnungsmethoden (Standard, Privilegierte, automatisch)
• Unterstützung bei der Audit-Begründung
• Nebenläufigkeitskontrolle mit eTags

Hinweise

• Alle Vorgänge zielen auf das persönliche OneDrive des authentifizierten Benutzers ab.
• Dateivorgänge sind auf ≤5MB für Upload und Download beschränkt.
• Löschen, Umbenennen und Verschieben erfordern eTags für parallele Steuerung
• Alle Vorgänge verwenden die Microsoft Graph-API
• Für die Freigabe sind gültige E-Mail-Adressen und entsprechende Berechtigungen erforderlich.
• Empfindlichkeitsbezeichnungen erfordern eine ordnungsgemäße Lizenzierung und Konfiguration
• Ordnerauflistung gibt standardmäßig maximal 20 Elemente zurück.
• eTag-Schutz verhindert Konflikte in gleichzeitigen Vorgängen