Microsoft SharePoint- und OneDrive MCP-Serverreferenz

Übersicht

Verfügbare Tools

OrdnerErstellen

Erstellt einen neuen Ordner innerhalb einer angegebenen Dokumentbibliothek als Kind des angegebenen übergeordneten Ordners. Wenn Sie keine Dokumentbibliothek angeben, verwendet der Server die OneDrive des Benutzers. Wenn Sie keinen übergeordneten Ordner angeben, erstellt der Server den Ordner im Stammverzeichnis. Wenn bereits ein Ordner mit demselben Namen vorhanden ist, erstellt der Server den neuen Ordner mit einem numerischen Suffix, z. B. NewFolder (1).

Erforderliche Parameter:

• folderName(Zeichenfolge) – Name des zu erstellenden Ordners. Wenn bereits ein Ordner mit demselben Namen vorhanden ist, fügt der Server dem Namen des neuen Ordners einen numerischen Suffix hinzu, z. B. NewFolder (1).
• documentLibraryId(string) – ID der Dokumentbibliothek (auch Laufwerk genannt), auf der Sie den Ordner erstellen möchten. Wenn Sie einen Ordner auf dem Laufwerk des Benutzers oder dessen OneDrive erstellen möchten, z. B. "Mein Laufwerk" oder "mein OneDrive", senden Sie "me" als documentLibraryId.

Optionale Parameter:

• parentFolderId(string, default = "root") – ID des übergeordneten Ordners, unter dem der neue Ordner erstellt wird. Wenn nicht anders angegeben, wird standardmäßig auf das Stammverzeichnis der Dokumentbibliothek zugegriffen.

findSite

Sucht SharePoint Websites, auf die der Benutzer zugreifen kann. Dieses Tool kann entweder eine bestimmte Website basierend auf einer von Ihnen bereitgestellten Suchabfrage oder die wichtigsten 20 relevanten Websites finden, auf die der Benutzer zugreifen kann, wenn Sie keine Suchabfrage bereitstellen.

Erforderliche Parameter:

Keine

Optionale Parameter:

• searchQuery(Zeichenfolge, Standardwert = null) – Suchabfrage, die der gesamte oder teilweise Websitename sein kann. Die Bereitstellung einer Suchabfrage hilft dabei, effizient nach einer Website zu suchen, allerdings nur dann, wenn der Benutzer nach einer bestimmten Website sucht. Wenn der Benutzer z. B. nach einer Website namens xyz fragt, würden Sie xyz als searchQuery übergeben. Wenn der Benutzer einfach nach „Meine Websites“ fragt, lassen Sie diesen Parameter leer.

listDocumentLibrariesInSite

Listet Dokumentbibliotheken (auch als Laufwerke bezeichnet) auf der angegebenen SharePoint Website auf. Wenn Sie keine Website angeben, verwendet der Server die Stammwebsite.

Erforderliche Parameter:

Keine

Optionale Parameter:

• siteId: Website-ID (Standard: root)

findFileOrFolder

Sucht eine Datei oder einen Ordner (auch als DriveItem bezeichnet), auf die der Benutzer zugreifen kann, indem er eine Suchabfrage übergibt.

Erforderliche Parameter:

• searchQuery: Suchabfrage, die der gesamte oder teilweise Dateiname sein kann

umbenennenDateiOderOrdner

Umbennen Sie eine Datei oder einen Ordner (auch genannt DriveItems) innerhalb der angegebenen Dokumentbibliothek. Hinweis: Der neue Name muss den Benennungskonventionen entsprechen.

Erforderliche Parameter:

• documentLibraryId: Dokumentbibliotheks-ID (String)
• fileOrFolderId: Datei- oder Ordner-ID (String)
• newFileOrFolderName: Neuer Name für die Datei oder den Ordner (Zeichenfolge)

deleteFileOrFolder

Löschen Sie eine Datei oder einen Ordner aus der angegebenen Dokumentbibliothek.

Erforderliche Parameter:

• documentLibraryId: Dokumentbibliotheks-ID (String)
• fileOrFolderId: Datei- oder Ordner-ID (String)

readSmallTextFile

Lesen (herunterladen) Sie eine Textdatei aus einer bestimmten Dokumentbibliothek. Wenn Sie keine Dokumentbibliothek angeben, wird die OneDrive des Benutzers verwendet. Du musst eine fileId (driveItemId eines Datei) angeben, um die Datei zu identifizieren und herunterzuladen.

Erforderliche Parameter:

• fileId(Zeichenfolge)
• documentLibraryId(string) – ID der Dokumentbibliothek (auch als Laufwerk bekannt) der Datei, die Sie lesen möchten. Der Benutzer bittet, eine Datei auf ihrem Laufwerk oder ihrem OneDrive zu lesen oder herunterzuladen, z. B. "Eine Datei auf meinem Laufwerk lesen" oder "Eine Datei in meinem OneDrive lesen", die als 'me' im documentLibraryId angegeben wird.

moveSmallFile

Verschieben Sie eine Datei in der angegebenen Dokumentbibliothek in einen anderen Ordner. Dieses Tool unterstützt nur die Verschiebung für Dateien unter 5 MB sowie Verschiebungen innerhalb derselben Website. Mit dieser Anfrage kannst du keine Dateien zwischen Laufwerken verschieben.

Erforderliche Parameter:

• documentLibraryId(string) – ID der Dokumentbibliothek (auch als Laufwerk bekannt) der Datei, die du verschieben möchtest. Verwenden Sie diesen Parameter, wenn ein Benutzer Sie auffordern, eine Datei auf dem Laufwerk oder deren OneDrive zu verschieben. Beispielsweise "Verschieben einer Datei auf meinem Laufwerk" oder "Verschieben einer Datei in meinem OneDrive", die Sie in "ich" als documentLibraryId senden.
• fileId(string) – ID der zu verschiebenden Datei.
• newParentFolderId(Zeichenfolge) – Die ID des Zielordners, in den die Datei verschoben werden soll. Sollte sich in derselben Dokumentbibliothek wie der ursprüngliche Speicherort der Datei befinden.

getFileOrFolderMetadata

Holen Sie Metadaten einer Datei oder eines Ordners aus der angegebenen Dokumentbibliothek auf einer SharePoint-Seite.

Erforderliche Parameter:

• FileOrFolderId(string) – ID einer Datei oder eines Ordners. Sie werden auch genannt DriveItems. Ihre ID kann manchmal auch als driveItemId bezeichnet werden.
• documentLibraryId(string) – ID der Dokumentbibliothek (auch als Laufwerk bekannt) der Datei oder des Ordners, deren Metadaten Sie benötigen. Verwenden Sie diesen Parameter, wenn ein Benutzer Sie auffordern, eine Datei oder einen Ordner auf dem Laufwerk oder deren OneDrive abzurufen. Beispielsweise "Metadaten einer Datei auf meinem Laufwerk abrufen" oder "Metadaten eines Ordners in meinem OneDrive abrufen", die Sie in "ich" als documentLibraryId senden.

createSmallTextFile

Erstellen oder laden Sie eine Textdatei kleiner als 5 MB in eine bestimmte Dokumentbibliothek hoch. Wenn Sie keine Dokumentbibliothek angeben, wird die OneDrive des Benutzers verwendet. Sie können die Datei in einen bestimmten Ordner hochladen. Wenn Sie keinen Ordner angeben, wird die Datei in den Stammordner hochgeladen.

Erforderliche Parameter:

• Dateiname (Zeichenkette) – Name der zu erstellenden Datei.
• contentText (Zeichenkette) – Textinhalt der zu erstellenden Datei.
• documentLibraryId (Zeichenkette) – ID der Dokumentbibliothek (auch Laufwerk genannt) für die Datei. Wenn ein Benutzer Sie auffordern, eine Datei auf dem Laufwerk oder deren OneDrive zu erstellen, z. B. "Eine Datei auf meinem Laufwerk erstellen" oder "eine Datei in meinem OneDrive erstellen", senden Sie "ich" als documentLibraryId.

Optionale Parameter:

• parentfolderId(Zeichenfolge, Standardwert = root) – Ordner-ID innerhalb des Laufwerks, um die neue Datei hinzuzufügen.

getFileOrFolderMetadataByUrl

Abrufen von Metadaten für eine Datei oder einen Ordner aus einer Freigabe-URL. Nur Benutzer mit expliziten Berechtigungen zum access der Datei können die Metadaten abrufen.

Erforderliche Parameter:

• fileOrFolderUrl:(string) – URL der Datei oder des Ordners (auch als DriveItems). Der URL-Parameter erteilt dem Benutzer keine Berechtigung, das Objekt zu teilen; der Benutzer muss bereits über expliziten Zugriff auf die Datei verfügen.

shareFileOrFolder

Senden Sie eine Einladung zum Teilen, um Berechtigungen für eine Datei oder einen Ordner innerhalb einer bestimmten Dokumentbibliothek zu erteilen. Unterstützt das Zuweisen von Rollen und das Benachrichtigen von Empfängern.

Erforderliche Parameter:

• documentLibraryId: Dokumentbibliotheks-ID (String, erforderlich)
• fileOrFolderId: Datei- oder Ordner-ID (String, erforderlich)
• recipientEmails:(Zeichenfolge[], erforderlich) – E-Mail-Adressen von Empfängern, die eingeladen werden sollen. Mindestens eine Empfänger-E-Mail ist erforderlich.

Optionale Parameter:

• roles(Zeichenfolge[]) – Rollen, die Empfängern zugewiesen werden sollen. Akzeptierte Werte: lesen, schreiben (schreiben gewährt sowohl Lese- als auch Schreibzugriff). Standardmäßig wird die Rolle "Lesen" verwendet, wenn nichts angegeben ist.
• sendInvitation(boolescher Wert, Standardwert = true) – Gibt an, ob eine Freigabeeinladung gesendet werden soll. Standardmäßig wird „true“ verwendet, wenn nichts angegeben ist.
• message(Zeichenfolge, Standardwert = „Hier ist die Datei, an der wir zusammenarbeiten“) – Benutzerdefinierte Nachricht, die in die Einladungs-E-Mail aufgenommen werden soll. Standardmäßig wird eine Standardnachricht verwendet, wenn nichts angegeben ist.

getFolderChildren

Zählt die 20 wichtigsten Dateien und Ordner innerhalb eines angegebenen Elternordners in einer Dokumentbibliothek auf. Wenn Sie keine Dokumentbibliothek angeben, wird die OneDrive des Benutzers verwendet.

Erforderliche Parameter:

• documentLibraryId(string) – ID der Dokumentbibliothek (auch Laufwerk genannt) für den übergeordneten Ordner. Wenn ein Benutzer Sie auffordern, Dateien in einem Ordner auf dem Laufwerk oder deren OneDrive abzurufen, z. B. "Dateien in einem Ordner auf meinem Laufwerk abrufen" oder "Dateien in einem Ordner in meinem OneDrive abrufen", senden Sie "ich" als documentLibraryId.

Optionale Parameter:

• parentFolderId:(String, default = "root") – ID des übergeordneten Ordners (DriveItem), dessen Dateien und Ordner aufgeführt sind. Standardmäßig wird das Rootverzeichnis der Dokumentbibliothek verwendet, wenn nichts angegeben wird.

Echo

Sendet die Nachricht zurück an den Client.

Erforderliche Parameter:

• message: Nachricht, die zurückgesendet werden soll.

setzeEmpfindlichkeitskennzeichnungAufDatei

Setzen Sie das Empfindlichkeitslabel einer Datei aus der angegebenen Dokumentbibliothek ein.

Erforderliche Parameter:

• documentLibraryId(string) – Die Dokumentbibliotheks-ID, auch bekannt als driveId, der Dokumentbibliothek.
• fileId(string) – Die Datei-ID, auch bekannt als driveItemId, der Datei.
• sensitivityLabelId(Zeichenfolge) – Erforderlich. ID der zuzuweisenden Vertraulichkeitsbezeichnung oder leere Zeichenfolge zum Entfernen der Vertraulichkeitsbezeichnung.

Optionale Parameter:

• assignmentMethod(Zeichenfolge, Standardwert = privileged) – Die Zuweisungsmethode der Bezeichnung im Dokument. Gibt an, ob die Zuweisung der Bezeichnung automatisch, standardmäßig oder als privilegierter Vorgang (Entsprechung eines Administratorvorgangs) durchgeführt wurde. Mögliche Werte sind standard, privileged, auto und unknownFutureValue.
• justificationText(Zeichenfolge, Standardwert = Geändert durch MCPServer) – Optional. Begründungstext für Überwachungszwecke; ist beim Herabstufen oder Entfernen einer Bezeichnung erforderlich.

getDefaultDocumentLibraryInSite

Rufen Sie die Standarddokumentbibliothek (auch als Laufwerk bezeichnet) auf einer SharePoint-Website ab. Wenn Sie keine Website angeben, wird die Stammwebsite verwendet.

Erforderliche Parameter:

Keine

Optionale Parameter:

• siteId: Website-ID (Standard: root)

Schlüsselfunktionen

Ordnerverwaltung

• Erstellen von Ordnern mit automatischer Namenskonfliktauflösung
• Aufzählen von untergeordneten Ordnern (Top 20)
• Verschieben von Dateien zwischen Ordnern (innerhalb derselben Website)

Dateivorgänge

• Kleine Textdateien erstellen und hochladen (weniger als 5 MB)
• Lesen und Herunterladen von Textdateien
• Umbenennen von Dateien und Ordnern
• Löschen von Dateien und Ordnern
• Abrufen von Datei- und Ordnermetadaten nach ID oder URL

Website- und Bibliothekserkennung

• Suchen nach SharePoint Websites nach Suchabfrage
• Dokumentbibliotheken auf einer Website auflisten
• Standarddokumentbibliothek abrufen

Freigabe und Berechtigungen

• Freigeben von Dateien und Ordnern mit Rollenzuweisungen
• Senden von Freigabeeinladungen mit benutzerdefinierten Nachrichten
• Access control über explizite Berechtigungen

Sicherheit und Compliance

• Festlegen von Vertraulichkeitsbezeichnungen für Dateien
• Unterstützung für privilegierte, standardmäßige und automatische Zuweisungsmethoden
• Begründungstext für die Complianceüberwachung

Integration

• OneDrive- und SharePoint Onlinesupport
• Mandantenspezifische Serververbindung
• DriveItem Abstraktion für Dateien und Ordner

Anmerkungen

• Die Standarddokumentbibliothek ist "me" (OneDrive des Benutzers)
• Der übergeordnete Standardordner ist „root“
• Ordnernamenkonflikte mit numerischen Suffixen gelöst
• Dateiverschiebungen auf weniger als 5 MB und innerhalb derselben Website begrenzt
• Freigabe-URLs erfordern explizite Zugriffsberechtigungen
• DriveItems repräsentieren sowohl Dateien als auch Ordner
• Top-20-Limit bei der Auflistung von untergeordneten Ordnern