Αναφορά Microsoft SharePoint και OneDrive MCP Server

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Επισκόπηση

Αναγνωριστικό διακομιστή	Εμφανιζόμενο όνομα	Περιγραφή
mcp_ODSPRemoteServer	Το SharePoint και το OneDrive στο Microsoft 365	Διακομιστής MCP που παρέχει εργαλεία για την εργασία με το περιεχόμενό σας SharePoint και OneDrive. Αυτός ο διακομιστής συνδέεται με τον διακομιστή SHAREPoint Online MCP που αφορά συγκεκριμένο μισθωτή. Εντοπίζει αυτόματα και καθιστά διαθέσιμα όλα τα εργαλεία που υποστηρίζουν ενοποίηση αρχείων OneDrive και SharePoint, τα οποία εκτίθενται από το τελικό σημείο ODSP MCP.

Διαθέσιμα εργαλεία

createFolder

Δημιουργεί έναν νέο φάκελο μέσα σε μια καθορισμένη βιβλιοθήκη εγγράφων ως θυγατρικό στοιχείο του καθορισμένου γονικού φακέλου. Εάν δεν καθορίσετε μια βιβλιοθήκη εγγράφων, ο διακομιστής χρησιμοποιεί το OneDrive του χρήστη. Εάν δεν καθορίσετε έναν γονικό φάκελο, ο διακομιστής δημιουργεί τον φάκελο στη ρίζα. Εάν υπάρχει ήδη ένας φάκελος με το ίδιο όνομα, ο διακομιστής δημιουργεί τον νέο φάκελο με ένα αριθμητικό επίθημα, όπως NewFolder (1).

Απαιτούμενες παράμετροι

• folderName(συμβολοσειρά) – Το όνομα του φακέλου που θα δημιουργήσετε. Εάν υπάρχει ήδη ένας φάκελος με το ίδιο όνομα, ο διακομιστής προσθέτει ένα αριθμητικό επίθημα στο νέο όνομα φακέλου, όπως NewFolder (1).
• documentLibraryId(συμβολοσειρά) – Αναγνωριστικό της βιβλιοθήκης εγγράφων (που ονομάζεται επίσης μονάδα δίσκου) όπου θέλετε να δημιουργήσετε τον φάκελο. Εάν θέλετε να δημιουργήσετε έναν φάκελο στη μονάδα δίσκου του χρήστη ή στο OneDrive, όπως "η μονάδα δίσκου μου" ή "το onedrive μου", στείλτε "me" το documentLibraryIdως .

Προαιρετικές παράμετροι

• parentFolderId(string, default = "root") – Αναγνωριστικό του γονικού φακέλου στον οποίο θα δημιουργηθεί ο νέος φάκελος. Η προεπιλεγμένη τιμή είναι η ρίζα της βιβλιοθήκης εγγράφων, εάν δεν έχει καθοριστεί.

εύρεση Τοποθεσίας

Βρίσκει τοποθεσίες του SharePoint στις οποίες μπορεί να έχει πρόσβαση ο χρήστης. Αυτό το εργαλείο μπορεί είτε να βρει μια συγκεκριμένη τοποθεσία βάσει ενός ερωτήματος αναζήτησης που παρέχετε, είτε να βρει τις 20 κορυφαίες σχετικές τοποθεσίες που είναι προσβάσιμες από τον χρήστη, εάν δεν παρέχετε ένα ερώτημα αναζήτησης.

Απαιτούμενες παράμετροι

Κανένα

Προαιρετικές παράμετροι

• searchQuery(string, default = null) – Ερώτημα αναζήτησης που μπορεί να είναι ολόκληρο ή μερικό όνομα τοποθεσίας. Η παροχή ενός ερωτήματος αναζήτησης βοηθά στην αποτελεσματική αναζήτηση για μια τοποθεσία, αλλά μόνο εάν ο χρήστης αναζητά μια συγκεκριμένη τοποθεσία. Για παράδειγμα, εάν ο χρήστης ζητήσει μια τοποθεσία που ονομάζεται xyz, θα μεταβιβάσετε xyz ως .searchQuery Εάν ο χρήστης απλώς ζητήσει "οι τοποθεσίες μου", αφήστε αυτή την παράμετρο κενή.

listDocumentLibrariesInSite

Παραθέτει τις βιβλιοθήκες εγγράφων (που ονομάζονται επίσης μονάδες δίσκου) στην καθορισμένη τοποθεσία Του SharePoint. Εάν δεν καθορίσετε μια τοποθεσία, ο διακομιστής χρησιμοποιεί την τοποθεσία ρίζας.

Απαιτούμενες παράμετροι

Κανένα

Προαιρετικές παράμετροι

• siteId: Αναγνωριστικό τοποθεσίας (προεπιλογή: ρίζα)

findFileOrFolder

Εντοπίζει ένα αρχείο ή έναν φάκελο (που ονομάζεται επίσης DriveItem) στον οποίο μπορεί να αποκτήσει πρόσβαση ο χρήστης διαβιβάζοντας ένα ερώτημα αναζήτησης.

Απαιτούμενες παράμετροι

• searchQuery: Ερώτημα αναζήτησης που μπορεί να είναι ολόκληρο ή μερικό όνομα αρχείου

renameFileOrFolder

Μετονομάστε ένα αρχείο ή φάκελο (γνωστό και ως DriveItems) μέσα στην καθορισμένη βιβλιοθήκη εγγράφων. Σημείωση: Το νέο όνομα πρέπει να συμμορφώνεται με τους κανόνες ονομασίας.

Απαιτούμενες παράμετροι

• documentLibraryId: Αναγνωριστικό βιβλιοθήκης εγγράφων (συμβολοσειρά)
• fileOrFolderId: Αναγνωριστικό αρχείου ή φακέλου (συμβολοσειρά)
• newFileOrFolderName: Νέο όνομα για το αρχείο ή τον φάκελο (συμβολοσειρά)

deleteFileOrFolder

Διαγράψτε ένα αρχείο ή έναν φάκελο από την καθορισμένη βιβλιοθήκη εγγράφων.

Απαιτούμενες παράμετροι

• documentLibraryId: Αναγνωριστικό βιβλιοθήκης εγγράφων (συμβολοσειρά)
• fileOrFolderId: Αναγνωριστικό αρχείου ή φακέλου (συμβολοσειρά)

readSmallTextFile

Διαβάστε (κάντε λήψη) ενός αρχείου κειμένου από μια συγκεκριμένη βιβλιοθήκη εγγράφων. Εάν δεν καθορίσετε μια βιβλιοθήκη εγγράφων, χρησιμοποιείται το OneDrive του χρήστη. Πρέπει να καταχωρήσετε ένα fileId (driveItemId ενός αρχείου) για τον προσδιορισμό και τη λήψη του αρχείου.

Απαιτούμενες παράμετροι

• fileId(συμβολοσειρά)
• documentLibraryId(συμβολοσειρά) – Το αναγνωριστικό της βιβλιοθήκης εγγράφων (ονομάζεται επίσης μονάδα δίσκου) του αρχείου που θέλετε να διαβάσετε. Εάν ο χρήστης σας ζητήσει να διαβάσετε ή να κάνετε λήψη ενός αρχείου στη μονάδα δίσκου ή στο Onedrive του, για παράδειγμα - Διαβάστε ένα αρχείο στο "Η μονάδα δίσκου μου", διαβάστε ένα αρχείο στο "my onedrive" θα πρέπει να στείλετε το μήνυμα "me" ως documentLibraryId.

moveSmallFile

Μετακινήστε ένα αρχείο που βρίσκεται στην καθορισμένη βιβλιοθήκη εγγράφων σε έναν άλλο φάκελο. Αυτό το εργαλείο υποστηρίζει τη μετακίνηση μόνο για αρχεία μικρότερα από 5 MB και κινήσεις που βρίσκονται εντός της ίδιας τοποθεσίας. Δεν μπορείτε να μετακινήσετε αρχεία μεταξύ μονάδων δίσκου χρησιμοποιώντας αυτή την αίτηση.

Απαιτούμενες παράμετροι

• documentLibraryId(συμβολοσειρά) – Το αναγνωριστικό της βιβλιοθήκης εγγράφων (ονομάζεται επίσης μονάδα δίσκου) του αρχείου που θέλετε να μετακινήσετε. Εάν ο χρήστης σάς ζητήσει να μετακινήσετε ένα αρχείο στη μονάδα δίσκου ή στο Onedrive του για παράδειγμα - Μετακίνηση ενός αρχείου στη μονάδα δίσκου μου", μετακινήστε ένα αρχείο στο "my onedrive" θα πρέπει να στείλετε το μήνυμα "me" ως documentLibraryId.
• fileId(συμβολοσειρά) – Αναγνωριστικό του αρχείου για μετακίνηση
• newParentFolderId(συμβολοσειρά) – Το αναγνωριστικό του φακέλου προορισμού στον οποίο θα μετακινηθεί το αρχείο. Πρέπει να βρίσκεται στην ίδια βιβλιοθήκη εγγράφων με την αρχική θέση του αρχείου.

getFileOrFolderMetadata

Λήψη μετα-δεδομένων ενός αρχείου ή ενός φακέλου από την καθορισμένη βιβλιοθήκη εγγράφων σε μια τοποθεσία Sharepoint.

Απαιτούμενες παράμετροι

• FileOrFolderId(συμβολοσειρά) – Αναγνωριστικό αρχείου ή φακέλου. Ονομάζονται επίσης DriveItems. Επίσης, το αναγνωριστικό τους μπορεί επίσης να αναφέρεται ως driveItemId.
• documentLibraryId(συμβολοσειρά) – Το αναγνωριστικό της βιβλιοθήκης εγγράφων (ονομάζεται επίσης μονάδα δίσκου) του αρχείου ή του φακέλου του οποίο χρειάζεστε τα μετα-δεδομένα. Εάν ο χρήστης σας ζητήσει να λάβετε ένα αρχείο ή έναν φάκελο στη μονάδα δίσκου ή στο Onedrive του για παράδειγμα - "Λήψη μετα-δεδομένων ενός αρχείου στη μονάδα δίσκου μου" ή "Λήψη μετα-δεδομένων ενός φακέλου στο onedrive μου" θα πρέπει να στείλετε το μήνυμα "me" ως documentLibraryId.

createSmallTextFile

Δημιουργήστε ή αποστείλετε ένα αρχείο κειμένου μικρότερο από 5 MB σε μια συγκεκριμένη βιβλιοθήκη εγγράφων. Εάν δεν καθορίσετε μια βιβλιοθήκη εγγράφων, χρησιμοποιείται το OneDrive του χρήστη. Μπορείτε να αποστείλετε το αρχείο σε έναν συγκεκριμένο φάκελο. Εάν δεν καθορίσετε έναν φάκελο, το αρχείο αποστέλλεται στον ριζικό φάκελο.

Απαιτούμενες παράμετροι

• όνομα αρχείου (συμβολοσειρά) – Το όνομα του αρχείου που θα δημιουργηθεί
• contentText (συμβολοσειρά) – Περιεχόμενο κειμένου του αρχείου για δημιουργία
• documentLibraryId (συμβολοσειρά) – Το αναγνωριστικό της βιβλιοθήκης εγγράφων (που ονομάζεται επίσης μονάδα δίσκου) για το αρχείο. Εάν ένας χρήστης σάς ζητήσει να δημιουργήσετε ένα αρχείο στη μονάδα δίσκου ή στο OneDrive, όπως "δημιουργήστε ένα αρχείο στη μονάδα δίσκου μου" ή "δημιουργήστε ένα αρχείο στο onedrive μου", στείλτε το μήνυμα "me" ως documentLibraryId.

Προαιρετικές παράμετροι

• parentfolderId(string, default = "root") – Αναγνωριστικό φακέλου μέσα στη μονάδα δίσκου για να προσθέσετε το νέο αρχείο.

getFileOrFolderMetadataByUrl

Λήψη μετα-δεδομένων για ένα αρχείο ή φάκελο από μια διεύθυνση URL κοινής χρήσης. Μόνο χρήστες με ρητά δικαιώματα πρόσβασης στο αρχείο μπορούν να λάβουν τα μετα-δεδομένα.

Απαιτούμενες παράμετροι

• fileOrFolderUrl:(συμβολοσειρά) – Η διεύθυνση URL του αρχείου ή του φακέλου (που αναφέρεται επίσης ως DriveItems). Η διεύθυνση URL δεν εξαργυρώνεται για κοινή χρήση με τον χρήστη. Πρέπει να έχουν ήδη ρητή πρόσβαση στο αρχείο.

shareFileOrFolder

Στείλτε μια πρόσκληση κοινής χρήσης για να εκχωρήσετε δικαιώματα σε ένα αρχείο ή φάκελο μέσα σε μια καθορισμένη βιβλιοθήκη εγγράφων. Υποστηρίζει την ανάθεση ρόλων και την ειδοποίηση παραληπτών.

Απαιτούμενες παράμετροι

• documentLibraryId: Αναγνωριστικό βιβλιοθήκης εγγράφων (συμβολοσειρά, υποχρεωτικό)
• fileOrFolderId: Αναγνωριστικό αρχείου ή φακέλου (συμβολοσειρά, απαιτείται)
• recipientEmails:(string[], Required) – Διευθύνσεις ηλεκτρονικού ταχυδρομείου των παραληπτών για πρόσκληση. Απαιτείται τουλάχιστον ένα μήνυμα ηλεκτρονικού ταχυδρομείου παραλήπτη.

Προαιρετικές παράμετροι

• roles(string[]) – Ρόλοι για ανάθεση σε παραλήπτες. Αποδεκτές τιμές: ανάγνωση, εγγραφή (η εγγραφή εκχωρεί πρόσβαση ανάγνωσης και εγγραφής). Η προεπιλογή είναι να διαβάζεται ο ρόλος εάν δεν καθορίζεται.
• sendInvitation(bool, default = true) – Υποδεικνύει εάν θέλετε να στείλετε μια πρόσκληση κοινής χρήσης. Η προεπιλεγμένη τιμή είναι true εάν δεν έχει καθοριστεί.
• message(string, default = "Εδώ είναι το αρχείο στο οποίο συνεργαζόμαστε.") – Προσαρμοσμένο μήνυμα που θα συμπεριληφθεί στο μήνυμα πρόσκλησης. Η προεπιλεγμένη τιμή είναι ένα τυπικό μήνυμα, εάν δεν έχει καθοριστεί.

getFolderChildren

Απαριθμεί τα 20 κορυφαία αρχεία και φακέλους μέσα σε έναν καθορισμένο γονικό φάκελο σε μια βιβλιοθήκη εγγράφων. Εάν δεν καθορίσετε μια βιβλιοθήκη εγγράφων, χρησιμοποιείται το OneDrive του χρήστη.

Απαιτούμενες παράμετροι

• documentLibraryId(συμβολοσειρά) – Το αναγνωριστικό της βιβλιοθήκης εγγράφων (που ονομάζεται επίσης μονάδα δίσκου) για τον γονικό φάκελο. Εάν ένας χρήστης σάς ζητήσει να λάβετε αρχεία σε έναν φάκελο στη μονάδα δίσκου ή στο OneDrive, όπως "λήψη αρχείων σε έναν φάκελο στη μονάδα δίσκου μου" ή "λήψη αρχείων σε έναν φάκελο στο onedrive μου", στείλτε "me" ως έγγραφοLibraryId.

Προαιρετικές παράμετροι

• parentFolderId:(string, default = "root") – Αναγνωριστικό του γονικού φακέλου (DriveItem) του οποίου παρατίθενται τα αρχεία και οι φάκελοι. Η προεπιλεγμένη τιμή είναι ο ριζικός φάκελος της βιβλιοθήκης εγγράφων, εάν δεν έχει καθοριστεί.

Ηχώ

Αποστέλλει το μήνυμα πίσω στο πρόγραμμα-πελάτη.

Απαιτούμενες παράμετροι

• μήνυμα: Μήνυμα προς αποστολή

setSensitivityLabelOnFile

Ορίστε την ετικέτα ευαισθησίας ενός αρχείου από την καθορισμένη βιβλιοθήκη εγγράφων.

Απαιτούμενες παράμετροι

• documentLibraryId(συμβολοσειρά) – Το αναγνωριστικό βιβλιοθήκης εγγράφων, γνωστό και ως driveId, της βιβλιοθήκης εγγράφων
• fileId(συμβολοσειρά) – Το αναγνωριστικό αρχείου, γνωστό επίσης ως driveItemId, του αρχείου
• sensitivityLabelId(συμβολοσειρά) – Υποχρεωτικό. Το αναγνωριστικό της ετικέτας ευαισθησίας προς εκχώρηση ή κενή συμβολοσειρά για την κατάργηση της ετικέτας ευαισθησίας.

Προαιρετικές παράμετροι

• assignmentMethod(string, default = "privileged") - Η μέθοδος ανάθεσης της ετικέτας στο έγγραφο. Υποδεικνύει εάν η ανάθεση της ετικέτας έγινε αυτόματα, τυπική ή ως λειτουργία με δικαιώματα (το ισοδύναμο μιας λειτουργίας διαχειριστή). Οι πιθανές τιμές είναι τυπικές, προνομιακές, αυτόματες και άγνωστεςFutureValue.
• justificationText(string, default = "Changed by MCPServer") – Προαιρετικό. Κείμενο αιτιολόγησης για σκοπούς ελέγχου και απαιτείται κατά την υποβάθμιση ή την κατάργηση μιας ετικέτας.

getDefaultDocumentLibraryInSite

Λάβετε την προεπιλεγμένη βιβλιοθήκη εγγράφων (που ονομάζεται επίσης Drive) σε μια τοποθεσία του SharePoint. Εάν δεν καθορίσετε μια τοποθεσία, χρησιμοποιείται η τοποθεσία ρίζας.

Απαιτούμενες παράμετροι

Κανένα

Προαιρετικές παράμετροι

• siteId: Αναγνωριστικό τοποθεσίας (προεπιλογή: ρίζα)

Δυνατότητες κλειδιά

Διαχείριση φακέλων

• Δημιουργία φακέλων με αυτόματη επίλυση διένεξης ονομάτων
• Απαρίθμηση θυγατρικών φακέλων (πρώτα 20)
• Μετακίνηση αρχείων μεταξύ φακέλων (εντός της ίδιας τοποθεσίας)

Λειτουργίες πωλήσεων

• Δημιουργία και αποστολή μικρών αρχείων κειμένου (< 5MB)
• Ανάγνωση και λήψη αρχείων κειμένου
• Μετονομασία αρχείων και φακέλων
• Διαγραφή αρχείων και φακέλων
• Λήψη μετα-δεδομένων αρχείου και φακέλου κατά αναγνωριστικό ή διεύθυνση URL

Εντοπισμός τοποθεσίας και βιβλιοθήκης

• Εύρεση τοποθεσιών του SharePoint κατά ερώτημα αναζήτησης
• Λίστα βιβλιοθηκών εγγράφων σε μια τοποθεσία
• Λήψη προεπιλεγμένης βιβλιοθήκης εγγράφων

Κοινή χρήση και δικαιώματα

• Κοινή χρήση αρχείων και φακέλων με αναθέσεις ρόλων
• Αποστολή προσκλήσεων κοινής χρήσης με προσαρμοσμένα μηνύματα
• Έλεγχος πρόσβασης μέσω ρητών δικαιωμάτων

Ασφάλεια και συμμόρφωση

• Ορισμός ετικετών ευαισθησίας σε αρχεία
• Υποστήριξη για προνομιακές, τυπικές και αυτόματες μεθόδους ανάθεσης
• Κείμενο αιτιολόγησης για έλεγχο συμμόρφωσης

Ενσωμάτωση

• Υποστήριξη για το OneDrive και το SharePoint Online
• Σύνδεση διακομιστή για συγκεκριμένο μισθωτή
• Αφαίρεση Του DriveItem για αρχεία και φακέλους

Σημειώσεις

1. Η προεπιλεγμένη βιβλιοθήκη εγγράφων είναι "me" (OneDrive χρήστη)
2. Ο προεπιλεγμένος γονικός φάκελος είναι "root"
3. Διενέξεις ονομάτων φακέλων που επιλύονται με αριθμητικά επιθήματα
4. Κινήσεις αρχείων που περιορίζονται σε λιγότερο από 5 MB και εντός της ίδιας τοποθεσίας
5. Οι διευθύνσεις URL κοινής χρήσης απαιτούν δικαιώματα ρητής πρόσβασης
6. Το DriveItems αντιπροσωπεύει τόσο αρχεία όσο και φακέλους
7. Όριο κορυφαίων 20 στην απαρίθμηση θυγατρικών φακέλων