Referanse for Microsoft SharePoint og OneDrive MCP Server

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_ODSPRemoteServer	SharePoint og OneDrive Microsoft 365	MCP-serveren tilbyr verktøy for å arbeide med SharePoint- og OneDrive-innhold. Denne serveren kobler til den leierspesifikke SharePoint Online MCP-serveren. Den oppdager og gjør det automatisk tilgjengelig alle verktøy som støtter Integrering av OneDrive- og SharePoint-filer som eksponeres av ODSP MCP-endepunktet.

Tilgjengelige verktøy

createFolder

Oppretter en ny mappe i et angitt dokumentbibliotek som underordnet den angitte overordnede mappen. Hvis du ikke angir et dokumentbibliotek, bruker serveren brukerens OneDrive. Hvis du ikke angir en overordnet mappe, oppretter serveren mappen ved roten. Hvis det allerede finnes en mappe med samme navn, oppretter serveren den nye mappen med et numerisk suffiks, for eksempel NewFolder (1).

Påkrevde parametere

• folderName(string) – navnet på mappen som skal opprettes. Hvis det allerede finnes en mappe med samme navn, legger serveren til et numerisk suffiks i det nye mappenavnet, for eksempel NewFolder (1).
• documentLibraryId(string) – ID for dokumentbiblioteket (også kalt en stasjon) der du vil opprette mappen. Hvis du vil opprette en mappe på brukerens stasjon eller OneDrive, for eksempel «min stasjon» eller «min onedrive», kan du sende "me" som documentLibraryId.

Valgfrie parametere

• parentFolderId(string, default = "root") – ID for den overordnede mappen der den nye mappen skal opprettes. Brukes som standard roten til dokumentbiblioteket hvis det ikke er angitt.

findSite

Finner SharePoint-områder som brukeren har tilgang til. Dette verktøyet kan enten finne et bestemt nettsted basert på en søkespørring du angir, eller finne de 20 mest relevante nettstedene som er tilgjengelige for brukeren hvis du ikke angir en søkespørring.

Påkrevde parametere

Ingen

Valgfrie parametere

• searchQuery(streng, standard = null) – søkespørring som kan være hele eller deler av områdenavnet. Hvis du gir en søkespørring, kan du effektivt søke etter et nettsted, men bare hvis brukeren leter etter et bestemt nettsted. Hvis brukeren for eksempel ber om et område kalt xyz, vil du sende xyz som searchQuery. Hvis brukeren bare ber om «mine områder», lar du denne parameteren stå tom.

listDocumentLibrariesInSite

Viser dokumentbiblioteker (også kalt stasjoner) på det angitte SharePoint-området. Hvis du ikke angir et område, bruker serveren rotområdet.

Påkrevde parametere

Ingen

Valgfrie parametere

• siteId: Område-ID (standard: rot)

findFileOrFolder

Finner en fil eller en mappe (også kalt en DriveItem) som brukeren har tilgang til ved å sende en søkespørring.

Påkrevde parametere

• searchQuery: Søkespørring som kan være hele eller deler av filnavnet

renameFileOrFolder

Gi nytt navn til en fil eller mappe (også kalt DriveItems) i det angitte dokumentbiblioteket. Obs! Det nye navnet må være i samsvar med navnekonvensjoner.

Påkrevde parametere

• documentLibraryId: Dokumentbibliotek-ID (streng)
• fileOrFolderId: Fil- eller mappe-ID (streng)
• newFileOrFolderName: Nytt navn for filen eller mappen (streng)

deleteFileOrFolder

Slette en fil eller en mappe fra det angitte dokumentbiblioteket.

Påkrevde parametere

• documentLibraryId: Dokumentbibliotek-ID (streng)
• fileOrFolderId: Fil- eller mappe-ID (streng)

readSmallTextFile

Les (last ned) en tekstfil fra et bestemt dokumentbibliotek. Hvis du ikke angir et dokumentbibliotek, brukes brukerens OneDrive. Du må oppgi en fileId (driveItemId for en fil) for å identifisere og laste ned filen.

Påkrevde parametere

• fileId(streng)
• documentLibraryId(string) – ID for dokumentbiblioteket (også kalt en stasjon) for filen du vil lese. Hvis brukeren ber deg om å lese eller laste ned en fil i stasjonen eller Onedrive for eksempel - Les en fil i "min stasjon", les en fil i "min onedrive" du bør sende i "meg" som documentLibraryId.

moveSmallFile

Flytt en fil i det angitte dokumentbiblioteket til en annen mappe. Dette verktøyet støtter bare flytting for filer mindre enn 5 MB og flyttinger som er innenfor samme område. Du kan ikke flytte filer mellom Stasjoner ved hjelp av denne forespørselen.

Påkrevde parametere

• documentLibraryId(string) – ID-en til dokumentbiblioteket (også kalt en stasjon) for filen du vil flytte. Hvis brukeren ber deg om å flytte en fil i stasjonen eller Onedrive for eksempel – flytt en fil i «min stasjon», flytter du en fil i «min onedrive» du bør sende inn «meg» som dokumentlibraryId.
• fileId(string) – ID for filen som skal flyttes
• newParentFolderId(string) – ID-en til målmappen du vil flytte filen til. Skal være i samme dokumentbibliotek som den opprinnelige plasseringen av filen.

getFileOrFolderMetadata

Få metadata for en fil eller en mappe fra det angitte dokumentbiblioteket på et SharePoint-område.

Påkrevde parametere

• FileOrFolderId(string) – ID for en fil eller mappe. De kalles også DriveItems. Og ID-en kan også noen ganger kalles en driveItemId.
• documentLibraryId(string) – ID for dokumentbiblioteket (også kalt en stasjon) for filen eller mappen du trenger metadataene til. Hvis brukeren ber deg om å få en fil eller mappe i stasjonen eller Onedrive for eksempel – «Hent metadata for en fil i stasjonen min» eller «Hent metadata for en mappe i min onedrive», bør du sende inn «meg» som documentLibraryId.

createSmallTextFile

Opprett eller last opp en tekstfil som er mindre enn 5 MB, til et bestemt dokumentbibliotek. Hvis du ikke angir et dokumentbibliotek, brukes brukerens OneDrive. Du kan laste opp filen til en bestemt mappe. Hvis du ikke angir en mappe, lastes filen opp til rotmappen.

Påkrevde parametere

• filnavn (streng) – navnet på filen som skal opprettes
• contentText (streng) – tekstinnhold i filen som skal opprettes
• documentLibraryId (streng) – ID for dokumentbiblioteket (også kalt en stasjon) for filen. Hvis en bruker ber deg om å opprette en fil i stasjonen eller OneDrive, for eksempel «opprette en fil i stasjonen min» eller «opprette en fil i min onedrive», sender du «meg» som dokumentlibraryId.

Valgfrie parametere

• parentfolderId(string, default = "root") – mappe-ID i stasjonen for å legge til den nye filen.

getFileOrFolderMetadataByUrl

Få metadata for en fil eller mappe fra en url-adresse for deling. Bare brukere med eksplisitte tillatelser til å få tilgang til filen kan få metadataene.

Påkrevde parametere

• fileOrFolderUrl:(string) – URL-adressen til filen eller mappen (også kalt DriveItems). Url-adressen er ikke løst inn for å dele den med brukeren. de må allerede ha eksplisitt tilgang til filen.

shareFileOrFolder

Send en delingsinvitasjon for å gi tillatelser til en fil eller mappe i et angitt dokumentbibliotek. Støtter tilordning av roller og varsler mottakere.

Påkrevde parametere

• documentLibraryId: Dokumentbibliotek-ID (streng, obligatorisk)
• fileOrFolderId: Fil- eller mappe-ID (streng, obligatorisk)
• recipientEmails:(string[], Required) – e-postadresser til mottakere som skal inviteres. Minst én mottaker-e-post kreves.

Valgfrie parametere

• roles(string[]) – roller som skal tilordnes mottakere. Godtatte verdier: lese, skrive (skrive gir både lese- og skrivetilgang). Standarder for leserolle hvis det ikke er angitt.
• sendInvitation(bool, default = true) – angir om en delingsinvitasjon skal sendes. Standardverdien er sann hvis den ikke er angitt.
• message(string, default = "Here's the file we're collaborating on.") – Egendefinert melding som skal inkluderes i invitasjons-e-postmeldingen. Standarder til en standardmelding hvis den ikke er angitt.

getFolderChildren

Nummererer de 20 mest populære filene og mappene i en angitt overordnet mappe i et dokumentbibliotek. Hvis du ikke angir et dokumentbibliotek, brukes brukerens OneDrive.

Påkrevde parametere

• documentLibraryId(string) – ID for dokumentbiblioteket (også kalt en stasjon) for den overordnede mappen. Hvis en bruker ber deg om å få filer i en mappe i stasjonen eller OneDrive, for eksempel «hente filer i en mappe i stasjonen min» eller «hente filer i en mappe i min onedrive», sender du «meg» som dokumentlibraryId.

Valgfrie parametere

• parentFolderId:(string, default = "root") – ID for den overordnede mappen (DriveItem) med filer og mapper oppført. Standarder til rotmappen i dokumentbiblioteket hvis det ikke er angitt.

Ekko

Sender meldingen tilbake til klienten.

Påkrevde parametere

• melding: Melding som skal sendes tilbake

setSensitivityLabelOnFile

Angi følsomhetsetiketten for en fil fra det angitte dokumentbiblioteket.

Påkrevde parametere

• documentLibraryId(string) – dokumentbibliotek-ID-en, også kjent som driveId, i dokumentbiblioteket
• fileId(string) – fil-ID-en, også kjent som driveItemId, for filen
• sensitivityLabelId(string) – obligatorisk. ID for følsomhetsetiketten som skal tilordnes, eller tom streng for å fjerne følsomhetsetiketten.

Valgfrie parametere

• assignmentMethod(string, default = "privileged") – tildelingsmetoden for etiketten i dokumentet. Angir om tilordningen av etiketten ble utført automatisk, standard eller som en privilegert operasjon (tilsvarende en administratoroperasjon). Mulige verdier er standardverdier, privilegerte, automatiske og ukjenteFutureValue.
• justificationText(string, default = "Changed by MCPServer") – valgfritt. Justeringstekst for overvåkingsformål, og kreves når du nedgraderer eller fjerner en etikett.

getDefaultDocumentLibraryInSite

Få standard dokumentbibliotek (også kalt Stasjon) på et SharePoint-område. Hvis du ikke angir et område, brukes rotområdet.

Påkrevde parametere

Ingen

Valgfrie parametere

• siteId: Område-ID (standard: rot)

Nøkkelfunksjoner

Mappebehandling

• Opprette mapper med automatisk løsning på navngivning av konflikt
• Nummerer underordnede mapper (topp 20)
• Flytte filer mellom mapper (innenfor samme område)

Salgsoperasjoner

• Opprette og laste opp små tekstfiler (< 5 MB)
• Lese og laste ned tekstfiler
• Gi nytt navn til filer og mapper
• Slette filer og mapper
• Hent fil- og mappemetadata etter ID eller URL-adresse

Område- og bibliotekoppdagelse

• Søk etter SharePoint-områder etter søkespørring
• Vise dokumentbiblioteker på et område
• Få standard dokumentbibliotek

Deling og tillatelser

• Dele filer og mapper med rolletilordninger
• Sende delingsinvitasjoner med egendefinerte meldinger
• Tilgangskontroll via eksplisitte tillatelser

Sikkerhet og etterlevelse

• Angi følsomhetsetiketter på filer
• Støtte for privilegerte, standard- og automatiske tildelingsmetoder
• Justeringstekst for samsvarsrevisjon

Integrering

• Støtte for OneDrive og SharePoint Online
• Leierspesifikk servertilkobling
• DriveItem-abstraksjon for filer og mapper

Notater

1. Standard dokumentbibliotek er meg (brukerens OneDrive)
2. Standard overordnet mappe er rot
3. Mappenavnkonflikter løst med numeriske suffikser
4. Filen flyttes begrenset til mindre enn 5 MB og innenfor samme område
5. Deling av URL-adresser krever eksplisitte tilgangstillatelser
6. DriveItems representerer både filer og mapper
7. Øvre 20 grense for opplisting av underordnede mapper