Referensi server MCP Alat Daftar SharePoint

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_SharePointListsTools	Microsoft SharePoint Mencantumkan Server MCP	Server MCP menyediakan alat Microsoft Graph SharePoint untuk daftar. Server MCP menyediakan alat Microsoft Graph SharePoint untuk daftar.

Alat yang tersedia

sharepoint_createList

Buat daftar SharePoint baru di situs.

Parameter yang Diperlukan

• siteId: ID unik situs
• displayName: Nama tampilan daftar
• daftar: Daftar info seperti templat (misalnya, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Buat kolom baru (columnDefinition) di daftar SharePoint tertentu. Anda harus menyediakan siteId target dan listId, ditambah definisi kolom valid yang menentukan nama kolom, nama tampilan, dan tepat satu tipe kolom (seperti teks, angka, pilihan, dateTime, personOrGroup, pencarian, boolean, atau hyperlinkOrPicture).

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar
• nama: API/nama statis kolom (tanpa spasi, 1-64 karakter)

Parameter opsional

• displayName: Nama tampilan yang menghadap pengguna
• deskripsi: Deskripsi kolom
• enforceUniqueValues: Jika true, nilai harus unik
• tersembunyi: Jika true, kolom disembunyikan
• terindeks: Jika true, nilai diindeks
• diperlukan: Jika true, nilai diperlukan
• readOnly: Jika true, nilai tidak dapat diubah
• teks, angka, pilihan, boolean, dateTime, personOrGroup, pencarian, hyperlinkOrPicture: Pengaturan jenis kolom (satu diperlukan)

sharepoint_createListItem

Buat item baru di daftar SharePoint.

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar
• bidang: Nilai bidang untuk item daftar (peta kunci/nilai)

sharepoint_deleteListColumn

Hapus columnDefinition yang sudah ada dari daftar SharePoint tertentu. Sediakan siteId, listId, dan columnId. Tindakan ini menghapus kolom secara permanen dari skema daftar.

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar
• columnId: ID unik kolom yang akan dihapus

sharepoint_deleteListItem

Hapus item daftar.

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar
• itemId: ID unik item daftar

Parameter opsional

• ifMatch: ETag Opsional untuk kontrol konkurensi (misalnya, "*")

sharepoint_editListColumn

Perbarui columnDefinition yang sudah ada pada daftar SharePoint tertentu. Sediakan siteId, listId, dan columnId. Isinya parsial - hanya sertakan properti yang ingin Anda ubah (seperti pengaturan displayName, description, hidden, required, atau facet).

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar
• columnId: ID unik kolom yang akan diperbarui

Parameter opsional

• displayName: Nama tampilan yang menghadap pengguna
• deskripsi: Deskripsi kolom
• tersembunyi: Jika true, kolom disembunyikan
• diperlukan: Jika true, nilai diperlukan
• enforceUniqueValues: Jika true, nilai harus unik
• terindeks: Jika true, nilai diindeks
• readOnly: Jika true, nilai tidak dapat diubah
• teks, angka, pilihan, dateTime, personOrGroup, pencarian, hyperlinkOrPicture: Memperbarui pengaturan tipe kolom

sharepoint_getSiteByPath

Atasi situs SharePoint dengan menggunakan nama host dan jalur relatif servernya.

Parameter yang diperlukan

• nama host: Nama host penyewa SharePoint (misalnya, contoso.sharepoint.com)
• serverRelativePath: Jalur relatif server ke situs (misalnya, situs/Pemasaran)

sharepoint_listListColumns

Mencantumkan definisi kolom (sumber daya columnDefinition) untuk daftar SharePoint tertentu. Memerlukan siteId dan listId. Mendukung param OData seperti $select, $top, dan $skiptoken.

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar

Parameter opsional

• pilih: Daftar properti yang dipisahkan koma untuk dikembalikan
• filter: Ekspresi filter OData untuk membatasi hasil
• orderBy: Daftar properti yang dipisahkan koma untuk diurutkan menurut
• atas: Ukuran halaman (1-999)
• skiptoken: Token buram untuk penomoran ke set berikutnya

sharepoint_listListItems

Mencantumkan item dari daftar SharePoint.

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar

Parameter opsional

• perluas: Perluas OData opsional (misalnya, bidang)
• atas: Ukuran halaman opsional
• filter: Ekspresi filter OData opsional
• pilih: Klausa pilih OData opsional

sharepoint_listLists

Mencantumkan semua daftar SharePoint di situs.

Parameter yang diperlukan

• siteId: ID unik situs

sharepoint_listSubsites

Cantumkan situs anak (subsitus) untuk situs tertentu.

Parameter yang diperlukan

• siteId: ID unik situs

sharepoint_search

Cari SharePoint menggunakan Microsoft Graph Search API dengan entityTypes=["site"].

Parameter yang diperlukan

• permintaan: Array objek searchRequest

Parameter opsional

• entityTypes: Harus ["site"] untuk pencarian situs SharePoint
• kueri: Objek kueri dengan string pencarian gaya KQL
• dari: Offset berbasis nol dari hasil pertama
• ukuran: Jumlah hasil yang akan dikembalikan (1-50)
• bidang: Daftar bidang opsional untuk dipilih dalam respons

13. sharepoint_searchSitesByName

Cari situs SharePoint menurut nama tampilan atau URL parsial (bahasa alami).

Parameter yang diperlukan

• pencarian: Nama tampilan atau nama/URL parsial situs SharePoint yang akan dicari

Parameter opsional

• consistencyLevel: Diperlukan oleh Microsoft Graph (default: akhirnya)

14. sharepoint_updateListItem

Perbarui bidang item daftar yang sudah ada.

Parameter yang diperlukan

• siteId: ID unik situs
• listId: ID unik daftar
• itemId: ID unik item daftar
• bidang: Nilai bidang untuk diperbarui (parsial)

Parameter opsional

• ifMatch: ETag opsional untuk kontrol konkurensi (misalnya, "*" untuk memaksa)

Fitur Utama

Manajemen Daftar

• Membuat daftar SharePoint baru dengan templat
• Mencantumkan semua daftar di situs
• Dukungan untuk berbagai templat daftar (genericList, documentLibrary, issueTracking)

Operasi Kolom

• Membuat kolom dengan beberapa jenis data (teks, angka, pilihan, dateTime, personOrGroup, pencarian, boolean, hyperlinkOrPicture)
• Mengedit kolom yang sudah ada
• Hapus kolom
• Mencantumkan semua kolom dalam daftar
• Validasi kolom dan batasan keunikan

Operasi Item

• Membuat item daftar dengan nilai bidang
• Memperbarui item daftar yang ada (pembaruan parsial)
• Hapus item daftar.
• Mencantumkan item dengan pemfilteran dan penomoran halaman
• Kontrol konkurensi melalui ETag

Penemuan Situs

• Cari situs menurut nama atau URL
• Mengatasi situs menurut nama host dan jalur
• Mencantumkan subsitus
• Pencarian gaya KQL dengan Microsoft Graph Search API

Dukungan Kueri OData

• Gunakan $select untuk memilih properti.
• Gunakan $filter untuk memfilter hasil.
• Gunakan $expand untuk menyertakan entitas terkait.
• Gunakan $orderby untuk mengurutkan hasil.
• Gunakan $top untuk penomoran halaman.
• Gunakan $skiptoken ke halaman melalui kumpulan hasil besar.

Dukungan Tipe Kolom

• Kolom teks (baris tunggal atau multibaris, teks biasa atau kaya).
• Kolom angka (dengan tempat desimal, nilai minimum, dan maksimum).
• Kolom pilihan (kotak centang, dropdown, atau tombol radio).
• Kolom Boolean.
• Tanggal Waktu, Tanggal dan Waktu, Hanya Tanggal
• Kolom Orang atau Grup (pilihan tunggal atau beberapa).
• Kolom pencarian (referensi daftar lain).
• Kolom Hyperlink atau Gambar.

Catatan

1. Semua operasi menggunakan Microsoft Graph API v1.0.
2. Nama kolom harus 1-64 karakter tanpa spasi.
3. Setiap kolom harus menentukan tepat satu jenis kolom.
4. Kontrol konkurensi tersedia melalui If-Match header.
5. Pencarian situs perlu consistencyLevel diatur ke eventual.
6. Hasil pencarian dibatasi hingga 50 item per halaman.
7. Pembaruan parsial didukung untuk kolom dan item daftar.