Microsoft SharePoint- und OneDrive-MCP-Server-Referenz

Wichtig

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

Übersicht

Server-ID	Anzeigename	Beschreibung des Dataflows
mcp_ODSPRemoteServer	Microsoft SharePoint- und OneDrive-MCP-Server	MCP-Server, der Tools zum Arbeiten mit Ihren SharePoint- und OneDrive-Inhalten bereitstellt. Dieser Server stellt eine Verbindung mit Ihrem mandantenspezifischen SharePoint Online-MCP-Server her. Er erkennt automatisch alle Tools, die die Integration von OneDrive- und SharePoint-Dateien unterstützen, die vom ODSP-MCP-Endpunkt verfügbar gemacht werden.

Verfügbare Tools

createFolder

Erstellt einen neuen Ordner in einer angegebenen Dokumentbibliothek als untergeordnetes Element des angegebenen übergeordneten Ordners. Wenn Sie keine Dokumentbibliothek angeben, verwendet der Server das OneDrive-Verzeichnis 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(Zeichenfolge) – ID der Dokumentbibliothek (auch als Laufwerk bezeichnet), in der Sie den Ordner erstellen möchten. Wenn Sie einen Ordner auf dem Laufwerk des Benutzers oder in dessen OneDrive-Verzeichnis erstellen möchten, z. B. „Mein Laufwerk“ oder „Mein OneDrive“, senden Sie "me" als documentLibraryId.

Optionale Parameter:

• parentFolderId(Zeichenfolge, Standardwert = root) – ID des übergeordneten Ordners, unter dem der neue Ordner erstellt wird. Wenn nichts angegeben wird, wird standardmäßig das Stammverzeichnis der Dokumentbibliothek verwendet.

findSite

Findet 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 bzw. den der Benutzer zugreifen kann, indem er eine Suchabfrage übergibt.

Erforderliche Parameter:

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

renameFileOrFolder

Benennt eine Datei oder einen Ordner (auch als DriveItems bezeichnet) in der angegebenen Dokumentbibliothek um. Hinweis: Der neue Name muss den Benennungskonventionen entsprechen.

Erforderliche Parameter:

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

deleteFileOrFolder

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

Erforderliche Parameter:

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

readSmallTextFile

Lesen (Herunterladen) einer Textdatei aus einer bestimmten Dokumentbibliothek. Wenn Sie keine Dokumentbibliothek angeben, wird das OneDrive-Verzeichnis des Benutzers verwendet. Sie müssen eine fileId (driveItemId einer Datei) angeben, um die Datei zu identifizieren und herunterzuladen.

Erforderliche Parameter:

• fileId(Zeichenfolge)
• documentLibraryId(Zeichenfolge) – ID der Dokumentbibliothek (auch als Laufwerk bezeichnet) der Datei, die Sie lesen möchten. Wenn der Benutzer Sie bittet, eine Datei auf seinem Laufwerk oder OneDrive zu lesen oder herunterzuladen, z. B. eine Datei in „Mein Laufwerk“ zu lesen oder eine Datei in „Mein OneDrive“ zu lesen, sollten Sie „me“ als documentLibraryId senden.

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. Sie können Dateien nicht mithilfe dieser Anforderung zwischen Laufwerken verschieben.

Erforderliche Parameter:

• documentLibraryId(Zeichenfolge) – ID der Dokumentbibliothek (auch als Laufwerk bezeichnet) der Datei, die Sie verschieben möchten. Wenn der Benutzer Sie bittet, eine Datei auf seinem Laufwerk oder OneDrive zu verschieben, z. B. eine Datei in „Mein Laufwerk“ zu verschieben oder eine Datei in „Mein OneDrive“ zu verschieben, sollten Sie „me“ als documentLibraryId senden.
• fileId(Zeichenfolge) – 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

Abrufen von Metadaten einer Datei oder eines Ordners aus der angegebenen Dokumentbibliothek auf einer SharePoint-Website.

Erforderliche Parameter:

• FileOrFolderId(Zeichenfolge) – ID einer Datei oder eines Ordners. Werden auch als DriveItems bezeichnet. Ihre ID kann manchmal auch als driveItemId bezeichnet werden.
• documentLibraryId(Zeichenfolge) – ID der Dokumentbibliothek (auch als Laufwerk bezeichnet) der Datei oder des Ordners, für die bzw. den die Metadaten benötigen. Wenn Sie von einem Benutzer aufgefordert werden, eine Datei oder einen Ordner auf seinem Laufwerk oder OneDrive abzurufen, z. B. „Metadaten einer Datei auf meinem Laufwerk abrufen“ oder „Metadaten eines Ordners auf meinem OneDrive abrufen“, sollten Sie „me“ als documentLibraryId senden.

createSmallTextFile

Erstellen oder Hochladen einer Textdatei, die kleiner als 5 MB ist, in eine bestimmte Dokumentbibliothek. Wenn Sie keine Dokumentbibliothek angeben, wird das OneDrive-Verzeichnis 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:

• filename (Zeichenfolge) – Name der zu erstellenden Datei.
• contentText (Zeichenfolge) – Textinhalt der zu erstellenden Datei.
• documentLibraryId (Zeichenfolge) – ID der Dokumentbibliothek (auch als Laufwerk bezeichnet) für die Datei. Wenn Sie von einem Benutzer aufgefordert werden, eine Datei auf seinem Laufwerk oder OneDrive zu erstellen, z. B. „Datei auf meinem Laufwerk erstellen“ oder „Datei auf meinem OneDrive erstellen“, sollten Sie „me“ als documentLibraryId senden.

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 für den Zugriff auf die Datei können die Metadaten abrufen.

Erforderliche Parameter:

• fileOrFolderUrl:(Zeichenfolge) – URL der Datei oder des Ordners (auch als DriveItems bezeichnet). Die URL wird nicht eingelöst, um sie für den Benutzer freizugeben. Er muss bereits expliziten Zugriff auf die Datei haben.

shareFileOrFolder

Sendet eine Freigabeeinladung, um Berechtigungen für eine Datei oder einen Ordner in einer bestimmten Dokumentbibliothek zu erteilen. Unterstützt das Zuweisen von Rollen und das Benachrichtigen von Empfängern.

Erforderliche Parameter:

• documentLibraryId: Dokumentbibliotheks-ID (Zeichenfolge, erforderlich)
• fileOrFolderId: Datei- oder Ordner-ID (Zeichenfolge, 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 Lese- und Schreibzugriff). Standardmäßig wird die Lesen-Rolle 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

Listet die obersten 20 Dateien und Ordner in einem angegebenen übergeordneten Ordner in einer Dokumentbibliothek auf. Wenn Sie keine Dokumentbibliothek angeben, wird das OneDrive-Verzeichnis des Benutzers verwendet.

Erforderliche Parameter:

• documentLibraryId(Zeichenfolge) – ID der Dokumentbibliothek (auch als Laufwerk bezeichnet) für den übergeordneten Ordner. Wenn Sie von einem Benutzer aufgefordert werden, Dateien in einem Ordner auf seinem Laufwerk oder OneDrive abzurufen, z. B. „Dateien in einem Ordner auf meinem Laufwerk abrufen“ oder „Dateien in einem Ordner auf meinem OneDrive abrufen“, sollten Sie „me“ als documentLibraryId senden.

Optionale Parameter:

• parentFolderId:(Zeichenfolge, Standardwert = root) – ID des übergeordneten Ordners (DriveItem), dessen Dateien und Ordner aufgelistet sind. Standardmäßig wird der Stammordner der Dokumentbibliothek verwendet, wenn nichts angegeben ist.

Echo

Sendet die Nachricht zurück an den Client.

Erforderliche Parameter:

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

setSensitivityLabelOnFile

Legt die Vertraulichkeitsbezeichnung einer Datei aus der angegebenen Dokumentbibliothek fest.

Erforderliche Parameter:

• documentLibraryId(Zeichenfolge) – Die Dokumentbibliotheks-ID, auch als driveId bezeichnet, der Dokumentbibliothek.
• fileId(string) – Die Datei-ID, auch als driveItemId bezeichnet, 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

Ruft die Standarddokumentbibliothek (auch Laufwerk genannt) 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

• Erstellen und Hochladen kleiner Textdateien (< 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 Bibliotheksermittlung

• Suchen von SharePoint-Websites nach Suchabfrage
• Auflisten von Dokumentbibliotheken auf einer Website
• Abrufen der Standarddokumentbibliothek

Freigabe und Berechtigungen

• Freigeben von Dateien und Ordnern mit Rollenzuweisungen
• Senden von Freigabeeinladungen mit benutzerdefinierten Nachrichten
• Zugriffssteuerung ü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 Online-Unterstützung
• Mandantenspezifische Serververbindung
• DriveItem-Abstraktion für Dateien und Ordner

Anmerkungen

1. Standarddokumentbibliothek ist „me“ (OneDrive des Benutzers)
2. Der übergeordnete Standardordner ist „root“
3. Ordnernamenkonflikte mit numerischen Suffixen gelöst
4. Dateiverschiebungen auf weniger als 5 MB und innerhalb derselben Website begrenzt
5. Freigabe-URLs erfordern explizite Zugriffsberechtigungen
6. DriveItems stellen sowohl Dateien als auch Ordner dar
7. Top 20-Limit bei Aufzählung untergeordneter Ordner