SharePoint Listeleri Araçları MCP sunucu başvurusu

Önemli

Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.

Genel bakış

Sunucu Kimliği	Görünen ad	Description
mcp_SharePointListsTools	Microsoft SharePoint Listeleri MCP Sunucusu	Listeler için Microsoft Graph SharePoint araçları sağlayan MCP sunucusu. Listeler için Microsoft Graph SharePoint araçları sağlayan MCP sunucusu.

Kullanılabilir araçlar

sharepoint_createList

Sitede yeni bir SharePoint listesi oluşturun.

Gerekli Parametreler

• siteId: Sitenin benzersiz kimliği
• displayName: Listenin görünen adı
• list: Şablon gibi liste bilgileri (örneğin, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Belirli bir SharePoint listesinde yeni bir sütun (columnDefinition) oluşturun. Hedef siteId ve listId değerlerinin yanı sıra sütunun adını, görünen adını ve tam olarak bir sütun türünü (metin, sayı, seçim, dateTime, personOrGroup, lookup, boole veya hyperlinkOrPicture gibi) belirten geçerli bir sütun tanımı sağlamanız gerekir.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği
• name: Sütunun API/statik adı (boşluk yok, 1-64 karakter)

İsteğe bağlı parametreler

• displayName: Kullanıcıya yönelik görünen ad
• açıklama: Sütun açıklaması
• enforceUniqueValues: True ise, değerlerin benzersiz olması gerekir
• gizli: True ise, sütun gizlidir
• indexed: True ise, değerler dizine eklenir
• gerekli: True ise, bir değer gereklidir
• readOnly: True ise, değerler değiştirilemez
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Sütun türü ayarları (bir gerekli)

sharepoint_createListItem

SharePoint listesinde yeni bir öğe oluşturun.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği
• alanlar: Liste öğesi için alan değerleri (anahtar/değer eşlemesi)

sharepoint_deleteListColumn

Belirli bir SharePoint listesinden var olan bir columnDefinition öğesini silin. siteId, listId ve columnId bilgilerini sağlayın. Bu eylem sütunu liste şemasından kalıcı olarak kaldırır.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği
• columnId: Silinecek sütunun benzersiz kimliği

sharepoint_deleteListItem

Liste öğesi silme.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği
• itemId: Liste öğesinin benzersiz kimliği

İsteğe bağlı parametreler

• ifMatch: Eşzamanlılık denetimi için isteğe bağlı ETag (örn. "*")

sharepoint_editListColumn

Belirli bir SharePoint listesinde var olan bir columnDefinition'i güncelleştirin. siteId, listId ve columnId bilgilerini sağlayın. Gövde kısmidir- yalnızca değiştirmek istediğiniz özellikleri (displayName, açıklama, gizli, gerekli veya model ayarları gibi) içerir.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği
• columnId: Güncelleştirilecek sütunun benzersiz kimliği

İsteğe bağlı parametreler

• displayName: Kullanıcıya yönelik görünen ad
• açıklama: Sütun açıklaması
• gizli: True ise, sütun gizlidir
• gerekli: True ise, bir değer gereklidir
• enforceUniqueValues: True ise, değerlerin benzersiz olması gerekir
• indexed: True ise, değerler dizine eklenir
• readOnly: True ise, değerler değiştirilemez
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Sütun türü ayarlarını güncelleştirme

sharepoint_getSiteByPath

SharePoint sitesini ana bilgisayar adını ve sunucu göreli yolunu kullanarak çözümleyin.

Gerekli parametreler

• ana bilgisayar adı: SharePoint kiracısının ana bilgisayar adı (örneğin, contoso.sharepoint.com)
• serverRelativePath: Sitenin sunucu göreli yolu (örneğin, siteler/Pazarlama)

sharepoint_listListColumns

Belirli bir SharePoint listesi için sütun tanımlarını (columnDefinition kaynakları) listeleyin. siteId ve listId gerektirir. $select, $top ve $skiptoken gibi OData parametrelerini destekler.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği

İsteğe bağlı parametreler

• select: Döndürülecek özelliklerin virgülle ayrılmış listesi
• filter: Sonuçları kısıtlamak için OData filtre ifadesi
• orderBy: Sıralama ölçütü olarak virgülle ayrılmış özellikler listesi
• üst: Sayfa boyutu (1-999)
• skiptoken: Sonraki kümeye disk belleği için opak belirteç

sharepoint_listListItems

SharePoint listesinden öğeleri listeleme.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği

İsteğe bağlı parametreler

• expand: İsteğe bağlı OData genişletme (örneğin, alanlar)
• üst: İsteğe bağlı sayfa boyutu
• filter: İsteğe bağlı OData filtre ifadesi
• select: İsteğe bağlı OData select yan tümcesi

sharepoint_listLists

Sitedeki tüm SharePoint listelerini listeleyin.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği

sharepoint_listSubsites

Belirli bir site için alt siteleri (alt siteler) listeleyin.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği

sharepoint_search

EntityTypes=["site"] ile Microsoft Graph Arama API'sini kullanarak SharePoint'de arama yapın.

Gerekli parametreler

• istekler: SearchRequest nesnelerinin dizisi

İsteğe bağlı parametreler

• entityTypes: SharePoint site aramaları için ["site"] olmalıdır
• sorgu: KQL stili arama dizesiyle sorgu nesnesi
• kimden: İlk sonucun sıfır tabanlı uzaklığı
• boyut: Döndürülecek sonuç sayısı (1-50)
• fields: Yanıtta seçileceği isteğe bağlı alan listesi

13. sharepoint_searchSitesByName

SharePoint sitelerinde görünen ada veya kısmi URL'ye (doğal dil) göre arama yapın.

Gerekli parametreler

• search: Aranacak SharePoint sitesinin görünen adı veya kısmi adı/URL'si

İsteğe bağlı parametreler

• consistencyLevel: Microsoft Graph için gereklidir (varsayılan: nihai)

14. sharepoint_updateListItem

Varolan bir liste öğesinin alanlarını güncelleştirin.

Gerekli parametreler

• siteId: Sitenin benzersiz kimliği
• listId: Listenin benzersiz kimliği
• itemId: Liste öğesinin benzersiz kimliği
• alanlar: Güncelleştirilecek alan değerleri (kısmi)

İsteğe bağlı parametreler

• ifMatch: Eşzamanlılık denetimi için isteğe bağlı ETag (örneğin, zorlamak için "*"

Önemli özellikler

Liste Yönetimi

• Şablonlarla yeni SharePoint listeleri oluşturma
• Sitedeki tüm listeleri listeleme
• Çeşitli liste şablonları için destek (genericList, documentLibrary, issueTracking)

Sütun C: Operasyonlar

• Birden çok veri türüne sahip sütunlar oluşturma (metin, sayı, seçim, dateTime, personOrGroup, lookup, boolean, hyperlinkOrPicture)
• Mevcut sütunları düzenleme
• Sütunları silme
• Listedeki tüm sütunları listeleme
• Sütun doğrulama ve benzersizlik kısıtlamaları

Takım işlemleri

• Alan değerleriyle liste öğeleri oluşturma
• Mevcut liste öğelerini güncelleştirme (kısmi güncelleştirmeler)
• Liste öğesi silme.
• Öğeleri filtreleme ve sayfalandırma ile listeleme
• ETag aracılığıyla eşzamanlılık denetimi

Site Bulma

• Sitelerde ada veya URL'ye göre arama
• Siteleri ana bilgisayar adına ve yola göre çözümleme
• Alt siteleri listeleme
• Microsoft Graph Arama API'siyle KQL stili arama

OData Sorgu Desteği

• Özellikleri seçmek için $select kullanın.
• Sonuçları filtrelemek için $filter kullanın.
• İlgili varlıkları eklemek için $expand kullanın.
• Sonuçları sıralamak için $orderby kullanın.
• Sayfalandırma için $top kullanın.
• Büyük sonuç kümelerini sayfalandırmak için $skiptoken kullanın.

Sütun Türü Desteği

• Metin sütunları (tek satırlı veya çok satırlı, düz veya zengin metin).
• Sayı sütunları (ondalık basamaklar, en düşük ve en yüksek değerler ile).
• Seçim sütunları (onay kutuları, açılan menü veya radyo düğmeleri).
• Boole sütunları.
• Tarih Saat, Tarih ve Saat, Yalnızca Tarih
• Kişi veya Grup sütunları (tek veya birden çok seçim).
• Arama sütunları (diğer listelere başvurun).
• Köprü veya Resim sütunları.

Notlar

1. Tüm işlemlerde Microsoft Graph API v1.0 kullanılır.
2. Sütun adları boşluksuz 1-64 karakter uzunluğunda olmalıdır.
3. Her sütun tam olarak bir sütun türü belirtmelidir.
4. Eşzamanlılık denetimi üst bilgi aracılığıyla If-Match kullanılabilir.
5. Site aramaları için olarak eventualayarlanması gerekirconsistencyLevel.
6. Arama sonuçları sayfa başına 50 öğeyle sınırlıdır.
7. Kısmi güncelleştirmeler sütunlar ve liste öğeleri için desteklenir.