Referensi Microsoft SharePoint dan OneDrive MCP Server

Penting

Anda harus menjadi bagian dari program pratinjau Frontier untuk mendapatkan akses awal ke Microsoft Agent 365. Frontier menghubungkan Anda langsung dengan inovasi AI terbaru Microsoft. Pratinjau frontier tunduk pada ketentuan pratinjau yang ada dari perjanjian pelanggan Anda. Karena fitur-fitur ini masih dalam pengembangan, ketersediaan dan kemampuannya dapat berubah dari waktu ke waktu.

Ikhtisar

ID Penjual	Nama tampilan	KETERANGAN
mcp_ODSPRemoteServer	SharePoint dan OneDrive di Microsoft 365	Server MCP menyediakan alat untuk bekerja dengan konten SharePoint dan OneDrive Anda. Server ini tersambung ke server MCP SharePoint Online khusus penyewa Anda. Ini secara otomatis menemukan dan menyediakan semua alat yang mendukung integrasi file OneDrive dan SharePoint yang diekspos oleh titik akhir ODSP MCP.

Alat yang tersedia

createFolder

Membuat folder baru dalam Pustaka Dokumen tertentu sebagai anak dari folder induk yang ditentukan. Jika Anda tidak menentukan Pustaka Dokumen, server menggunakan OneDrive pengguna. Jika Anda tidak menentukan folder induk, server akan membuat folder di root. Jika folder sudah ada dengan nama yang sama, server membuat folder baru dengan akhiran numerik, seperti NewFolder (1).

Parameter yang diperlukan

• folderName(string) – Nama folder yang akan dibuat. Jika folder dengan nama yang sama sudah ada, server menambahkan akhiran numerik ke nama folder baru, seperti NewFolder (1).
• documentLibraryId(string) – ID Pustaka Dokumen (juga disebut Drive) tempat Anda ingin membuat folder. Jika Anda ingin membuat folder di drive pengguna atau OneDrive mereka, seperti "drive saya" atau "onedrive saya," kirim "me" sebagai documentLibraryId.

Parameter opsional

• parentFolderId(string, default = "root") – ID folder induk tempat folder baru akan dibuat. Default ke akar pustaka dokumen jika tidak ditentukan.

findSite

Menemukan situs SharePoint yang bisa diakses pengguna. Alat ini dapat menemukan situs tertentu berdasarkan kueri pencarian yang Anda sediakan, atau menemukan 20 situs relevan teratas yang dapat diakses oleh pengguna jika Anda tidak menyediakan kueri pencarian.

Parameter yang diperlukan

Tidak ada

Parameter opsional

• searchQuery(string, default = null) – Kueri pencarian yang bisa menjadi seluruh atau sebagian nama situs. Menyediakan kueri pencarian membantu mencari situs secara efisien, tetapi hanya jika pengguna mencari situs tertentu. Misalnya, jika pengguna meminta situs yang disebut xyz, Anda akan lulus xyz sebagai searchQuery. Jika pengguna hanya meminta "situs saya", Anda membiarkan parameter ini kosong.

listDocumentLibrariesInSite

Mencantumkan Pustaka Dokumen (juga disebut Drive) di situs SharePoint yang ditentukan. Jika Anda tidak menentukan situs, server menggunakan situs akar.

Parameter yang diperlukan

Tidak ada

Parameter opsional

• siteId: ID Situs (default: root)

findFileOrFolder

Menemukan file atau folder (juga disebut DriveItem) yang dapat diakses pengguna dengan meneruskan kueri pencarian.

Parameter yang diperlukan

• searchQuery: Kueri pencarian yang bisa menjadi seluruh atau sebagian nama file

ganti namaFileOrFolder

Ganti nama file atau folder (juga disebut sebagai DriveItems) dalam Pustaka Dokumen yang ditentukan. Catatan: Nama baru harus mematuhi konvensi penamaan.

Parameter yang diperlukan

• documentLibraryId: ID Pustaka Dokumen (string)
• fileOrFolderId: ID File atau Folder (string)
• newFileOrFolderName: Nama baru untuk file atau folder (string)

deleteFileOrFolder

Hapus file atau folder dari Pustaka Dokumen yang ditentukan.

Parameter yang diperlukan

• documentLibraryId: ID Pustaka Dokumen (string)
• fileOrFolderId: ID File atau Folder (string)

readSmallTextFile

Baca (unduh) file teks dari Pustaka Dokumen tertentu. Jika Anda tidak menentukan Pustaka Dokumen, OneDrive pengguna akan digunakan. Anda perlu menyediakan fileId (driveItemId dari File) untuk mengidentifikasi dan mengunduh file.

Parameter yang diperlukan

• fileId(string)
• documentLibraryId(string) – Id Pustaka Dokumen (juga disebut sebagai Drive) file yang ingin Anda baca. Jika pengguna meminta Anda untuk membaca atau mengunduh file di drive mereka atau Onedrive mereka misalnya - Membaca file di "drive saya", Baca file di "onedrive saya" yang harus Anda kirim "saya" sebagai documentLibraryId.

moveSmallFile

Pindahkan file yang terletak di Pustaka Dokumen yang ditentukan ke folder lain. Alat ini hanya mendukung pemindahan untuk file kurang dari 5 MB dan pemindahan yang berada dalam situs yang sama. Anda tidak dapat memindahkan file antar Drive dengan menggunakan permintaan ini.

Parameter yang diperlukan

• documentLibraryId(string) – Id Pustaka Dokumen (juga disebut sebagai Drive) file yang ingin Anda pindahkan. Jika pengguna meminta Anda untuk memindahkan file di drive mereka atau Onedrive mereka misalnya - Memindahkan file di "drive saya", Pindahkan file di "onedrive saya" yang harus Anda kirim di "saya" sebagai documentLibraryId.
• fileId(string) – Id file yang akan dipindahkan
• newParentFolderId(string) – ID folder target untuk memindahkan file ke dalamnya. Harus berada di pustaka dokumen yang sama dengan lokasi asli file.

getFileOrFolderMetadata

Dapatkan metadata file atau folder dari Pustaka Dokumen yang ditentukan di Situs Sharepoint.

Parameter yang diperlukan

• FileOrFolderId(string) – Id file atau folder. Mereka juga disebut DriveItems. Dan Id mereka juga terkadang dapat disebut sebagai driveItemId.
• documentLibraryId(string) – Id Pustaka Dokumen (juga disebut sebagai Drive) file atau folder yang Anda butuhkan metadatanya. Jika pengguna meminta Anda untuk mendapatkan file atau folder di drive mereka atau Onedrive mereka misalnya - "Dapatkan metadata file di drive saya" atau "Dapatkan metadata folder di onedrive saya" Anda harus mengirim "saya" sebagai documentLibraryId.

createSmallTextFile

Buat atau unggah file teks yang lebih kecil dari 5 MB ke Pustaka Dokumen tertentu. Jika Anda tidak menentukan Pustaka Dokumen, OneDrive pengguna akan digunakan. Anda dapat mengunggah file ke folder tertentu. Jika Anda tidak menentukan folder, file akan diunggah ke folder akar.

Parameter yang diperlukan

• filename (string) – Nama file yang akan dibuat
• contentText (string) – Konten teks file yang akan dibuat
• documentLibraryId (string) – ID Pustaka Dokumen (juga disebut Drive) untuk file tersebut. Jika pengguna meminta Anda untuk membuat file di drive mereka atau OneDrive mereka, seperti "buat file di drive saya" atau "buat file di onedrive saya," kirim "saya" sebagai documentLibraryId.

Parameter opsional

• parentfolderId(string, default = "root") – ID Folder dalam drive untuk menambahkan file baru.

getFileOrFolderMetadataByUrl

Dapatkan metadata untuk file atau folder dari URL berbagi. Hanya pengguna dengan izin eksplisit untuk mengakses file yang bisa mendapatkan metadata.

Parameter yang diperlukan

• fileOrFolderUrl:(string) – URL File atau Folder (juga disebut sebagai DriveItems). Url tidak ditukarkan untuk membagikannya dengan pengguna; mereka harus sudah memiliki akses eksplisit ke file.

shareFileOrFolder

Kirim undangan berbagi untuk memberikan izin pada file atau folder dalam Pustaka Dokumen tertentu. Mendukung penetapan peran dan memberi tahu penerima.

Parameter yang diperlukan

• documentLibraryId: ID Pustaka Dokumen (string, Wajib)
• fileOrFolderId: ID File atau Folder (string, Wajib)
• recipientEmails:(string[], Required) – Alamat email penerima untuk diundang. Setidaknya diperlukan satu email penerima.

Parameter opsional

• roles(string[]) – Peran untuk ditetapkan ke penerima. Nilai yang diterima: baca, tulis (tulis memberikan akses baca dan tulis). Default untuk membaca peran jika tidak ditentukan.
• sendInvitation(bool, default = true) – Menunjukkan apakah akan mengirim undangan berbagi. Default ke true jika tidak ditentukan.
• message(string, default = "Berikut adalah file tempat kami berkolaborasi.") – Pesan kustom untuk disertakan dalam email undangan. Default ke pesan standar jika tidak ditentukan.

getFolderChildren

Menghitung 20 file dan folder teratas dalam folder induk tertentu dalam Pustaka Dokumen. Jika Anda tidak menentukan Pustaka Dokumen, OneDrive pengguna akan digunakan.

Parameter yang diperlukan

• documentLibraryId(string) – ID Pustaka Dokumen (juga disebut Drive) untuk folder induk. Jika pengguna meminta Anda untuk mendapatkan file di folder di drive mereka atau OneDrive mereka, seperti "dapatkan file dalam folder di drive saya" atau "dapatkan file dalam folder di onedrive saya," kirim "saya" sebagai documentLibraryId.

Parameter opsional

• parentFolderId:(string, default = "root") – ID folder induk (DriveItem) yang file dan foldernya tercantum. Default ke folder akar Pustaka Dokumen jika tidak ditentukan.

Gema

Mengirim pesan kembali ke klien.

Parameter yang diperlukan

• pesan: Pesan untuk dikirim kembali

setSensitivityLabelOnFile

Atur label sensitivitas file dari Pustaka Dokumen yang ditentukan.

Parameter yang diperlukan

• documentLibraryId(string) – ID pustaka dokumen, juga dikenal sebagai driveId, dari pustaka dokumen
• fileId(string) – ID file, juga dikenal sebagai driveItemId, dari file
• sensitivityLabelId(string) – Diperlukan. ID label sensitivitas untuk ditetapkan, atau string kosong untuk menghapus label sensitivitas.

Parameter opsional

• assignmentMethod(string, default = "privileged") - Metode penetapan label pada dokumen. Menunjukkan apakah penetapan label dilakukan secara otomatis, standar, atau sebagai operasi istimewa (setara dengan operasi administrator). Nilai yang mungkin adalah standar, hak istimewa, otomatis, dan unknownFutureValue.
• justificationText(string, default = "Diubah oleh MCPServer") – Opsional. Teks justifikasi untuk tujuan audit, dan diperlukan saat menurunkan atau menghapus label.

getDefaultDocumentLibraryInSite

Dapatkan Pustaka Dokumen default (juga disebut Drive) di Situs SharePoint. Jika Anda tidak menentukan situs, situs akar digunakan.

Parameter yang diperlukan

Tidak ada

Parameter opsional

• siteId: ID Situs (default: root)

Fitur utama

Manajemen folder

• Membuat folder dengan resolusi konflik penamaan otomatis
• Menghitung turunan folder (20 teratas)
• Memindahkan file antar folder (dalam situs yang sama)

Operasi file

• Membuat dan mengunggah file teks kecil (< 5MB)
• Membaca dan mengunduh file teks
• Cadangkan file dan folder
• Cadangkan file dan folder
• Mendapatkan metadata file dan folder berdasarkan ID atau URL

Penemuan situs dan pustaka

• Menemukan situs SharePoint menurut kueri pencarian
• Mencantumkan pustaka dokumen dalam situs
• Mendapatkan pustaka dokumen default

Berbagi dan izin

• Berbagi file dan folder dengan penetapan peran
• Mengirim undangan berbagi dengan pesan kustom
• Kontrol akses melalui izin eksplisit

Keamanan dan kepatuhan

• Mengatur label sensitivitas pada file
• Dukungan untuk metode penugasan istimewa, standar, dan otomatis
• Teks justifikasi untuk audit kepatuhan

Integrasi

• Dukungan OneDrive dan SharePoint Online
• Koneksi server khusus penyewa
• Abstraksi DriveItem untuk file dan folder

Catatan

1. Pustaka Dokumen Default adalah 'saya' (OneDrive pengguna)
2. Folder induk default adalah 'root'
3. Konflik nama folder diselesaikan dengan akhiran numerik
4. Pemindahan file dibatasi hingga kurang dari 5 MB dan dalam situs yang sama
5. URL berbagi memerlukan izin akses eksplisit
6. DriveItems mewakili file dan folder
7. Batas 20 teratas pada enumerasi anak folder