Naslaginformatie voor MCP-server voor hulpprogramma's voor SharePoint-lijsten

Belangrijk

U moet deelnemen aan het preview-programma Frontier om vroegtijdige toegang te krijgen tot Microsoft Agent 365. Frontier verbindt u rechtstreeks met de nieuwste AI-innovaties van Microsoft. Op Frontier-previews zijn de bestaande preview-voorwaarden van uw klantovereenkomsten van toepassing. Omdat deze functies nog in ontwikkeling zijn, kunnen de beschikbaarheid en mogelijkheden hiervan na verloop van tijd veranderen.

Overzicht

Server ID	Weergavenaam	Omschrijving
mcp_SharePointListsTools	MCP-server voor Microsoft SharePoint-lijsten	MCP-server met Microsoft Graph SharePoint-hulpprogramma's voor lijsten. MCP-server met Microsoft Graph SharePoint-hulpprogramma's voor lijsten.

Beschikbare hulpmiddelen

sharepoint_createList

Maak een nieuwe SharePoint-lijst op een site.

Vereiste parameters

• siteId: de unieke id van de site
• displayName: weergavenaam van de lijst
• list: hiermee worden gegevens zoals de sjabloon weergegeven (bijvoorbeeld genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Maak een nieuwe kolom (columnDefinition) in een specifieke SharePoint-lijst. U moet de siteId en listId voor het doel opgeven, plus een geldige kolomdefinitie die de naam van de kolom, de weergavenaam en exact één kolomtype opgeeft (bijvoorbeeld text, number, choice, dateTime, personOrGroup, lookup, boolean of hyperlinkOrPicture).

Vereiste parameters:

• siteId: de unieke id van de site
• listId: de unieke id van de lijst
• name: API/statische naam van de kolom (geen spaties, 1-64 tekens)

Optionele parameters:

• displayName: gebruikersgerichte weergavenaam
• description: kolombeschrijving
• enforceUniqueValues: indien waar, moeten waarden uniek zijn
• hidden: indien waar, is de kolom verborgen
• indexed: indien waar, worden waarden geïndexeerd
• required: indien waar, is een waarde vereist
• readOnly: indien waar, kunnen waarden niet worden gewijzigd
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: instellingen voor kolomtype (één vereist)

sharepoint_createListItem

Maak een nieuw item in een SharePoint-lijst.

Vereiste parameters:

• siteId: de unieke id van de site
• listId: de unieke id van de lijst
• fields: veldwaarden voor het lijstitem (sleutel-/waardetoewijzing)

sharepoint_deleteListColumn

Verwijder een bestaande columnDefinition uit een specifieke SharePoint-lijst. Geef waarden op voor siteId, listId en columnId. Met deze actie wordt de kolom definitief uit het lijstschema verwijderd.

Vereiste parameters:

• siteId: unieke id van de site
• listId: unieke id van de lijst
• columnId: unieke id van de kolom die u wilt verwijderen

sharepoint_deleteListItem

Een lijstitem verwijderen.

Vereiste parameters:

• siteId: de unieke id van de site
• listId: de unieke id van de lijst
• itemId: de unieke id van het lijstitem

Optionele parameters:

• ifMatch: optionele ETag voor gelijktijdigheidsbeheer (bijvoorbeeld "*")

sharepoint_editListColumn

Werk een bestaande columnDefinition voor een specifieke SharePoint-lijst bij. Geef waarden op voor siteId, listId en columnId. De hoofdtekst is gedeeltelijk. Neem alleen de eigenschappen op die u wilt wijzigen (zoals displayName, hidden, required of facetinstellingen).

Vereiste parameters:

• siteId: unieke id van de site
• listId: unieke id van de lijst
• columnId: unieke id van de kolom die u wilt bijwerken

Optionele parameters:

• displayName: gebruikersgerichte weergavenaam
• description: kolombeschrijving
• hidden: indien waar, is de kolom verborgen
• required: indien waar, is een waarde vereist
• enforceUniqueValues: indien waar, moeten waarden uniek zijn
• indexed: indien waar, worden waarden geïndexeerd
• readOnly: indien waar, kunnen waarden niet worden gewijzigd
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Instellingen voor kolomtype bijwerken

sharepoint_getSiteByPath

Zet een SharePoint-site om met behulp van de hostnaam en het server-relatieve pad.

Vereiste parameters:

• hostname: hostnaam van de SharePoint-tenant (bijvoorbeeld contoso.sharepoint.com)
• serverRelativePath: server-relatief pad naar de site (bijvoorbeeld sites/Marketing)

sharepoint_listListColumns

Geef kolomdefinities (columnDefinition-resources) weer voor een specifieke SharePoint-lijst. Vereist een siteId en listId. Ondersteunt OData-parameters zoals $select, $top en $skiptoken.

Vereiste parameters:

• siteId: de unieke id van de site
• listId: de unieke id van de lijst

Optionele parameters:

• select: door komma's gescheiden lijst met eigenschappen die moeten worden geretourneerd
• filter: OData-filterexpressie om de resultaten te beperken
• orderBy: door komma's gescheiden lijst met eigenschappen waarop moet worden gesorteerd
• top: paginaformaat (1-999)
• skiptoken: ondoorzichtig token voor paginering naar de volgende set

sharepoint_listListItems

Geef items uit een SharePoint-lijst weer.

Vereiste parameters:

• siteId: de unieke id van de site
• listId: de unieke id van de lijst

Optionele parameters:

• expand: optionele OData-uitbreiding (bijvoorbeeld velden)
• top: optioneel paginaformaat
• filter: optionele OData-filterexpressie
• select: optionele select-component voor OData

sharepoint_listLists

Geef alle SharePoint-lijsten op een site weer.

Vereiste parameters:

• siteId: de unieke id van de site

sharepoint_listSubsites

Geef onderliggende sites (subsites) voor een bepaalde site weer.

Vereiste parameters:

• siteId: de unieke id van de site

sharepoint_search

Doorzoek SharePoint met behulp van de zoek-API van Microsoft Graph met entityTypes=["site"].

Vereiste parameters:

• requests: matrix van searchRequest-objecten

Optionele parameters:

• entityTypes: moet ["site"] zijn voor zoekopdrachten op SharePoint-sites
• query: queryobject met zoekreeks in KQL-stijl
• from: offset op basis van nul van het eerste resultaat
• size: aantal resultaten dat moet worden geretourneerd (1-50)
• fields: optionele lijst met velden die in het antwoord moeten worden geselecteerd

13. sharepoint_searchSitesByName

Doorzoek SharePoint-sites op weergavenaam of gedeeltelijke URL (natuurlijke taal).

Vereiste parameters:

• search: weergavenaam of gedeeltelijke naam/URL van de SharePoint-site waarnaar moet worden gezocht

Optionele parameters:

• consistencyLevel: vereist door Microsoft Graph (standaard: uiteindelijk)

14. sharepoint_updateListItem

Werk velden van een bestaand lijstitem bij.

Vereiste parameters:

• siteId: de unieke id van de site
• listId: de unieke id van de lijst
• itemId: de unieke id van het lijstitem
• fields: veldwaarden die moeten worden bijgewerkt (gedeeltelijk)

Optionele parameters:

• ifMatch: optionele ETag voor gelijktijdigheidsbeheer (bijvoorbeeld '*' om af te dwingen)

Belangrijke functies

Lijstbeheer

• Nieuwe SharePoint-lijsten maken met sjablonen
• Alle lijsten op een site weergeven
• Ondersteuning voor verschillende lijstsjablonen (genericList, documentLibrary, issueTracking)

Kolombewerkingen

• Kolommen maken met meerdere gegevenstypen (text, number, choice, dateTime, personOrGroup, lookup, boolean, hyperlinkOrPicture)
• Bestaande kolommen bewerken
• Kolommen verwijderen
• Alle kolommen in een lijst weergeven
• Beperkingen voor kolomvalidatie en -uniciteit

Itembewerkingen

• Lijstitems met veldwaarden maken
• Bestaande lijstitems bijwerken (gedeeltelijke updates)
• Lijstitems verwijderen
• Lijstitems met filteren en pagineren
• Gelijktijdigheidsbeheer via ETag

Sitedetectie

• Sites doorzoeken op naam of URL
• Sites omzetten op basis van hostnaam en pad
• Subsites weergeven
• Zoeken in KQL-stijl met zoek-API van Microsoft Graph

Ondersteuning voor OData-query's

• Gebruik $select om eigenschappen te kiezen.
• Gebruik $filter om resultaten te filteren.
• Gebruik $expand om gerelateerde entiteiten op te nemen.
• Gebruik $orderby om resultaten te sorteren.
• Gebruik $top voor paginering.
• Gebruik $skiptoken om door grote resultatensets te struinen.

Ondersteuning voor kolomtype

• Tekstkolommen (één regel of meerdere regels, tekst zonder opmaak of tekst met opmaak).
• Kolommen met numerieke waarden (met decimalen en minimum- en maximumwaarden).
• Keuzekolommen (selectievakjes, vervolgkeuzelijst of keuzerondjes).
• Booleaanse kolommen.
• Datum-/tijdkolommen (alleen datum of datum en tijd).
• Kolommen voor personen of groepen (een of meerdere selecties).
• Opzoekkolommen (die verwijzen naar andere lijsten).
• Hyperlink- of afbeeldingskolommen.

Opmerkingen

1. Alle bewerkingen maken gebruik van Microsoft Graph API v1.0.
2. Kolomnamen moeten 1-64 tekens zonder spaties bevatten.
3. Voor elke kolom moet precies één kolomtype worden opgegeven.
4. Gelijktijdigheidsbeheer is beschikbaar via de If-Match-header.
5. Voor sitezoekopdrachten moet consistencyLevel zijn ingesteld op eventual.
6. Zoekresultaten zijn beperkt tot 50 items per pagina.
7. Gedeeltelijke updates worden ondersteund voor kolommen en lijstitems.