重要
你需要參加 Frontier 預覽計畫 ，才能搶 先取得 Microsoft Agent 365 的使用權。 Frontier 直接連結你與 Microsoft 最新的 AI 創新。 Frontier 預覽受限於您現有的客戶協議預覽條款。 由於這些功能仍在開發中，其可用性與功能可能會隨時間改變。
概觀
| 伺服器識別碼 | Display name | Description |
|---|---|---|
| mcp_MeServer | Microsoft 365 使用者設定檔 MCP 伺服器 | MCP 伺服器，提供自我認知與組織意識。 利用此 MCP 伺服器存取組織內的使用者設定檔，執行各種操作，例如取得您的個人檔案、使用者個人檔案、使用者經理或直接下屬。 |
可用工具
mcp_graph_getDirectReports
在目錄中列出指定使用者的直接下屬。 你必須提供使用者的物件 ID（GUID）或他們的 userPrincipalName（類似電子郵件的 UPN）。 不要用「me」作為使用者識別碼。
必要參數
- 用戶識別碼： 使用者物件 ID（GUID）或 userPrincipalName （UPN）
注意
不要用 userIdentifier 寄「me」。 若僅有顯示名稱，先查詢使用者以取得 userPrincipalName 或物件 ID。
選用參數。
- 選擇： 以逗號分隔的屬性清單回傳（例如 id、displayName、mail、jobTitle、userPrincipalName）
- 頂部： 每頁需歸還的項目數量
mcp_graph_getMyManager
取得登入使用者的管理者（呼叫者）。 USER 一律會傳回目前內容的名稱。
選用參數。
- 選擇： 以逗號分隔的管理屬性清單，要回傳
mcp_graph_getMyProfile
取得登入使用者（來電者）的個人資料。 USER 一律會傳回目前內容的名稱。
選用參數。
- 選擇： 逗號分隔的使用者設定檔屬性列表
- 展開： 展開相關實體（例如，管理者、directReports）
mcp_graph_getUserProfile
在目錄中取得指定的使用者設定檔。 你必須提供使用者的物件 ID（GUID）或他們的 userPrincipalName（類似電子郵件的 UPN）。 不要用「me」作為使用者識別碼——請用mcp_graph_getMyProfile來表示已登入的使用者。
必要參數
- 用戶識別碼： 使用者物件 ID（GUID）或 userPrincipalName （UPN）
注意
不要派『我』。 如果只有顯示名稱，先查詢使用者名稱。
選用參數。
- 選擇： 以逗號分隔的使用者屬性清單，回傳
- expand： 展開相關實體（管理者或 directReports）。 每次申請只能擴展一個物業。
mcp_graph_getUsersManager
在目錄中取得指定使用者的管理員。 你必須提供使用者的物件 ID（GUID）或他們的 userPrincipalName（類似電子郵件的 UPN）。 不要用「me」作為使用者識別碼——請用 mcp_graph_getMyManager 來表示已登入的使用者。
必要參數
- 用戶識別碼： 使用者物件 ID（GUID）或 userPrincipalName （UPN）
注意
不要派『我』。 如果只有顯示名稱，先查詢使用者名稱。
選用參數。
- 選擇： 以逗號分隔的屬性清單，供管理器回傳（例如 ID、displayName、mail、jobTitle、userPrincipalName）
mcp_graph_listUsers
取得組織中的使用者清單 支援查詢選項如$select、$filter、$top、$orderby。 ConsistencyLevel 預設設為 event。
選用參數。
- 頂部： 僅顯示前 n 位使用者
- 選擇： 以逗號分隔的使用者屬性清單，回傳
- filter： 依屬性篩選使用者（例如 startswith（displayName，'A'））
- orderby： 依據給定屬性（例如 displayName）排序結果
- 搜尋： 使用者的自由文字搜尋。 格式：'“property：value”''，例如「displayName：Neha'' 以搜尋包含 'Neha' 的顯示名稱。 支援多個帶有空格的物件。 備用規則：如果$search失敗或沒有結果，請自動用$filter重試。
- 計數： 包含項目數量（「真」或「假」）
- ConsistencyLevel： 進階查詢必填標頭（預設：「eventual」）
主要功能
自我認知
- 取得已登入使用者的設定檔
- 登入使用者管理員
- 存取目前使用者的情境資訊
- 不需要使用者識別碼
使用者設定檔
- 可依 ID 或 UPN 檢索任何使用者的個人資料
- 存取使用者屬性（displayName、mail、jobTitle 等）
- 展開相關實體（管理者、directReports）
- $select 物業選擇
組織階層
- 取得使用者管理員
- 取得使用者的直接下屬
- 瀏覽報告結構
- 經理與直屬關係
使用者發現
- 在組織中列出使用者
- 具自動備援功能的自由文本搜尋
- OData 過濾與排序
- 分頁支援
- 在結果中計算用戶數
查詢功能
- OData $select房產選擇
- OData $filter用於使用者過濾
- OData $expand相關實體
- OData $orderby用於排序
- 自由文字$search備用
- 最終一致性支援
注意事項
- 用mcp_graph_getMyProfile給已登入的使用者，不要mcp_graph_getUserProfile「我」
- 使用mcp_graph_getMyManager作為登入使用者的管理員
- 使用者識別碼必須是物件 ID（GUID）或 userPrincipalName（UPN），而非顯示名稱
- 如果只有顯示名稱，請先用mcp_graph_listUsers查詢使用者
- $expand每次請求只能擴展一個屬性（管理者或 directReports）。
- 如果搜尋失敗，$search 有自動回退到 $filter
- 進階查詢所需的一致性等級「最終」
- 搜尋格式：「property：value」，並加引號
一般使用案例
取得金鑰資訊
- 使用 mcp_graph_getMyProfile 取得目前使用者的個人資料
- 用mcp_graph_getMyManager取得目前使用者的管理員
2. 尋找使用者
使用帶有搜尋參數的 mcp_graph_listUsers
範例：search='“displayName：John”' 以尋找名為 John 的使用者
從結果取得 userPrincipalName 或物件 ID
取得使用者詳細資料
- 使用mcp_graph_getUserProfile 與 userIdentifier 一起使用
- 選取 [屬性] 以取得特定詳細資料。
- 請使用擴展來包含 manager 或 directReports
組織結構。
- 用 mcp_graph_getUsersManager 取得使用者的管理員
- 用mcp_graph_getDirectReports取得使用者的直接下屬
- 鏈式呼叫以導航報告階層