Referanse for MCP-server for SharePoint-listerverktøy

Viktig!

Du må være en del av frontier-forhåndsvisningsprogrammet for å få tidlig tilgang til Microsoft Agent 365. Frontier kobler deg direkte til Microsofts nyeste ai-innovasjoner. Grenseforhåndsvisninger er underlagt de eksisterende forhåndsvisningsvilkårene i kundeavtalene dine. Ettersom disse funksjonene fremdeles er under utvikling, kan tilgjengeligheten og funksjonene endres over tid.

Oversikt

Server-ID	Display name	Description
mcp_SharePointListsTools	Microsoft SharePoint Viser MCP Server	MCP-server som inneholder Microsoft Graph SharePoint-verktøy for lister. MCP-server som inneholder Microsoft Graph SharePoint-verktøy for lister.

Tilgjengelige verktøy

sharepoint_createList

Opprett en ny SharePoint-liste på et område.

Obligatoriske parametere

• siteId: Den unike ID-en for området
• displayName: Visningsnavn for listen
• liste: Listeinformasjon, for eksempel mal (for eksempel genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Opprett en ny kolonne (columnDefinition) i en bestemt SharePoint-liste. Du må angi målområde-ID og listId, pluss en gyldig kolonnedefinisjon som angir kolonnens navn, visningsnavn og nøyaktig én kolonnetype (for eksempel tekst, tall, valg, dateTime, personOrGroup, oppslag, boolsk eller hyperlinkOrPicture).

Påkrevde parametere

• siteId: Den unike ID-en for området
• listId: Den unike ID-en for listen
• navn: API/statisk navn på kolonnen (ingen mellomrom, 1-64 tegn)

Valgfrie parametere

• displayName: Visningsnavn for bruker
• beskrivelse: Kolonnebeskrivelse
• enforceUniqueValues: Hvis sann, må verdiene være unike
• skjult: Hvis sann, er kolonnen skjult
• indeksert: Hvis sann, indekseres verdier
• obligatorisk: Hvis sann, kreves en verdi
• readOnly: Hvis sann, verdier kan ikke endres
• tekst, tall, valg, boolsk, dateTime, personOrGroup, oppslag, hyperlinkOrPicture: Innstillinger for kolonnetype (én obligatorisk)

sharepoint_createListItem

Opprett et nytt element i en SharePoint-liste.

Påkrevde parametere

• siteId: Den unike ID-en for området
• listId: Den unike ID-en for listen
• felt: Feltverdier for listeelementet (nøkkel/verditilordning)

sharepoint_deleteListColumn

Slett en eksisterende columnDefinition fra en bestemt SharePoint-liste. Angi siteId, listId og columnId. Denne handlingen fjerner kolonnen permanent fra listeskjemaet.

Påkrevde parametere

• siteId: Unik ID for området
• listId: Unik ID for listen
• columnId: Unik ID for kolonnen som skal slettes

sharepoint_deleteListItem

Slett et listeelement.

Påkrevde parametere

• siteId: Den unike ID-en for området
• listId: Den unike ID-en for listen
• itemId: Den unike ID-en for listeelementet

Valgfrie parametere

• ifMatch: Valgfri ETag for samtidighetskontroll (for eksempel «*»)

sharepoint_editListColumn

Oppdater en eksisterende columnDefinition på en bestemt SharePoint-liste. Angi siteId, listId og columnId. Brødteksten er delvis – inkluder bare egenskapene du vil endre (for eksempel visningsnavn, beskrivelse, skjulte, obligatoriske eller fasettinnstillinger).

Påkrevde parametere

• siteId: Unik ID for området
• listId: Unik ID for listen
• columnId: Unik ID for kolonnen som skal oppdateres

Valgfrie parametere

• displayName: Visningsnavn for bruker
• beskrivelse: Kolonnebeskrivelse
• skjult: Hvis sann, er kolonnen skjult
• obligatorisk: Hvis sann, kreves en verdi
• enforceUniqueValues: Hvis sann, må verdiene være unike
• indeksert: Hvis sann, indekseres verdier
• readOnly: Hvis sann, verdier kan ikke endres
• tekst, tall, valg, dateTime, personOrGroup, oppslag, hyperlinkOrPicture: Oppdater innstillinger for kolonnetype

sharepoint_getSiteByPath

Løs et SharePoint-område ved hjelp av vertsnavnet og den relative serverbanen.

Påkrevde parametere

• vertsnavn: Vertsnavn for SharePoint-leieren (for eksempel contoso.sharepoint.com)
• serverRelativePath: Serverrelativ bane til området (for eksempel områder/markedsføring)

sharepoint_listListColumns

Listekolonnedefinisjoner (columnDefinition-ressurser) for en bestemt SharePoint-liste. Krever siteId og listId. Støtter OData-analyser som $select, $top og $skiptoken.

Påkrevde parametere

• siteId: Den unike ID-en for området
• listId: Den unike ID-en for listen

Valgfrie parametere

• velg: Kommadelt liste over egenskaper som skal returneres
• filter: OData-filteruttrykk for å begrense resultatene
• orderBy: Kommadelt liste over egenskaper som skal bestilles etter
• øverst: Sidestørrelse (1-999)
• skiptoken: Ugjennomsiktig token for sideveksling til neste sett

sharepoint_listListItems

Listeelementer fra en SharePoint-liste.

Påkrevde parametere

• siteId: Den unike ID-en for området
• listId: Den unike ID-en for listen

Valgfrie parametere

• utvid: Valgfri OData-utvidelse (for eksempel felt)
• øverst: Valgfri sidestørrelse
• filter: Valgfritt OData-filteruttrykk
• velg: Valgfri OData-valgsetning

sharepoint_listLists

Vis alle SharePoint-lister på et område.

Påkrevde parametere

• siteId: Den unike ID-en for området

sharepoint_listSubsites

Vis underordnede områder (sekundære områder) for et gitt område.

Påkrevde parametere

• siteId: Den unike ID-en for området

sharepoint_search

Søk i SharePoint ved hjelp av Microsoft Graph Search API med entityTypes=["site"].

Påkrevde parametere

• forespørsler: Matrise av searchRequest-objekter

Valgfrie parametere

• entityTypes: Må være ["område"] for SharePoint-områdesøk
• spørring: Spørringsobjekt med søkestreng i KQL-stil
• fra: Nullbasert forskyvning av det første resultatet
• størrelse: Antall resultater som skal returneres (1–50)
• felt: Valgfri liste over felt som skal velges i svaret

13. sharepoint_searchSitesByName

Søk i SharePoint-områder etter visningsnavn eller delvis URL-adresse (naturlig språk).

Påkrevde parametere

• søk: Visningsnavn eller delvis navn/URL-adresse for SharePoint-området du vil søke etter

Valgfrie parametere

• consistencyLevel: Obligatorisk av Microsoft Graph (standard: eventuelt)

14. sharepoint_updateListItem

Oppdater felt for et eksisterende listeelement.

Påkrevde parametere

• siteId: Den unike ID-en for området
• listId: Den unike ID-en for listen
• itemId: Den unike ID-en for listeelementet
• felt: Feltverdier som skal oppdateres (delvis)

Valgfrie parametere

• ifMatch: Valgfri ETag for samtidighetskontroll (for eksempel «*» for å tvinge)

Nøkkelfunksjoner

Listebehandling

• Opprette nye SharePoint-lister med maler
• Vis alle lister på et område
• Støtte for ulike listemaler (genericList, documentLibrary, issueTracking)

Kolonne C – Operasjoner

• Opprette kolonner med flere datatyper (tekst, tall, valg, dateTime, personOrGroup, oppslag, boolsk, hyperlinkOrPicture)
• Rediger eksisterende kolonner
• Slette kolonner
• Vis alle kolonner i en liste
• Begrensninger for kolonnevalidering og unikhet

Elementoperasjoner

• Opprette listeelementer med feltverdier
• Oppdater eksisterende listeelementer (delvise oppdateringer)
• Slett et listeelement.
• Listeelementer med filtrering og paginering
• Samtidighetskontroll via ETag

Områdeoppdagelse

• Søke områder etter navn eller URL-adresse
• Løse områder etter vertsnavn og bane
• Liste sekundære områder
• KQL-stilsøk med Microsoft Graph Search API

Støtte for OData-spørring

• Bruk $select til å velge egenskaper.
• Bruk $filter til å filtrere resultater.
• Bruk $expand til å inkludere relaterte enheter.
• Bruk $orderby til å sortere resultater.
• Bruk $top for paginering.
• Bruk $skiptoken til å bla gjennom store resultatsett.

Støtte for kolonnetype

• Tekstkolonner (enkel linje eller flerlinjet, ren eller rik tekst).
• Tallkolonner (med desimaler, minimumsverdier og maksimumsverdier).
• Valgkolonner (avmerkingsbokser, rullegardinmeny eller alternativknapper).
• Boolske kolonner.
• Dato/klokkeslett, Dato og klokkeslett, Bare dato
• Person- eller gruppekolonner (enkelt eller flere merkede områder).
• Oppslagskolonner (referer til andre lister).
• Hyperkoblings- eller bildekolonner.

Notater

1. Alle operasjoner bruker Microsoft Graph API v1.0.
2. Kolonnenavn må være 1-64 tegn uten mellomrom.
3. Hver kolonne må angi nøyaktig én kolonnetype.
4. Samtidighetskontroll er tilgjengelig via toppteksten If-Match .
5. Områdesøk krever consistencyLevel satt til eventual.
6. Søkeresultatene er begrenset til 50 elementer per side.
7. Delvise oppdateringer støttes for kolonner og listeelementer.