Del via


MCP-serverreference til SharePoint-listeværktøjer

Vigtigt

Du skal være en del af Frontier-forhåndsversionsprogrammet for at få tidlig adgang til Microsoft Agent 365. Frontier forbinder dig direkte med Microsofts seneste AI-innovationer. Frontier-forhåndsversioner er underlagt de eksisterende forhåndsversionsbetingelser i dine kundeaftaler. Da disse funktioner stadig er under udvikling, kan deres tilgængelighed og egenskaber ændre sig over tid.

Oversigt

Server-id Vist navn Beskrivelse
mcp_SharePointListsTools MCP-server til Microsoft SharePoint-lister MCP-server, der leverer Microsoft Graph SharePoint-værktøjer til lister. MCP-server, der leverer Microsoft Graph SharePoint-værktøjer til lister.

Tilgængelige værktøjer

sharepoint_createList

Opret en ny SharePoint-liste på et websted.

Påkrævede parametre

  • siteId: Webstedets entydige id
  • displayName: Vist navn på listen
  • liste: Listeoplysninger som f.eks. skabelon (f.eks. genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Opret en ny kolonne (columnDefinition) på en bestemt SharePoint-liste. Du skal angive mål-siteId og listId samt en gyldig kolonnedefinition, der angiver kolonnens navn, viste navn og præcis én kolonnetype (f.eks. tekst, tal, valg, dateTime, personOrGroup, opslag, boolesk eller hyperlinkOrPicture).

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen
  • navn: API/statisk navn på kolonnen (ingen mellemrum, 1-64 tegn)

Valgfrie parametre:

  • displayName: Brugervendt vist navn
  • beskrivelse: Kolonnebeskrivelse
  • enforceUniqueValues: Hvis sand, skal værdierne være entydige
  • skjult: Hvis sand, er kolonnen skjult
  • indekseret: Hvis sand, indekseres værdier
  • påkrævet: Hvis sand, kræves der en værdi
  • readOnly: Hvis sand, kan værdier ikke ændres
  • tekst, tal, valg, boolesk, dateTime, personOrGroup, opslag, hyperlinkOrPicture: Indstillinger for kolonnetype (én påkrævet)

sharepoint_createListItem

Opret et nyt element på en SharePoint-liste.

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen
  • felter: Feltværdier for listeelementet (nøgle/værditilknytning)

sharepoint_deleteListColumn

Slet en eksisterende columnDefinition fra en bestemt SharePoint-liste. Angiv siteId, listId og columnId. Denne handling fjerner kolonnen permanent fra listeskemaet.

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen
  • columnId: Entydigt id for den kolonne, der skal slettes

sharepoint_deleteListItem

Slette et listeelement.

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen
  • itemId: Det entydige id for listeelementet

Valgfrie parametre:

  • ifMatch: Valgfri ETag til samtidighedskontrol (f.eks. "*")

sharepoint_editListColumn

Opdater en eksisterende columnDefinition på en bestemt SharePoint-liste. Angiv siteId, listId og columnId. Brødteksten er delvis – Medtag kun de egenskaber, du vil ændre (f.eks displayName, beskrivelse, skjult, påkrævet eller facetindstillinger).

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen
  • columnId: Entydigt id for den kolonne, der skal opdateres

Valgfrie parametre:

  • displayName: Brugervendt vist navn
  • beskrivelse: Kolonnebeskrivelse
  • skjult: Hvis sand, er kolonnen skjult
  • påkrævet: Hvis sand, kræves der en værdi
  • enforceUniqueValues: Hvis sand, skal værdierne være entydige
  • indekseret: Hvis sand, indekseres værdier
  • readOnly: Hvis sand, kan værdier ikke ændres
  • tekst, tal, valg, boolesk, dateTime, personOrGroup, opslag, hyperlinkOrPicture: Opdater indstillinger for kolonnetype

sharepoint_getSiteByPath

Løs et SharePoint-websted ved hjælp af værtsnavnet og den serverrelative sti.

Påkrævede parametre:

  • værtsnavn: Værtsnavn på SharePoint-lejeren (f.eks. contoso.sharepoint.com)
  • serverRelativePath: Serverrelativ sti til webstedet (f.eks. websteder/marketing)

sharepoint_listListColumns

Listekolonnedefinitioner (columnDefinition-ressourcer) for en bestemt SharePoint-liste. Kræver siteId og listId. Understøtter OData-parametre som $select, $top og $skiptoken.

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen

Valgfrie parametre:

  • vælg: Kommasepareret liste over brugeregenskaber, der skal returneres
  • filter: OData-filterudtryk for at begrænse resultater
  • orderBy: Kommasepareret liste over egenskaber, der skal sorteres efter
  • top: Sidestørrelse (1-999)
  • skiptoken: Uigennemsigtigt token til sideinddeling til det næste sæt

sharepoint_listListItems

Vis elementer fra en SharePoint-liste.

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen

Valgfrie parametre:

  • udvid: Valgfri OData-udvidelse (f.eks. felter)
  • top: Valgfri sidestørrelse
  • filter: Valgfrit OData-filterudtryk
  • select: Valgfri OData select-delsætning

sharepoint_listLists

Vis alle SharePoint-lister på et websted.

Påkrævede parametre:

  • siteId: Webstedets entydige id

sharepoint_listSubsites

Vis underordnede websteder (underordnede websteder) til et givet websted.

Påkrævede parametre:

  • siteId: Webstedets entydige id

Søg i SharePoint ved hjælp af Microsoft Graph Search API med entityTypes=["websted"].

Påkrævede parametre:

  • anmodninger: Matrix af searchRequest-objekter

Valgfrie parametre:

  • entityTypes: Skal være ["websted"] for SharePoint-webstedssøgninger
  • forespørgsel: Forespørgselsobjekt med søgestreng i KQL-stil
  • fra: Nulbaseret forskydning af det første resultat
  • størrelse: Antal resultater, der skal returneres (1-50)
  • felter: Valgfri liste over felter, der skal vælges i svaret

13. sharepoint_searchSitesByName

Søg på SharePoint-websteder efter vist navn eller delvis URL-adresse (naturligt sprog).

Påkrævede parametre:

  • søg: Vist navn eller delvist navn/URL-adresse på det SharePoint-websted, der skal søges efter

Valgfrie parametre:

  • consistencyLevel: Påkrævet af Microsoft Graph (standard: endelig)

14. sharepoint_updateListItem

Opdater felter for et eksisterende listeelement.

Påkrævede parametre:

  • siteId: Webstedets entydige id
  • listId: Det entydige id for listen
  • itemId: Det entydige id for listeelementet
  • felter: Feltværdier, der skal opdateres (delvis)

Valgfrie parametre:

  • ifMatch: ValgfriT ETag til samtidighedskontrol (f.eks. "*" for at gennemtvinge)

Nøglefunktioner

Administration af lister

  • Opret nye SharePoint-lister med skabeloner
  • Vis alle lister på et websted
  • Understøttelse af forskellige listeskabeloner (genericList, documentLibrary, issueTracking)

Kolonnehandlinger

  • Opret kolonner med flere datatyper (tekst, tal, valg, dateTime, personOrGroup, opslag, boolesk, hyperlinkOrPicture)
  • Rediger eksisterende kolonner
  • Slette kolonner
  • Vis alle kolonner på en liste
  • Begrænsninger for kolonnevalidering og entydighed

Elementhandlinger

  • Opret listeelementer med feltværdier
  • Opdater eksisterende listeelementer (delvise opdateringer)
  • Slette listeelementer
  • Vis elementer med filtrering og sideinddeling
  • Samtidighedskontrol via ETag

Registrering af websted

  • Søg på websteder efter navn eller URL-adresse
  • Løs websteder efter værtsnavn og sti
  • Vis underordnede websteder
  • KQL-formatsøgning med Microsoft Graph Search API

Understøttelse af OData-forespørgsler

  • Brug $select til at vælge egenskaber.
  • Brug $filter til at filtrere resultater.
  • Brug $expand til at inkludere relaterede objekter.
  • Brug $orderby til at sortere resultater.
  • Brug $top til sideinddeling.
  • Brug $skiptoken til at bladre gennem store resultatsæt.

Understøttelse af kolonnetype

  • Tekstkolonner (enkeltlinje eller flere linjer, almindelig tekst eller RTF).
  • Talkolonner (med decimaler, minimum- og maksimumværdier).
  • Valgkolonner (afkrydsningsfelter, rullemenuer eller alternativknapper).
  • Booleske kolonner.
  • DateTime-kolonner (kun dato eller dato og klokkeslæt).
  • Person- eller gruppekolonner (enkelt eller flere markeringer).
  • Opslagskolonner (reference til andre lister).
  • Kolonnerne Link eller Billede.

Bemærkninger

  1. Alle handlinger bruger Microsoft Graph API v1.0.
  2. Kolonnenavne skal være på 1-64 tegn uden mellemrum.
  3. Hver kolonne skal angive præcis én kolonnetype.
  4. Samtidighedskontrol er tilgængelig via If-Match headeren.
  5. Webstedssøgninger kræver, at consistencyLevel er angivet til eventual.
  6. Søgeresultaterne er begrænset til 50 elementer pr. side.
  7. Delvise opdateringer understøttes for kolonner og listeelementer.