Microsoft 365 Kullanıcı Profili 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_MeServer	Microsoft 365 Kullanıcı Profili MCP Sunucusu	Kendi kendine bilgi ve kuruluş farkındalığı için MCP sunucusu. Kuruluşunuzdaki kullanıcı profillerine erişmek ve profilinizi, kullanıcının profilini, kullanıcının yöneticisini veya doğrudan raporları alma gibi çeşitli eylemleri gerçekleştirmek için bu MCP sunucusunu kullanın.

Kullanılabilir araçlar

mcp_graph_getDirectReports

Dizinde belirtilen kullanıcının doğrudan raporlarını listeleyin. Kullanıcının nesne kimliğini (GUID) veya userPrincipalName değerini (e-posta benzeri UPN) sağlamanız gerekir. userIdentifier olarak 'ben' kullanmayın.

Gerekli parametreler

• userIdentifier: Kullanıcının nesne kimliği (GUID) veya userPrincipalName (UPN)

Not

'me' öğesini userIdentifier olarak göndermeyin. Yalnızca görünen ad kullanılabiliyorsa, önce userPrincipalName veya nesne kimliğini almak için kullanıcıyı arayın.

İsteğe bağlı parametreler

• select: Döndürülecek özelliklerin virgülle ayrılmış listesi (örneğin, id,displayName,mail,jobTitle,userPrincipalName)
• top: Sayfa başına döndürülecek öğe sayısı

mcp_graph_getMyManager

Oturum açmış kullanıcının (arayan) yöneticisini alın. Bu uç nokta her zaman geçerli kullanıcı bağlamının yöneticisini döndürür.

İsteğe bağlı parametreler

• select: Döndürülecek yönetici özelliklerinin virgülle ayrılmış listesi

mcp_graph_getMyProfile

Oturum açmış kullanıcının (arayan) profil ayrıntılarını alın. Bu uç nokta her zaman geçerli kullanıcı bağlamının profilini döndürür.

İsteğe bağlı parametreler

• select: Kullanıcı profili özelliklerinin virgülle ayrılmış listesi
• expand: İlgili varlıkları genişletme (örneğin, yönetici, directReports)

mcp_graph_getUserProfile

Dizinde belirtilen kullanıcının profilini alın. Kullanıcının nesne kimliğini (GUID) veya userPrincipalName değerini (e-posta benzeri UPN) sağlamanız gerekir. UserIdentifier olarak 'ben' kullanmayın; oturum açmış kullanıcı için bunun yerine mcp_graph_getMyProfile kullanın.

Gerekli parametreler

• userIdentifier: Kullanıcının nesne kimliği (GUID) veya userPrincipalName (UPN)

Not

"Beni" gönderme. Yalnızca görünen ad kullanılabiliyorsa, önce kullanıcıyı arayın.

İsteğe bağlı parametreler

• select: Döndürülecek kullanıcı özelliklerinin virgülle ayrılmış listesi
• expand: İlgili bir varlığı (yönetici VEYA directReports) genişletin. İstek başına yalnızca bir özelliği genişletebilirsiniz.

mcp_graph_getUsersManager

Dizinde belirtilen kullanıcının yöneticisini alın. Kullanıcının nesne kimliğini (GUID) veya userPrincipalName değerini (e-posta benzeri UPN) sağlamanız gerekir. UserIdentifier olarak 'ben' kullanmayın; oturum açmış kullanıcı için bunun yerine mcp_graph_getMyManager kullanın.

Gerekli parametreler

• userIdentifier: Kullanıcının nesne kimliği (GUID) veya userPrincipalName (UPN)

Not

"Beni" gönderme. Yalnızca görünen ad kullanılabiliyorsa, önce kullanıcıyı arayın.

İsteğe bağlı parametreler

• select: Yönetici için döndürülecek özelliklerin virgülle ayrılmış listesi (örn. kimlik,displayName,posta,jobTitle,userPrincipalName)

mcp_graph_listUsers

Kuruluştaki kullanıcıların listesini alın. $select, $filter, $top $orderby gibi sorgu seçeneklerini destekler. ConsistencyLevel varsayılan olarak nihai olarak ayarlanır.

İsteğe bağlı parametreler

• top: Yalnızca ilk n kullanıcıyı göster
• select: Döndürülecek kullanıcı özelliklerinin virgülle ayrılmış listesi
• filter: Kullanıcıları özelliğe göre filtreleyin (örn. startswith(displayName,'A'))
• orderby: Verilen özelliğe göre sonuçları sıralama (örn. displayName)
• search: Kullanıcılar için serbest metin araması. Biçim: '"property:value"', örneğin, '"displayName:Neha"', 'Neha' içeren görünen adları aramak için. Boşluklarla birden çok özelliği destekler. Geri dönüş kuralı: $search başarısız olursa veya sonuç döndürmezse $filter ile otomatik olarak yeniden deneyin.
• count: Öğe sayısını ekle ('true' veya 'false')
• ConsistencyLevel: Gelişmiş sorgular için gerekli üst bilgi (varsayılan: 'nihai')

Önemli özellikler

Kendi Kendine Bilgi

• Oturum açmış kullanıcının profilini alma
• Oturum açmış kullanıcının yöneticisini alma
• Geçerli kullanıcı bağlam bilgilerine erişme
• Kullanıcı tanımlayıcılarına gerek yok

Kullanıcı Profili

• Herhangi bir kullanıcının profilini kimliğe veya UPN'ye göre alma
• Kullanıcı özelliklerine (displayName, posta, jobTitle vb.) erişme
• İlgili varlıkları genişletme (yönetici, directReports)
• $select ile özellik seçimi

Kuruluş hiyerarşisi

• Kullanıcının yöneticisini listele.
• Kullanıcının doğrudan raporlarını alma
• Raporlama yapısında gezinme
• Yönetici ve doğrudan rapor ilişkileri

Kullanıcı Bulma

• Kuruluştaki kullanıcıları listeleme
• Otomatik geri dönüş ile serbest metin araması
• OData filtreleme ve sıralama
• Sayfalandırma desteği
• Sonuçlardaki kullanıcıları sayma

Önemli Özellikler

• Özellik seçimi için OData $select
• Kullanıcı filtrelemesi için OData $filter
• İlgili varlıklar için OData $expand
• Sıralama için OData $orderby
• Geri dönüşlü serbest metin $search
• Nihai tutarlılık desteği

Notlar

1. 'ben' ile mcp_graph_getUserProfile değil, oturum açmış kullanıcı için mcp_graph_getMyProfile kullanın
2. Oturum açmış kullanıcının yöneticisi için mcp_graph_getMyManager kullanma
3. userIdentifier, görünen ad değil nesne kimliği (GUID) veya userPrincipalName (UPN) olmalıdır
4. Yalnızca görünen ad varsa, önce kullanıcıyı aramak için mcp_graph_listUsers kullanın
5. $expand istek başına yalnızca bir özelliği genişletebilir (yönetici VEYA directReports)
6. $search arama başarısız olursa $filter otomatik geri dönüşe sahip olur
7. Gelişmiş sorgular için ConsistencyLevel 'nihai' gerekli
8. Arama biçimi: Tırnak işaretleri içeren '"property:value"'

Yaygın kullanım örnekleri

Bilgi alma

• Geçerli kullanıcının profilini almak için mcp_graph_getMyProfile kullanma
• Geçerli kullanıcının yöneticisini almak için mcp_graph_getMyManager kullanma

2. Kullanıcı Bul

• arama parametresiyle mcp_graph_listUsers kullanma

  Örnek: John adlı kullanıcıları bulmak için search='"displayName:John"'

• Sonuçlardan userPrincipalName veya nesne kimliği alma

3. Kullanıcı Ayrıntılarını Alma

• userIdentifier ile mcp_graph_getUserProfile kullanma
• Belirli ayrıntıları almak için Özellikler'i seçin.
• Yönetici veya directReports eklemek için genişletmeyi kullanma

Kuruluş yapısı.

• Kullanıcının yöneticisini almak için mcp_graph_getUsersManager kullanma
• Kullanıcının doğrudan raporlarını almak için mcp_graph_getDirectReports kullanma
• Raporlama hiyerarşisinde gezinmek için çağrıları zincirleme