Referensi Server MCP Profil Pengguna Microsoft 365

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_MeServer	Server MCP Profil Pengguna Microsoft 365	Server MCP untuk pengetahuan diri dan kesadaran organisasi. Gunakan server MCP ini untuk mengakses profil pengguna di organisasi Anda dan melakukan berbagai tindakan seperti mendapatkan profil Anda, profil pengguna, manajer pengguna, atau laporan langsung.

Alat yang tersedia

mcp_graph_getDirectReports

Mencantumkan laporan langsung pengguna tertentu di direktori. Anda harus memberikan ID objek pengguna (GUID) atau userPrincipalName mereka (UPN seperti email). Jangan gunakan 'saya' sebagai userIdentifier.

Parameter yang diperlukan

• userIdentifier: ID objek pengguna (GUID) atau userPrincipalName (UPN)

Catatan

Jangan kirim 'saya' sebagai userIdentifier. Jika hanya nama tampilan yang tersedia, pertama-tama cari pengguna untuk mendapatkan userPrincipalName atau ID objek.

Parameter opsional

• pilih: Daftar properti yang dipisahkan koma untuk dikembalikan (misalnya, id,displayName,mail,jobTitle,userPrincipalName)
• atas: Jumlah item yang akan dikembalikan per halaman

mcp_graph_getMyManager

Ambil manajer pengguna yang masuk (pemanggil). Titik akhir ini selalu mengembalikan manajer konteks pengguna saat ini.

Parameter opsional

• pilih: Daftar properti manajer yang dipisahkan koma untuk dikembalikan

mcp_graph_getMyProfile

Ambil detail profil pengguna yang masuk (pemanggil). Titik akhir ini selalu mengembalikan profil konteks pengguna saat ini.

Parameter opsional

• pilih: Daftar properti profil pengguna yang dipisahkan koma
• perluas: Perluas entitas terkait (misalnya, manajer, directReports)

mcp_graph_getUserProfile

Ambil profil pengguna tertentu di direktori. Anda harus memberikan ID objek pengguna (GUID) atau userPrincipalName mereka (UPN seperti email). Jangan gunakan 'saya' sebagai userIdentifier - gunakan mcp_graph_getMyProfile sebagai gantinya untuk pengguna yang masuk.

Parameter yang diperlukan

• userIdentifier: ID objek pengguna (GUID) atau userPrincipalName (UPN)

Catatan

Jangan kirim 'saya'. Jika hanya nama tampilan yang tersedia, pertama-tama cari pengguna.

Parameter opsional

• pilih: Daftar properti pengguna yang dipisahkan koma untuk dikembalikan
• perluas: Perluas entitas terkait (manajer ATAU directReports). Anda hanya dapat memperluas satu properti per permintaan.

mcp_graph_getUsersManager

Ambil manajer pengguna tertentu di direktori. Anda harus memberikan ID objek pengguna (GUID) atau userPrincipalName mereka (UPN seperti email). Jangan gunakan 'saya' sebagai userIdentifier - gunakan mcp_graph_getMyManager sebagai gantinya untuk pengguna yang masuk.

Parameter yang diperlukan

• userIdentifier: ID objek pengguna (GUID) atau userPrincipalName (UPN)

Catatan

Jangan kirim 'saya'. Jika hanya nama tampilan yang tersedia, pertama-tama cari pengguna.

Parameter opsional

• pilih: Daftar properti yang dipisahkan koma untuk dikembalikan bagi manajer (misalnya, id,displayName,mail,jobTitle,userPrincipalName)

mcp_graph_listUsers

Ambil daftar pengguna di organisasi. Mendukung opsi kueri seperti $select, $filter, $top, $orderby. ConsistencyLevel diatur ke akhir secara default.

Parameter opsional

• atas: Hanya tampilkan n pengguna pertama
• pilih: Daftar properti pengguna yang dipisahkan koma untuk dikembalikan
• filter: Filter pengguna menurut properti (misalnya mulaidengan(displayName,'A'))
• orderby: Urutkan hasil menurut properti yang diberikan (misalnya displayName)
• search: Pencarian teks bebas untuk pengguna. Format: '"property:value"', misalnya, '"displayName:Neha"' untuk mencari nama tampilan yang berisi 'Neha'. Mendukung beberapa properti dengan spasi. Aturan fallback: Jika $search gagal atau tidak mengembalikan hasil, otomatis coba lagi dengan $filter.
• count: Sertakan jumlah item ('true' atau 'false')
• ConsistencyLevel: Header yang diperlukan untuk kueri tingkat lanjut (default: 'eventual')

Fitur utama

Pengetahuan Mandiri

• Mendapatkan profil pengguna yang masuk
• Mendapatkan manajer pengguna yang masuk
• Mengakses informasi konteks pengguna saat ini
• Tidak perlu pengidentifikasi pengguna

Profil Pengguna

• Mengambil profil pengguna berdasarkan ID atau UPN
• Akses properti pengguna (displayName, mail, jobTitle, dll.)
• Memperluas entitas terkait (manajer, directReports)
• Pilihan properti dengan $select

Hierarki Organisasi

• Mendapatkan manajer pengguna
• Mendapatkan laporan langsung pengguna
• Menavigasi struktur pelaporan
• Manajer dan hubungan laporan langsung

Penemuan Pengguna

• Mencantumkan pengguna dalam organisasi
• Pencarian teks bebas dengan fallback otomatis
• Pemfilteran dan pengurutan OData
• Penomoran halaman yang didukung.
• Menghitung pengguna dalam hasil

Kemampuan utama

• $select OData untuk pemilihan properti
• $filter OData untuk pemfilteran pengguna
• $expand OData untuk entitas terkait
• $orderby OData untuk pengurutan
• Teks bebas $search dengan fallback
• Dukungan konsistensi akhir

Catatan

1. Gunakan mcp_graph_getMyProfile untuk pengguna yang masuk, bukan mcp_graph_getUserProfile dengan 'saya'
2. Menggunakan mcp_graph_getMyManager untuk manajer pengguna yang masuk
3. userIdentifier harus berupa ID objek (GUID) atau userPrincipalName (UPN), bukan nama tampilan
4. Jika hanya nama tampilan yang tersedia, gunakan mcp_graph_listUsers untuk mencari pengguna terlebih dahulu
5. $expand hanya dapat memperluas satu properti per permintaan (manajer ATAU directReports)
6. $search memiliki fallback otomatis ke $filter jika pencarian gagal
7. ConsistencyLevel 'eventual' diperlukan untuk kueri tingkat lanjut
8. Format pencarian: '"property:value"' dengan tanda kutip

Kasus penggunaan umum

Mendapatkan informasi

• Gunakan mcp_graph_getMyProfile untuk mendapatkan profil pengguna saat ini
• Gunakan mcp_graph_getMyManager untuk mendapatkan manajer pengguna saat ini

2. Temukan Pengguna

• Menggunakan mcp_graph_listUsers dengan parameter pencarian

  Contoh: search='"displayName:John"' untuk menemukan pengguna bernama John

• Mendapatkan userPrincipalName atau ID objek dari hasil

3. Dapatkan Detail Pengguna

• Menggunakan mcp_graph_getUserProfile dengan userIdentifier
• Pilih Properti untuk mendapatkan rincian tertentu.
• Gunakan perluas untuk menyertakan manajer atau directReports

4. Dapatkan Struktur Organisasi

• Menggunakan mcp_graph_getUsersManager untuk mendapatkan manajer pengguna
• Menggunakan mcp_graph_getDirectReports untuk mendapatkan laporan langsung pengguna
• Panggilan rantai untuk menavigasi hierarki pelaporan