Microsoft SharePoint ve OneDrive MCP Sunucusu 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_ODSPRemoteServer	Microsoft 365'te SharePoint ve OneDrive	McP sunucusu, SharePoint ve OneDrive içeriğiniz ile çalışmaya yönelik araçlar sağlar. Bu sunucu kiracınıza özgü SharePoint Online MCP sunucunuza bağlanır. ODSP MCP uç noktası tarafından kullanıma sunulan OneDrive ve SharePoint dosyaları tümleştirmesini destekleyen tüm araçları otomatik olarak bulur ve kullanıma sunar.

Kullanılabilir araçlar

createFolder

Belirtilen belge kitaplığında, belirtilen üst klasörün alt öğesi olarak yeni bir klasör oluşturur. Belge Kitaplığı belirtmezseniz, sunucu kullanıcının OneDrive'ını kullanır. Üst klasör belirtmezseniz, sunucu klasörü kökte oluşturur. Aynı ada sahip bir klasör zaten varsa, sunucu gibi NewFolder (1)sayısal bir sonek içeren yeni klasörü oluşturur.

Gerekli parametreler

• folderName(dize) – Oluşturulacak klasörün adı. Aynı ada sahip bir klasör zaten varsa, sunucu yeni klasör adına gibi NewFolder (1)sayısal bir sonek ekler.
• documentLibraryId(dize) – Klasörü oluşturmak istediğiniz Belge Kitaplığı kimliği (Sürücü olarak da adlandırılır). Kullanıcının sürücüsünde veya OneDrive'ında "sürücüm" veya "onedrive'ım" gibi bir klasör oluşturmak istiyorsanız, olarak documentLibraryIdgönderin"me".

İsteğe bağlı parametreler

• parentFolderId(string, default = "root") – Yeni klasörün oluşturulacağı üst klasörün kimliği. Belirtilmezse, varsayılan olarak belge kitaplığının kökünü kullanır.

findSite

Kullanıcının erişebileceği SharePoint sitelerini bulur. Bu araç, sağladığınız arama sorgusuna göre belirli bir siteyi bulabilir veya arama sorgusu sağlamazsanız kullanıcı tarafından erişilebilen en iyi 20 siteyi bulabilir.

Gerekli parametreler

Yok

İsteğe bağlı parametreler

• searchQuery(dize, varsayılan = null) – Site adının tamamı veya bir kısmı olabilecek arama sorgusu. Arama sorgusu sağlamak, yalnızca kullanıcı belirli bir siteyi arıyorsa, bir siteyi verimli bir şekilde aramaya yardımcı olur. Örneğin, kullanıcı adlı xyzbir site isterse, olarak searchQuerygeçirirsinizxyz. Kullanıcı yalnızca "sitelerim" sorusunu sorarsa, bu parametreyi boş bırakırsınız.

listDocumentLibrariesInSite

Belirtilen SharePoint sitesindeki Belge Kitaplıklarını (Sürücüler olarak da adlandırılır) listeler. Bir site belirtmezseniz, sunucu kök siteyi kullanır.

Gerekli parametreler

Yok

İsteğe bağlı parametreler

• siteId: Site Kimliği (varsayılan: kök)

findFileOrFolder

Kullanıcının bir arama sorgusu geçirerek erişebileceği bir dosya veya klasör (DriveItem olarak da adlandırılır) bulur.

Gerekli parametreler

• searchQuery: Tüm veya kısmi dosya adı olabilecek arama sorgusu

renameFileOrFolder

Belirtilen Belge Kitaplığı içindeki bir dosyayı veya klasörü (DriveItems olarak da adlandırılır) yeniden adlandırın. Not: Yeni ad adlandırma kurallarına uygun olmalıdır.

Gerekli parametreler

• documentLibraryId: Belge Kitaplığı Kimliği (dize)
• fileOrFolderId: Dosya veya Klasör Kimliği (dize)
• newFileOrFolderName: Dosya veya klasör için yeni ad (dize)

deleteFileOrFolder

Belirtilen Belge Kitaplığı'ndan bir dosya veya klasör silin.

Gerekli parametreler

• documentLibraryId: Belge Kitaplığı Kimliği (dize)
• fileOrFolderId: Dosya veya Klasör Kimliği (dize)

readSmallTextFile

Belirli bir Belge Kitaplığı'ndan metin dosyasını okuyun (indirin). Belge Kitaplığı belirtmezseniz kullanıcının OneDrive'ı kullanılır. Dosyayı tanımlamak ve indirmek için fileId (bir Dosyanın driveItemId değeri) sağlamanız gerekir.

Gerekli parametreler

• fileId(dize)
• documentLibraryId(dize) – Okumak istediğiniz dosyanın Belge Kitaplığı kimliği (Sürücü olarak da adlandırılır). Kullanıcı sizden sürücüsünde veya Onedrive'ında bir dosyayı okumanızı veya indirmenizi isterse, örneğin " sürücüm" içindeki bir dosyayı okuyun, "onedrive'ım" içindeki bir dosyayı okuyun, "ben" içinde documentLibraryId olarak göndermeniz gerekir.

moveSmallFile

Belirtilen Belge Kitaplığı'nda bulunan bir dosyayı başka bir klasöre taşıyın. Bu araç yalnızca 5 MB'tan küçük dosyalar ve aynı site içindeki taşımalar için taşımayı destekler. Bu isteği kullanarak sürücüler arasında dosya taşıyamazsınız.

Gerekli parametreler

• documentLibraryId(dize) – Taşımak istediğiniz dosyanın Belge Kitaplığı kimliği (Sürücü olarak da adlandırılır). Kullanıcı sizden bir dosyayı sürücüsünde veya Onedrive'ında taşımanızı isterse, örneğin - "Sürücüm"de bir dosyayı taşıma, "onedrive'ım" içindeki bir dosyayı taşıma"yı documentLibraryId olarak "ben" olarak göndermeniz gerekir.
• fileId(dize) – Taşınacak dosyanın kimliği
• newParentFolderId(dize) – Dosyayı taşınacak hedef klasörün kimliği. Dosyanın özgün konumuyla aynı belge kitaplığında olmalıdır.

getFileOrFolderMetadata

Sharepoint Sitesinde belirtilen Belge Kitaplığı'ndan bir dosya veya klasörün meta verilerini alın.

Gerekli parametreler

• FileOrFolderId(dize) – Bir dosyanın veya klasörün kimliği. Bunlar DriveItems olarak da adlandırılır. Ayrıca kimlikleri bazen driveItemId olarak da adlandırılır.
• documentLibraryId(dize) – Meta verilerine ihtiyacınız olan dosya veya klasörün Belge Kitaplığı kimliği (Sürücü olarak da adlandırılır). Kullanıcı sizden sürücüsünde veya Onedrive'ında bir dosya veya klasör almanızı isterse( örneğin, "Sürücümdeki bir dosyanın meta verilerini alma" veya "Onedrive'ımdaki bir klasörün meta verilerini al", "ben" ifadesini documentLibraryId olarak göndermeniz gerekir.

createSmallTextFile

5 MB'tan küçük bir metin dosyası oluşturun veya belirli bir Belge Kitaplığına yükleyin. Belge Kitaplığı belirtmezseniz kullanıcının OneDrive'ı kullanılır. Dosyayı belirli bir klasöre yükleyebilirsiniz. Bir klasör belirtmezseniz, dosya kök klasöre yüklenir.

Gerekli parametreler

• filename (dize) – Oluşturulacak dosyanın adı
• contentText (dize) – Oluşturulacak dosyanın metin içeriği
• documentLibraryId (dize) – Dosya için Belge Kitaplığı kimliği (Sürücü olarak da adlandırılır). Kullanıcı sizden sürücüsünde veya OneDrive'ında "sürücümde dosya oluşturma" veya "onedrive'ımda dosya oluşturma" gibi bir dosya oluşturmanızı isterse documentLibraryId olarak "ben" gönderin.

İsteğe bağlı parametreler

• parentfolderId(string, default = "root") – Yeni dosyayı eklemek için sürücüdeki klasör kimliği.

getFileOrFolderMetadataByUrl

Paylaşım URL'sinden dosya veya klasör için meta veriler alın. Meta verileri yalnızca dosyaya erişmek için açık izinlere sahip kullanıcılar alabilir.

Gerekli parametreler

• fileOrFolderUrl:(dize) – Dosya veya Klasörün URL'si (DriveItems olarak da adlandırılır). Url, kullanıcıyla paylaşmak için kullanılmaz; dosyaya zaten açık erişimi olmalıdır.

shareFileOrFolder

Belirtilen Belge Kitaplığı içindeki bir dosya veya klasör üzerinde izin vermek için paylaşım daveti gönderin. Rol atamayı ve alıcıları bilgilendirmeyi destekler.

Gerekli parametreler

• documentLibraryId: Belge Kitaplığı Kimliği (dize, Gerekli)
• fileOrFolderId: Dosya veya Klasör Kimliği (dize, Gerekli)
• recipientEmails:(string[], Required) – Davet etmek için alıcıların e-posta adresleri. En az bir alıcı e-postası gereklidir.

İsteğe bağlı parametreler

• roles(string[]) – Alıcılara atanacak roller. Kabul edilen değerler: okuma, yazma (yazma hem okuma hem de yazma erişimi verir). Belirtilmezse rolün okunması varsayılandır.
• sendInvitation(bool, default = true) – Paylaşım daveti gönderilip gönderilmeymeyeceğini gösterir. Belirtilmezse varsayılan değer true olur.
• message(string, default = "İşte işbirliği yaptığımız dosya.") – Davet e-postasına eklenecek özel ileti. Belirtilmezse varsayılan olarak standart bir ileti kullanılır.

getFolderChildren

Belge Kitaplığı'nda belirtilen üst klasör içindeki ilk 20 dosya ve klasörü numaralandırır. Belge Kitaplığı belirtmezseniz kullanıcının OneDrive'ı kullanılır.

Gerekli parametreler

• documentLibraryId(dize) – Üst klasör için Belge Kitaplığı kimliği (Sürücü olarak da adlandırılır). Kullanıcı, "sürücümdeki bir klasöre dosya alma" veya "onedrive'ımdaki bir klasöre dosya alma" gibi dosyaları kendi sürücüsünde veya OneDrive'ında bir klasöre almanızı isterse, documentLibraryId olarak "ben" gönderin.

İsteğe bağlı parametreler

• parentFolderId:(string, default = "root") – Dosyaları ve klasörleri listelenen üst klasörün (DriveItem) kimliği. Belirtilmezse Belge Kitaplığı'nın kök klasörünü varsayılan olarak kullanır.

Yankı

İletiyi istemciye geri gönderir.

Gerekli parametreler

• ileti: Geri gönderilecek ileti

setSensitivityLabelOnFile

Belirtilen Belge Kitaplığı'ndan bir dosyanın duyarlılık etiketini ayarlayın.

Gerekli parametreler

• documentLibraryId(dize) – Belge kitaplığının driveId olarak da bilinen belge kitaplığı kimliği
• fileId(dize) – Dosyanın driveItemId olarak da bilinen dosya kimliği
• sensitivityLabelId(dize) – Gerekli. Atanacak duyarlılık etiketinin kimliği veya duyarlılık etiketini kaldırmak için boş dize.

İsteğe bağlı parametreler

• assignmentMethod(string, default = "privileged") - Belgedeki etiketin atama yöntemi. Etiket atamasının otomatik olarak mı, standart mı yoksa ayrıcalıklı bir işlem olarak mı (yönetici işleminin eşdeğeri) yapıldığını gösterir. Olası değerler standart, ayrıcalıklı, otomatik ve unknownFutureValue değerleridir.
• justificationText(dize, varsayılan = "MCPServer tarafından değiştirildi") – İsteğe bağlı. Metinleri denetim amacıyla yaslama ve etiket indirilirken veya kaldırılırken gereklidir.

getDefaultDocumentLibraryInSite

SharePoint Sitesinde varsayılan Belge Kitaplığı'nı (Sürücü olarak da adlandırılır) alın. Bir site belirtmezseniz, kök site kullanılır.

Gerekli parametreler

Yok

İsteğe bağlı parametreler

• siteId: Site Kimliği (varsayılan: kök)

Önemli özellikler

Klasör yönetimi

• Otomatik adlandırma çakışması çözümlemesi ile klasör oluşturma
• Klasör alt öğelerini listeleme (ilk 20)
• Dosyaları klasörler arasında taşıma (aynı site içinde)

Dosya işlemleri

• Küçük metin dosyaları oluşturma ve karşıya yükleme (< 5 MB)
• Metin dosyalarını okuma ve indirme
• Dosya ve klasörleri yedekleme
• Dosya ve klasörleri yedekleme
• Kimlik veya URL'ye göre dosya ve klasör meta verilerini alma

Site ve kitaplık bulma

• Arama sorgusuyla SharePoint sitelerini bulma
• Sitedeki belge kitaplıklarını listeleme
• Varsayılan belge kitaplığını alma

Paylaşım ve izinler

• Rol atamalarıyla dosya ve klasör paylaşma
• Özel iletilerle paylaşım davetleri gönderme
• Açık izinler aracılığıyla erişim denetimi

Güvenlik ve uyumluluk

• Dosyalarda duyarlılık etiketlerini ayarlama
• Ayrıcalıklı, standart ve otomatik atama yöntemleri desteği
• Uyumluluk denetimi için gerekçe metni

Tümleştirme

• OneDrive ve SharePoint Online desteği
• Kiracıya özgü sunucu bağlantısı
• Dosyalar ve klasörler için DriveItem soyutlaması

Notlar

1. Varsayılan Belge Kitaplığı 'ben' (kullanıcının OneDrive'ı)
2. Varsayılan üst klasör 'root'
3. Klasör adı çakışmaları sayısal soneklerle çözümlendi
4. Dosya taşımaları 5 MB'tan az ve aynı site içinde
5. PAYLAŞıM URL'leri için açık erişim izinleri gerekir
6. DriveItems hem dosyaları hem de klasörleri temsil eder
7. Klasör alt listesi için ilk 20 sınır