McP-serverreferens för SharePoint-listverktyg

Viktigt

Du måste vara en del av förhandsversionen av Frontier för att få tidig åtkomst till Microsoft Agent 365. Frontier ansluter dig direkt till Microsofts senaste AI-innovationer. Förhandsversioner av Gräns omfattas av de befintliga förhandsversionsvillkoren för dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och funktioner ändras över tid.

Översikt

Server-ID	Visningsnamn	Description
mcp_SharePointListsTools	Microsoft SharePoint listar MCP Server	MCP-server som tillhandahåller Microsoft Graph SharePoint-verktyg för listor. MCP-server som tillhandahåller Microsoft Graph SharePoint-verktyg för listor.

Tillgängliga verktyg

sharepoint_createList

Skapa en ny SharePoint-lista på en webbplats.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• displayName: Visningsnamn för listan
• list: Listinformation som mall (till exempel genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Skapa en ny kolumn (columnDefinition) i en specifik SharePoint-lista. Du måste ange mål-siteId och listId, plus en giltig kolumndefinition som anger kolumnens namn, visningsnamn och exakt en kolumntyp (till exempel text, nummer, val, dateTime, personOrGroup, uppslag, booleskt värde eller hyperlänkOrPicture).

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• listId: Det unika ID:t för listan
• namn: API/statiskt namn på kolumnen (inga blanksteg, 1–64 tecken)

Valfria parametrar

• displayName: Visningsnamn mot användare
• beskrivning: Kolumnbeskrivning
• enforceUniqueValues: Om sant måste värdena vara unika
• dold: Om sant är kolumnen dold
• indexerad: Om sant indexeras värden
• obligatoriskt: Om sant krävs ett värde
• readOnly: Om sant kan värden inte ändras
• text, tal, val, boolesk, dateTime, personOrGroup, uppslag, hyperlänkOrPicture: Kolumntypinställningar (ett krävs)

sharepoint_createListItem

Skapa ett nytt objekt i en SharePoint-lista.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• listId: Det unika ID:t för listan
• fält: Fältvärden för listobjektet (nyckel/värdekarta)

sharepoint_deleteListColumn

Ta bort en befintlig columnDefinition från en specifik SharePoint-lista. Ange siteId, listId och columnId. Den här åtgärden tar bort kolumnen permanent från listschemat.

Obligatoriska parametrar

• siteId: Unikt ID för webbplatsen
• listId: Unikt ID för listan
• columnId: Unikt ID för kolumnen som ska tas bort

sharepoint_deleteListItem

Ta bort ett objekt från en lista.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• listId: Det unika ID:t för listan
• itemId: Listobjektets unika ID

Valfria parametrar

• ifMatch: Valfri ETag för samtidighetskontroll (t.ex. "*")

sharepoint_editListColumn

Uppdatera en befintlig columnDefinition på en specifik SharePoint-lista. Ange siteId, listId och columnId. Brödtexten är partiell – inkludera endast de egenskaper som du vill ändra (till exempel displayName, beskrivning, dold, obligatorisk eller fasetteringsinställningar).

Obligatoriska parametrar

• siteId: Unikt ID för webbplatsen
• listId: Unikt ID för listan
• columnId: Unikt ID för kolumnen som ska uppdateras

Valfria parametrar

• displayName: Visningsnamn mot användare
• beskrivning: Kolumnbeskrivning
• dold: Om sant är kolumnen dold
• obligatoriskt: Om sant krävs ett värde
• enforceUniqueValues: Om sant måste värdena vara unika
• indexerad: Om sant indexeras värden
• readOnly: Om sant kan värden inte ändras
• text, tal, val, dateTime, personOrGroup, uppslag, hyperlänkOrPicture: Uppdatera kolumntypinställningar

sharepoint_getSiteByPath

Lös en SharePoint-webbplats med hjälp av dess värdnamn och serverrelativa sökväg.

Obligatoriska parametrar

• värdnamn: Värdnamn för SharePoint-klientorganisationen (till exempel contoso.sharepoint.com)
• serverRelativePath: Serverrelativ sökväg till platsen (till exempel webbplatser/marknadsföring)

sharepoint_listListColumns

Lista kolumndefinitioner (columnDefinition-resurser) för en specifik SharePoint-lista. Kräver siteId och listId. Stöder OData-paramer som $select, $top och $skiptoken.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• listId: Det unika ID:t för listan

Valfria parametrar

• select: Kommaavgränsad lista över egenskaper som ska returneras
• filter: OData-filteruttryck för att begränsa resultat
• orderBy: Kommaavgränsad lista över egenskaper som ska sorteras efter
• överst: Sidstorlek (1–999)
• skiptoken: Ogenomskinlig token för växling till nästa uppsättning

sharepoint_listListItems

Visa en lista över objekt från en SharePoint-lista.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• listId: Det unika ID:t för listan

Valfria parametrar

• expandera: Valfritt OData-expandera (till exempel fält)
• överst: Valfri sidstorlek
• filter: Valfritt OData-filteruttryck
• select: Valfri OData select-sats

sharepoint_listLists

Visa en lista över alla SharePoint-listor på en webbplats.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID

sharepoint_listSubsites

Visa en lista över underordnade webbplatser (underwebbplatser) för en viss webbplats.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID

sharepoint_search

Sök i SharePoint med hjälp av Microsoft Graph Search API med entityTypes=["site"].

Obligatoriska parametrar

• begäranden: Matris med searchRequest-objekt

Valfria parametrar

• entityTypes: Måste vara ["webbplats"] för SharePoint-webbplatssökningar
• fråga: Frågeobjekt med söksträng i KQL-stil
• från: Nollbaserad förskjutning av det första resultatet
• storlek: Antal resultat som ska returneras (1–50)
• fält: Valfri lista över fält som ska väljas i svaret

13. sharepoint_searchSitesByName

Sök på SharePoint-webbplatser efter visningsnamn eller partiell URL (naturligt språk).

Obligatoriska parametrar

• sök: Visningsnamn eller partiellt namn/URL för SharePoint-webbplatsen att söka efter

Valfria parametrar

• consistencyLevel: Krävs av Microsoft Graph (standard: eventual)

14. sharepoint_updateListItem

Uppdatera fält för ett befintligt listobjekt.

Obligatoriska parametrar

• siteId: Webbplatsens unika ID
• listId: Det unika ID:t för listan
• itemId: Listobjektets unika ID
• fält: Fältvärden som ska uppdateras (partiella)

Valfria parametrar

• ifMatch: Valfri ETag för samtidighetskontroll (till exempel "*" att framtvinga)

Huvudfunktioner

Listhantering

• Skapa nya SharePoint-listor med mallar
• Visa en lista över alla listor på en webbplats
• Stöd för olika listmallar (genericList, documentLibrary, issueTracking)

Kolumn C – Åtgärder

• Skapa kolumner med flera datatyper (text, nummer, val, dateTime, personOrGroup, uppslag, boolesk, hyperlänkOrPicture)
• Redigera befintliga kolumner
• Radera kolumner
• Visa en lista över alla kolumner i en lista
• Begränsningar för kolumnverifiering och unikhet

Objektåtgärder

• Skapa listobjekt med fältvärden
• Uppdatera befintliga listobjekt (partiella uppdateringar)
• Ta bort ett objekt från en lista.
• Visa en lista över objekt med filtrering och sidnumrering
• Samtidighetskontroll via ETag

Webbplatsidentifiering

• Sök webbplatser efter namn eller URL
• Lösa webbplatser efter värdnamn och sökväg
• Lista underwebbplatser
• KQL-stilsökning med Microsoft Graph Search API

Stöd för OData-frågor

• Använd $select för att välja egenskaper.
• Använd $filter för att filtrera resultat.
• Använd $expand för att inkludera relaterade entiteter.
• Använd $orderby för att sortera resultat.
• Använd $top för sidnumrering.
• Använd $skiptoken för att bläddra igenom stora resultatuppsättningar.

Stöd för kolumntyp

• Textkolumner (enkelrads- eller flerradskolumner, oformaterad eller RTF).
• Talkolumner (med decimaler, lägsta och högsta värden).
• Alternativkolumner (kryssrutor, listrutor eller alternativknappar).
• Booleska kolumner.
• Datum/tid, Datum och tid, Endast datum
• Person- eller gruppkolumner (en eller flera val).
• Uppslagskolumner (referera till andra listor).
• Hyperlänkar eller bildkolumner.

Anteckningar

1. Alla åtgärder använder Microsoft Graph API v1.0.
2. Kolumnnamn måste vara 1–64 tecken utan blanksteg.
3. Varje kolumn måste ange exakt en kolumntyp.
4. Samtidighetskontroll är tillgänglig via If-Match rubriken.
5. Webbplatssökningar kräver consistencyLevel inställt på eventual.
6. Sökresultaten är begränsade till 50 objekt per sida.
7. Partiella uppdateringar stöds för kolumner och listobjekt.