MCP-Serverreferenz für SharePoint-Listentools

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_SharePointListsTools	Microsoft SharePoint-Listen-MCP-Server	MCP-Server, der Microsoft Graph SharePoint-Tools für Listen bereitstellt. MCP-Server, der Microsoft Graph SharePoint-Tools für Listen bereitstellt.

Verfügbare Tools

sharepoint_createList

Erstellen einer neuen SharePoint-Liste auf einer Website.

Erforderliche Parameter

• siteId: eindeutige ID der Website
• displayName: Anzeigename der Liste
• list: Listet Informationen wie Vorlage auf (z. B. genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Erstellt eine neue Spalte (columnDefinition) in einer bestimmten SharePoint-Liste. Sie müssen die Ziel-siteId und -listId sowie eine gültige Spaltendefinition angeben, die den Namen, den Anzeigenamen und genau einen Spaltentyp angibt (z. B. Text, Zahl, Auswahl, dateTime, personOrGroup, Nachschlagevorgang, boolescher Wert oder hyperlinkOrPicture).

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste
• name: API/statischer Name der Spalte (keine Leerzeichen, 1 bis 64 Zeichen)

Optionale Parameter:

• displayName: benutzerorientierter Anzeigename
• description: Spaltenbeschreibung
• enforceUniqueValues: Bei „true“ müssen Werte eindeutig sein.
• hidden: Bei „true“ wird die Spalte ausgeblendet.
• indexed: Bei „true“ werden Werte indiziert
• required: Bei „true“ ist ein Wert erforderlich
• readOnly: Bei „true“ können Werte nicht geändert werden
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Spaltentyp-Einstellungen (eine erforderlich)

sharepoint_createListItem

Erstellen eines neuen Elements in einer SharePoint-Liste.

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste
• fields: Feldwerte für das Listenelement (Schlüssel/Wert-Zuordnung)

sharepoint_deleteListColumn

Löschen einer vorhandenen columnDefinition aus einer bestimmten SharePoint-Liste. Geben Sie siteId, listId und columnId an. Mit dieser Aktion wird die Spalte dauerhaft aus dem Listenschema entfernt.

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste
• columnId: eindeutige ID der zu löschenden Spalte

sharepoint_deleteListItem

Ein Element löschen

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste
• itemId: eindeutige ID des Listenelements

Optionale Parameter:

• ifMatch: Optionales ETag für Parallelitätssteuerung (z. B. „*“)

sharepoint_editListColumn

Aktualisieren einer vorhandenen columnDefinition aus einer bestimmten SharePoint-Liste. Geben Sie siteId, listId und columnId an. Textkörper ist teilweise – schließen Sie nur die Eigenschaften ein, die Sie ändern möchten (z. B. displayName, Beschreibung, ausgeblendet, erforderlich oder Faceteinstellungen).

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste
• columnId: eindeutige ID der zu aktualisierenden Spalte

Optionale Parameter:

• displayName: benutzerorientierter Anzeigename
• description: Spaltenbeschreibung
• hidden: Bei „true“ wird die Spalte ausgeblendet.
• required: Bei „true“ ist ein Wert erforderlich
• enforceUniqueValues: Bei „true“ müssen Werte eindeutig sein.
• indexed: Bei „true“ werden Werte indiziert
• readOnly: Bei „true“ können Werte nicht geändert werden
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Aktualisieren der Spaltentyp-Einstellungen

sharepoint_getSiteByPath

Auflösen einer SharePoint-Website mithilfe des Hostnamens und des serverrelativen Pfads.

Erforderliche Parameter:

• hostname: Hostname des SharePoint-Mandanten (z. B. contoso.sharepoint.com)
• serverRelativePath: serverrelativer Pfad zur Website (z. B. Websites/Marketing)

sharepoint_listListColumns

Listenspaltendefinitionen (columnDefinition-Ressourcen) für eine bestimmte SharePoint-Liste. Erfordert siteId und listId. Unterstützt OData-Parameter wie $select, $top und $skiptoken.

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste

Optionale Parameter:

• select: kommagetrennte Liste der Benutzereigenschaften, die zurückgegeben werden sollen
• filter: OData-Filterausdruck zum Einschränken von Ergebnissen
• orderBy: kommagetrennte Liste von Eigenschaften, nach der sortiert werden soll
• top: Seitengröße (1–999)
• skiptoken: Opaque-Token zum Weiterblättern zum nächsten Satz

sharepoint_listListItems

Listenelemente aus einer SharePoint-Liste.

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste

Optionale Parameter:

• expand: optionale OData-Erweiterung (z. B. Felder)
• top: optionale Seitengröße
• filter: optionaler OData-Filterausdruck
• select: optionale OData-Auswahlklausel

sharepoint_listLists

Listet alle SharePoint-Listen auf einer Website auf.

Erforderliche Parameter:

• siteId: eindeutige ID der Website

sharepoint_listSubsites

Listet untergeordnete Websites (Unterwebsites) für eine bestimmte Website auf.

Erforderliche Parameter:

• siteId: eindeutige ID der Website

sharepoint_search

Sucht SharePoint mithilfe der Microsoft Graph Search-API mit entityTypes=["site"].

Erforderliche Parameter:

• requests: Array von searchRequest-Objekten

Optionale Parameter:

• entityTypes: Muss ["site"] für SharePoint-Websitesuchen sein
• query: Abfrageobjekt mit Suchzeichenfolge im KQL-Stil
• from: nullbasierter Offset des ersten Ergebnisses
• size: Anzahl der zurückzugebenden Ergebnisse (1–50)
• fields: optionale Liste der Felder, die in der Antwort ausgewählt werden können

13. sharepoint_searchSitesByName

Suchen von SharePoint-Websites nach Anzeigename oder teilweiser URL (natürliche Sprache).

Erforderliche Parameter:

• search: Anzeigename oder teilweiser Name/URL der SharePoint-Website, nach der gesucht werden soll

Optionale Parameter:

• consistencyLevel: erforderlich für Microsoft Graph (Standard: eventual)

14. sharepoint_updateListItem

Aktualisieren von Feldern eines vorhandenen Listenelements.

Erforderliche Parameter:

• siteId: eindeutige ID der Website
• listId: eindeutige ID der Liste
• itemId: eindeutige ID des Listenelements
• fields: zu aktualisierende Feldwerte (teilweise)

Optionale Parameter:

• ifMatch: optionales ETag für Parallelitätssteuerung (z. B. „*“ zum Erzwingen)

Wichtige Funktionen

Listenverwaltung

• Erstellen neuer SharePoint-Listen mit Vorlagen
• Auflisten aller Listen auf einer Website
• Unterstützung für verschiedene Listenvorlagen (genericList, documentLibrary, issueTracking)

Spaltenvorgänge

• Erstellen von Spalten mit mehreren Datentypen (Text, Zahl, Auswahl, dateTime, personOrGroup, Suche, boolescher Wert, hyperlinkOrPicture)
• Bearbeiten vorhandener Spalten
• Spalten löschen
• Auflisten aller Spalten in einer Liste
• Spaltenüberprüfung und Eindeutigkeitseinschränkungen

Elementvorgänge

• Erstellen von Listenelementen mit Feldwerten
• Aktualisieren vorhandener Listenelemente (teilweise Aktualisierungen)
• Löschen von Listenelementen
• Auflisten von Elementen mit Filterung und Paginierung
• Parallelitätssteuerung über ETag

Website-Ermittlung

• Suchen von Websites nach Name oder URL
• Auflösen von Websites nach Hostname und Pfad
• Auflisten von Unterwebsites
• KQL-Stilsuche mit der Microsoft Graph Search-API

OData-Abfrageunterstützung

• Verwenden von $select zur Auswahl von Eigenschaften.
• Verwenden von $filter zum Filtern von Ergebnissen.
• Verwenden von $expand, um verwandte Entitäten einzuschließen.
• Verwenden von $orderby, um Ergebnisse zu sortieren.
• Verwenden von $top für die Paginierung.
• Verwenden von $skiptoken, um große Ergebnissätze zu durchblättern.

Unterstützung für Spaltentypen

• Textspalten (einzeilig oder mehrzeilig, Nur-Text oder Rich-Text).
• Zahlenspalten (mit Dezimalstellen, Minimal- und Höchstwerten).
• Auswahlspalten (Kontrollkästchen, Dropdown- oder Optionsfelder).
• Boolesche Spalten.
• DateTime-Spalten (nur Datum oder Datum und Uhrzeit).
• Personen- oder Gruppenspalten (einzelne oder mehrfache Auswahl).
• Suchspalten (Verweis auf andere Listen).
• Hyperlink- oder Bildspalten.

Anmerkungen

1. Alle Vorgänge verwenden Microsoft Graph API v1.0.
2. Spaltennamen müssen 1 bis 64 Zeichen enthalten (ohne Leerzeichen).
3. Jede Spalte muss genau einen Spaltentyp angeben.
4. Parallelitätssteuerung ist über die If-Match-Kopfzeile verfügbar.
5. Websitesuchvorgänge erfordern, dass consistencyLevel auf eventual festgelegt ist.
6. Suchergebnisse sind auf 50 Elemente pro Seite beschränkt.
7. Teilweise Aktualisierungen werden für Spalten und Listenelemente unterstützt.