重要提示
你需要是边境预览计划的一部分，才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随时间而变化。
概述
| 服务器 ID | 显示名称 | Description |
|---|---|---|
| mcp_MeServer | Microsoft 365 用户配置文件 MCP 服务器 | MCP 服务器用于自我知识和组织意识。 使用此 MCP 服务器访问组织中的用户配置文件，并执行各种作，例如获取配置文件、用户配置文件、用户经理或直接报告。 |
可用工具
mcp_graph_getDirectReports
列出目录中指定用户的直接报告。 必须提供用户的对象 ID（GUID）或其 userPrincipalName（类似于电子邮件的 UPN）。 不要使用“me”作为 userIdentifier。
必需参数
- userIdentifier： 用户的对象 ID（GUID）或 userPrincipalName （UPN）
备注
不要将“me”作为 userIdentifier 发送。 如果仅显示名称可用，请先查找用户以获取 userPrincipalName 或对象 ID。
可选参数：
- select： 要返回的属性的逗号分隔列表（例如 id、displayName、mail、jobTitle、userPrincipalName）
- top： 每页要返回的项目数
mcp_graph_getMyManager
检索已登录用户的管理器（调用方）。 USER 始终返回当前上下文的名称。
可选参数：
- select： 要返回的管理器属性的逗号分隔列表
mcp_graph_getMyProfile
检索已登录用户的配置文件详细信息（调用方）。 USER 始终返回当前上下文的名称。
可选参数：
- select： 用户配置文件属性的逗号分隔列表
- expand： Expand related entities （例如，manager， directReports）
mcp_graph_getUserProfile
检索目录中的指定用户配置文件。 必须提供用户的对象 ID（GUID）或其 userPrincipalName（类似于电子邮件的 UPN）。 不要将“me”用作 userIdentifier - 请改用mcp_graph_getMyProfile作为已登录用户。
必需参数
- userIdentifier： 用户的对象 ID（GUID）或 userPrincipalName （UPN）
备注
不要发送'我'。 如果仅显示名称可用，请先查找用户。
可选参数：
- select： 要返回的用户属性的逗号分隔列表
- expand： 展开相关实体（经理或 directReports）。 每个请求只能扩展一个属性。
mcp_graph_getUsersManager
检索目录中指定用户的管理器。 必须提供用户的对象 ID（GUID）或其 userPrincipalName（类似于电子邮件的 UPN）。 不要使用“me”作为 userIdentifier - 请改用mcp_graph_getMyManager作为登录用户。
必需参数
- userIdentifier： 用户的对象 ID（GUID）或 userPrincipalName （UPN）
备注
不要发送'我'。 如果仅显示名称可用，请先查找用户。
可选参数：
- select： 要为管理器返回的属性的逗号分隔列表（例如 id、displayName、mail、jobTitle、userPrincipalName）
mcp_graph_listUsers
获取组织中的用户列表 支持查询选项，例如$select、$filter、$top、$orderby。 ConsistencyLevel 默认设置为最终。
可选参数：
- top： 仅显示前 n 个用户
- select： 要返回的用户属性的逗号分隔列表
- filter： 按属性筛选用户（例如 startswith（displayName，'A'））
- orderby： 按给定属性对结果进行排序（例如 displayName）
- 搜索： 用户的免费文本搜索。 格式：“property：value”，例如“displayName：Neha”，用于搜索包含“Neha”的显示名称。 支持具有空格的多个属性。 回退规则：如果$search失败或不返回任何结果，请自动重试$filter。
- count： 包括项目计数（“true”或“false”）
- ConsistencyLevel： 高级查询所需的标头（默认值：“最终”）
主要功能
自知之明
- 获取已登录用户的个人资料
- 获取已登录用户的经理
- 访问当前用户上下文信息
- 无需用户标识符
用户配置文件
- 按 ID 或 UPN 检索任何用户的配置文件
- 访问用户属性（displayName、mail、jobTitle 等）
- 展开相关实体（经理、directReports）
- 使用 $select 进行属性选择
组织层次结构
- 获取用户的经理
- 获取用户的直接报告
- 导航报告结构
- 经理和直接报表关系
用户发现
- 列出组织中的用户
- 使用自动回退进行自由文本搜索
- OData 筛选和排序
- 分页支持
- 对结果中的用户进行计数
查询功能
- 用于属性选择的 OData $select
- 用于用户筛选的 OData $filter
- 相关实体的 OData $expand
- 用于排序的 OData $orderby
- 带回退的自由文本$search
- 最终一致性支持
注释
- 将mcp_graph_getMyProfile用于登录用户，而不是对“me”进行mcp_graph_getUserProfile
- 将mcp_graph_getMyManager用于登录用户的经理
- userIdentifier 必须是对象 ID （GUID） 或 userPrincipalName （UPN），而不是显示名称
- 如果仅显示名称可用，请使用mcp_graph_listUsers先查找用户
- $expand每个请求只能扩展一个属性（经理或 directReports）
- 如果搜索失败，$search自动回退到$filter
- 高级查询所需的 ConsistencyLevel “最终”
- 搜索格式：带引号的“property：value”
常见用例
获取密钥信息
- 使用mcp_graph_getMyProfile获取当前用户配置文件
- 使用mcp_graph_getMyManager获取当前用户的经理
2.查找用户
将mcp_graph_listUsers与搜索参数配合使用
示例：search='“displayName：John”' 查找名为 John 的用户
从结果中获取 userPrincipalName 或对象 ID
获取用户详情
- 将mcp_graph_getUserProfile与 userIdentifier 配合使用
- 选择“属性”以获取特定详细信息。
- 使用 expand 包括经理或 directReports
关于组织结构
- 使用mcp_graph_getUsersManager获取用户的经理
- 使用mcp_graph_getDirectReports获取用户的直接报告
- 链接调用以导航报表层次结构