Microsoft 365 SharePoint MCP-Serverreferenz

Übersicht

Verfügbare Tools

findSite

Suchen Sie SharePoint-Websites, auf die für den Benutzer zugegriffen werden kann. Gibt bestimmte Websites zurück, die einer Suchabfrage entsprechen, oder die 20 wichtigsten relevanten Websites, wenn keine Abfrage bereitgestellt wird.

Optionale Parameter:

• searchQuery: Suchabfrage (vollständiger oder teilweiser Websitename). Auslassen, um top 20 barrierefreie Websites anzuzeigen

getSiteByPath

Auflösen einer SharePoint-Website mithilfe des genauen Hostnamens und des serverrelativen Pfads. Wird nur verwendet, wenn Sie über die vollständige Website-URL-Struktur verfügen. Wird findSite verwendet, wenn nur ein Websitename bekannt ist.

Erforderliche Parameter:

• hostname: Exakter Hostname (z. B. 'contoso.sharepoint.com').
• serverRelativePath: Serverrelativer Pfad (z. B. "sites/Marketing"). Der führende Schrägstrich ist optional.

Unterwebseiten auflisten

Listet alle Unterwebsites (untergeordnete Websites) einer SharePoint-Website auf.

Erforderliche Parameter:

• Siteid: ID der übergeordneten SharePoint-Website (Format: 'hostname,siteCollectionId,webId')

listDocumentLibrariesInSite

Auflisten von Dokumentbibliotheken (Laufwerken) auf der angegebenen SharePoint-Website.

Optionale Parameter:

• Siteid: ID der SharePoint-Website (Standard: 'root')

getDefaultDocumentLibraryInSite

Rufen Sie die Standarddokumentbibliothek (Laufwerk) auf einer SharePoint-Website ab.

Optionale Parameter:

• Siteid: ID der SharePoint-Website (Standard: 'root')

getFolderChildren

Listet die obersten 20 Dateien und Ordner (DriveItems) auf, die in einem angegebenen übergeordneten Ordner in einer Dokumentbibliothek (Laufwerk) enthalten sind.

Erforderliche Parameter:

• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

Optionale Parameter:

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

findFileOrFolder

Sucht nach einer Datei oder einem Ordner (DriveItem), auf die der Benutzer durch Suchabfrage zugreifen kann. Sucht auf allen Websites und Dokumentbibliotheken, auf die der Benutzer Zugriff hat.

Erforderliche Parameter:

• searchQuery: Suchabfrage (vollständiger oder teilweiser Dateiname)

getFileOrFolderMetadata

Abrufen von Metadaten einer Datei oder eines Ordners (DriveItem) aus einer angegebenen Dokumentbibliothek (Laufwerk) in SharePoint.

Erforderliche Parameter:

• fileOrFolderId: ID der Datei oder des Ordners (DriveItem)
• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

getFileOrFolderMetadataByUrl

Abrufen von Metadaten einer Datei oder eines Ordners aus einer Freigabe-URL. Nur Benutzer mit vorhandenen expliziten Berechtigungen für den Zugriff auf die Datei sind zulässig.

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.

readSmallTextFile

Lesen (Herunterladen) einer Textdatei mit einer Größe von weniger als 5 MB aus einer bestimmten Dokumentbibliothek (Laufwerk).

Erforderliche Parameter:

• fileId: ID der Datei (DriveItem) zum Lesen/Herunterladen
• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

readSmallBinaryFile

Lesen einer Binärdatei mit einer Größe von weniger als 5 MB aus einer bestimmten Dokumentbibliothek (Laufwerk). Dateiinhalte werden als base64-codierte Zeichenfolge zurückgegeben.

Erforderliche Parameter:

• fileId: ID der Datei (DriveItem) zum Lesen/Herunterladen
• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

createSmallTextFile

Erstellen oder Hochladen einer Textdatei mit einer Größe von weniger als 5 MB in eine bestimmte Dokumentbibliothek (Laufwerk).

Erforderliche Parameter:

• Dateiname: Name der Datei einschließlich Erweiterung
• contentText: Textinhalt der Datei
• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

Optionale Parameter:

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

ErstelleKleineBinärdatei

Erstellen Sie eine Binärdatei mit einer Größe von weniger als 5 MB, indem Sie ihren Inhalt in eine bestimmte Dokumentbibliothek (Laufwerk) codieren.

Erforderliche Parameter:

• Dateiname: Name der Datei einschließlich Erweiterung
• Base64content: Binäre Dateiinhalte, die als base64-Zeichenfolge codiert sind
• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

Optionale Parameter:

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

OrdnerErstellen

Erstellen Eines neuen Ordners (DriveItem) in einer angegebenen Dokumentbibliothek (Laufwerk). Wenn ein Ordner mit demselben Namen vorhanden ist, wird ein numerisches Suffix hinzugefügt (z. B. NewFolder (1)).

Erforderliche Parameter:

• Foldername: Name des Ordners
• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)

Optionale Parameter:

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

umbenennenDateiOderOrdner

Benennen Sie eine Datei oder einen Ordner (DriveItem) in einer angegebenen Dokumentbibliothek (Laufwerk) um. Der neue Name muss den Benennungskonventionen entsprechen.

Erforderliche Parameter:

• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)
• fileOrFolderId: ID der umzubenennende Datei oder des Ordners
• newFileOrFolderName: Der neue Name

Optionale Parameter:

• Etag: ETag für Konkurrenzkontrolle

deleteFileOrFolder

Löschen einer Datei oder eines Ordners (DriveItem) aus einer angegebenen Dokumentbibliothek (Laufwerk).

Erforderliche Parameter:

• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)
• fileOrFolderId: ID der zu löschenden Datei oder des Zu löschenden Ordners

Optionale Parameter:

• Etag: ETag für Konkurrenzkontrolle

moveSmallFile

Verschieben sie eine Datei (DriveItem) in einen anderen Ordner innerhalb derselben Dokumentbibliothek. Unterstützt nur Dateien unter 5 MB. Das Verschieben zwischen Laufwerken ist nicht möglich.

Erforderliche Parameter:

• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)
• fileId: ID der zu verschiebenden Datei
• newParentFolderId: ID des Zielordners (muss sich in derselben Dokumentbibliothek befinden)

Optionale Parameter:

• Etag: ETag für Konkurrenzkontrolle

KopiereDateiOderOrdner

Kopieren Sie eine Datei oder einen Ordner (DriveItem) in einen Zielordner. Unterstützt das Kopieren in verschiedenen Dokumentbibliotheken in SharePoint. Dieser Vorgang ist asynchron; wird checkOperationStatus verwendet, um den Fortschritt zu überwachen.

Erforderliche Parameter:

• sourcedoclibid: ID der Quelldokumentbibliothek (Laufwerk)
• sourcefileid: ID der zu kopierenden Quelldatei oder des Zu kopierenden Ordners
• destdoclibid: ID der Zieldokumentbibliothek (Laufwerk)
• destfolderid: ID des Zielordners (muss vorhanden sein)

Optionale Parameter:

• newfilename: Neuer Name für das kopierte Element

ÜberprüfeBetriebsstatus

Überprüfen Sie den Status eines asynchronen Vorgangs (z. B. eine Kopie) mithilfe des vom ursprünglichen Vorgang zurückgegebenen Vorgangstokens.

Erforderliche Parameter:

• operationToken: Das von einem asynchronen Vorgang zurückgegebene Vorgangstoken wie copyFileOrFolder

uploadFileFromUrl

Hochladen einer Datei aus einer SharePoint- oder OneDrive-URL in einen Zielordner in einer Dokumentbibliothek (Laufwerk). Die Datei wird aus der Quell-URL kopiert; Am Original werden keine Änderungen vorgenommen.

Erforderliche Parameter:

• sourceUrl: Quell-URL (muss eine gültige SharePoint- oder OneDrive-URL sein)
• destinationDocumentLibraryId: ID der Zieldokumentbibliothek. Verwenden Sie 'me' für das OneDrive des Benutzers

Optionale Parameter:

• destinationFolderId: ID des Zielordners (Standard: 'root')
• Dateiname: Neuer Dateiname; Standardmäßig wird der ursprüngliche Dateiname verwendet.

shareFileOrFolder

Sendet eine Freigabeeinladung, um Lese-/Schreibberechtigungen für eine Datei oder einen Ordner (DriveItem) innerhalb einer angegebenen Dokumentbibliothek (Laufwerk) zu erteilen.

Erforderliche Parameter:

• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)
• fileOrFolderId: ID der zu teilenden Datei oder des Ordners
• recipientEmails: Array von E-Mail-Adressen von Empfängern
• Rollen: Array von Rollen: "lesen", "schreiben" ("schreiben" gewährt sowohl Lese- als auch Schreibzugriff)

Optionale Parameter:

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

setzeEmpfindlichkeitskennzeichnungAufDatei

Legen Sie die Vertraulichkeitsbezeichnung einer Datei aus der angegebenen Dokumentbibliothek (Laufwerk) fest.

Erforderliche Parameter:

• documentLibraryId: ID der Dokumentbibliothek (Laufwerk)
• fileId: Die driveItemId der Datei
• sensitivityLabelId: ID der Vertraulichkeitsbezeichnung oder leere Zeichenfolge, die entfernt werden soll

Optionale Parameter:

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

listLists

Abrufen aller SharePoint-Listen, die auf einer bestimmten Website verfügbar sind. Verwenden Sie dies, um zu entdecken, welche Listen innerhalb einer Website vorhanden sind.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website (Format: 'hostname,siteCollectionId,webId')

createList

Erstellen Sie eine neue SharePoint-Liste innerhalb einer Website.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• Displayname: Anzeigename der neuen Liste

Optionale Parameter:

• Spalten: Sammlung von Spalten als Schlüsselwertpaare: [{ Key: 'JobTitle', Value: 'text' }]. Gültige Typen: Text, Mehrzeiliger Text, Zahl, Boolean, DatumUhrzeit, Auswahl, Nachschlagen, PersonOderGruppe, Hyperlink, Währung, Berechnet
• Vorlage: Listenvorlagentyp (Standard: 'genericList'). Optionen: GenericList, DocumentLibrary, Ereignisse, Aufgaben, Ankündigungen, Kontakte, Links, Umfrage, IssueTracking, DiscussionBoard

Löschliste

Löschen einer SharePoint-Liste von einer Website. Löscht den gesamten Listencontainer und alle darin enthaltenen Elemente. Kann nicht rückgängig gemacht werden.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der zu löschenden Liste

Optionale Parameter:

• Etag: ETag für Konkurrenzkontrolle

EinladungFürListeSenden

Sendet eine Freigabeeinladung, um Berechtigungen für eine SharePoint-Liste zu gewähren.

Erforderliche Parameter:

• listId: ID der zu teilenden SharePoint-Liste
• recipientEmails: Array von E-Mail-Adressen von Empfängern
• Rolle: Rolle: "lesen" (nur anzeigen), "mitwirken" (Ansicht, Hinzufügen, Aktualisieren, Löschen von Elementen), "Bearbeiten" (vollständige Bearbeitung einschließlich Listenstruktur)

Optionale Parameter:

• Siteurl: Website-URL der SharePoint-Website, die die Liste enthält
• Sendemail: Gibt an, ob eine E-Mail-Benachrichtigung gesendet werden soll (Standard: true)

listListItems

Dient zum Abrufen von Elementen (Zeilen/Datensätzen) aus einer bestimmten SharePoint-Liste.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste

getListItem

Ruft ein einzelnes Element (Zeile/Datensatz) aus einer SharePoint-Liste anhand seiner ID ab.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Itemid: ID des spezifischen Listenelements

createListItem

Erstellen sie ein neues Element (Zeile/Datensatz) in einer SharePoint-Liste.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Felder: Schlüssel-Wert-Paare für Feldwerte: [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Das Feld "Titel" ist in der Regel erforderlich.

aktualisiereListenelement

Aktualisieren eines vorhandenen Elements (Zeile/Datensatz) in einer SharePoint-Liste. Nur angegebene Felder werden aktualisiert; Ausgelassene Felder behalten ihre Werte bei.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Itemid: ID des zu aktualisierenden Elements
• Felder: Schlüsselwertpaare von zu aktualisierenden Feldern

Optionale Parameter:

• Etag: ETag für Konkurrenzkontrolle

LöscheListenElement

Löschen eines Elements (Zeile/Datensatz) aus einer SharePoint-Liste.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Itemid: ID des zu löschenden Elements

Optionale Parameter:

• Etag: ETag für Konkurrenzkontrolle

listColumns

Ruft alle Spalten aus einer SharePoint-Liste ab.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste

SpalteErstellen

Erstellen Sie eine neue Spalte in einer SharePoint-Liste. Unterstützt viele Spaltentypen, einschließlich Text, Zahl, Auswahl, Datum/Uhrzeit, Boolescher Wert, Benutzer, Nachschlagen, berechneter Wert und mehr.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Namen: Interner Spaltenname (programmgesteuerter Bezeichner)
• Columntyp: Spaltentyp: Text, Notiz, Zahl, Ganzzahl, Boolesch, DatumZeit, Auswahl, Mehrfachauswahl, Währung, Nachschlagen, Benutzer, URL, Berechnet, Begriff, Mehrfachbegriff, Ort, Geolokation, Miniaturansicht, Zähler, Berechnet, Inhaltstyp-ID, Datei, Anhang, GUID, Ergebnisauswahl, Genehmigungsstatus

Optionale Parameter:

• columnProperties: Typspezifische Einstellungen (z. B. { "maxLength": 255 } für Text, { "choices": ["A","B","C"] } für Auswahl)
• Beschreibung: Beschreibung der Spalte
• Displayname: Anzeigename, der in der Benutzeroberfläche angezeigt wird (Standardeinstellung : 'Name')
• Erforderlich: Festlegen der erforderlichen Spalte (Standard: false)
• Versteckte: Spalte aus Ansichten ausblenden (Standard: false)

aktualisiereSpalte

Aktualisieren einer vorhandenen Spalte in einer SharePoint-Liste.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Columnid: ID der zu aktualisierenden Spalte

Optionale Parameter:

• Columntype: Spaltentyp (erforderlich beim Bereitstellen von 'columnProperties')
• columnProperties: Typspezifische Eigenschaften, die aktualisiert werden sollen
• Beschreibung: Neue Beschreibung
• Displayname: Neuer Anzeigename
• Versteckt: Spalte ausblenden oder anzeigen
• Erforderlich: Spalte als erforderlich oder optional einstellen

SpalteLöschen

Löschen einer Spalte aus einer SharePoint-Liste Warnung: Entfernt alle in dieser Spalte gespeicherten Daten für alle Elemente.

Erforderliche Parameter:

• Siteid: ID der SharePoint-Website
• listId: ID der SharePoint-Liste
• Columnid: ID der zu löschenden Spalte

Wichtigste Funktionen

Websiteverwaltung

• Suchen von Websites anhand des Namens oder Durchsuchen von barrierefreien Websites
• Abrufen der Website anhand des genauen URL-Pfads
• Untergeordnete Websites und Subsites auflisten
• Umfassende Navigation der Website-Hierarchie

Dokumentbibliotheksverwaltung

• Auflisten aller Dokumentbibliotheken auf einer Website
• Standarddokumentbibliothek abrufen
• Durchsuchen von Ordnerinhalten (bis zu 20 Elemente)
• Erstellen und Verwalten von Ordnerstrukturen

Dateivorgänge

• Erstellen von Text- und Binärdateien (≤5MB)
• Lesen von Text- und Binärdateien (≤5MB)
• Löschen, Umbenennen und Verschieben von Dateien
• Kopieren von Dateien und Ordnern zwischen Dokumentbibliotheken
• Hochladen von Dateien aus SharePoint- oder OneDrive-URLs
• Suchen nach Dateien und Ordnern auf allen barrierefreien Websites
• Abrufen von Datei- und Ordnermetadaten

Asynchrone Vorgänge

• Asynchrones Kopieren von Dateien und Ordnern in Dokumentbibliotheken
• Überprüfen des Status asynchroner Vorgänge mithilfe von Vorgangstoken

Vorgänge auflisten

• Erstellen, Lesen und Löschen von Listen
• Unterstützung für mehrere Listenvorlagen (generische, Dokumentbibliothek, Ereignisse, Aufgaben)
• Freigeben von Listen mit rollenbasierten Berechtigungen
• Verwalten von Listenelementen (Erstellen, Lesen, Aktualisieren, Löschen)

Spaltenverwaltung

• Erstellen von Spalten mit einer Vielzahl von Typen (Text, Notiz, Zahl, boolescher Wert, dateTime, Choice, Lookup, Benutzer, URL, berechnet und mehr)
• Aktualisieren von Spalteneigenschaften und Metadaten
• Konfigurieren von Spaltenanforderungen und Sichtbarkeit
• Typspezifische Spalteneigenschaften

Freigabe und Berechtigungen

• Freigeben von Dateien, Ordnern und Listen für Benutzer
• Rollenbasierte Zugriffssteuerung (Lesen, Schreiben, Mitwirken, Bearbeiten)
• 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

• Dateivorgänge sind auf ≤5MB für Upload und Download beschränkt.
• Verschiebevorgänge funktionieren nur innerhalb derselben Dokumentbibliothek.
• Kopiervorgänge sind asynchron; verwenden Sie checkOperationStatus um den Fortschritt zu überwachen.
• Kopiervorgänge unterstützen bibliotheksübergreifendes Kopieren in SharePoint
• uploadFileFromUrl erfordert eine gültige SharePoint- oder OneDrive-Quell-URL
• eTags bieten Parallelitätssteuerung für Updates und Löschungen
• Automatisches numerisches Suffix für doppelte Ordnernamen
• Listenlöschung kann nicht rückgängig gemacht werden
• Beim Löschen von Spalten werden alle in dieser Spalte gespeicherten Daten entfernt.
• Suchvorgänge geben standardmäßig top 20 Ergebnisse zurück.
• Alle Vorgänge verwenden die Microsoft Graph-API