Note
本文介绍了由 标准线束驱动的代理或代理流中使用的功能。
Important
这是一项预览功能。
- Microsoft正式发布之前发布预览版功能,以便客户能够提前访问并提供反馈。
- 预览功能具有受限的功能,不适用于生产用途。
- Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
- 预览功能受Microsoft补充使用条款的约束。
Note
针对特定应用的 Microsoft 365 MCP 工具(Copilot、日历、邮件、SharePoint、OneDrive、Teams、User 和 Word)仅用于向后兼容,不应用于生产环境或新项目。 对于需要访问 Microsoft 365 资源的新项目,请使用 Work IQ MCP 以及 Microsoft Copilot harness。 更多信息请参见 Copilot Studio 中的 Work IQ MCP。
Overview
| 服务器 ID | 租户级 URL | 显示名称 | Scope | 说明 |
|---|---|---|---|---|
mcp_TeamsServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_TeamsServer |
Teams | McpServers.Teams.All |
Microsoft Teams 工具用于管理聊天、频道以及其中的用户或消息。 使用此 MCP Server 进行 Teams 操作,例如创建、更新和检索聊天和聊天消息、管理团队和频道,以及执行与这些任务相关的管理性任务。 |
聊天工具
mcp_graph_chat_addChatMember
端点:POST /v1.0/chats/{chat-id}/members
使用 user@odata.bind 和 @odata.type 添加成员到聊天中,并可选择设置其角色(成员、所有者)。 如果成员已存在,则返回 409 错误代码、无效用户引用的 400 错误代码;如果策略限制添加,则返回 403 错误代码。
所需参数: chat-id, @odata.type, user@odata.bind, roles
mcp_图表_聊天_创建聊天
终结点:POST /v1.0/chats
创建一个新的Teams聊天,包含chatType和成员。oneOnOne需要恰好两个参与者,群组需要超过两个成员。 如果 oneOnOne 成员计数错误,则返回 400;如果同一参与者已有聊天,则返回 409;如果调用方缺少权限,则返回 403。
所需参数:chatType成员
删除聊天 (mcp_graph_chat_deleteChat)
终结点:DELETE /v1.0/chats/{chat-id}
软删除聊天。 如果权限缺失,则返回 403;如果已删除权限,则返回 404。 租户保留策略控制此操作。
必要参数: chat-id
mcp_graph_chat_deleteChatMessage
端点:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete
软删除聊天消息。 返回一个不带 Chat.ReadWrite403 的 ID,一个 404 表示无效的 ID,并且可能仍保留消息以符合性。
所需参数: user-id, chat-id, chatMessage-id
mcp_graph_chat_getChat
端点:GET /v1.0/chats/{chat-id}
按 ID 检索聊天。 返回类型和主题等元数据。 如果聊天不存在或不可见,则返回 404;如果拒绝权限,则返回 403。
必要参数: chat-id
mcp_graph_chat_getChatMessage
端点:GET /v1.0/chats/{chat-id}/messages/{message-id}
按 ID 检索聊天消息。 如果消息不存在或被隐藏,将返回 404;如果没有适当的权限,将返回 403。
所需参数: chat-id,message-id
mcp_graph_chat_listChatMembers
端点:GET /v1.0/chats/{chat-id}/members
列出聊天参与者 返回角色(成员、所有者或来宾)。 如果未找到聊天,则返回一个没有读取权限的 403 或 404。
必要参数: chat-id
mcp_graph_chat_listChatMessages(聊天消息列表)
终结点:GET /v1.0/chats/{chat-id}/messages
列出聊天中的消息(可选$top、$filter和$orderby)。 返回分页结果。 合规性可能会隐藏内容。 错误包括 400(错误请求)和 429(请求过多)。
必要参数: chat-id
可选参数:$top, $filter, $orderby
mcp_graph_chat_listChats
终结点:GET /v1.0/chats
列出呼叫者的聊天,并提供可选的$top、$filter、$expand和$orderby。 仅返回可见聊天;隐藏或系统聊天可能被排除。 返回状态代码 400 以表示无效的排序表达式。
可选参数:$top, $orderby, $expand, $filter
mcp_graph_chat_postMessage
端点:POST /v1.0/chats/{chat-id}/messages
在聊天中发布新的纯文本消息。 需要 chat-id 和非空 body.content;仅支持文字。 如果因限制则可能返回 429;如果权限缺失则返回 403;如果聊天无效则返回 404。 不是 idempotent—avoid 盲目重试。
所需参数: chat-id,正文
mcp_图形_聊天_更新聊天
终结点:PATCH /v1.0/chats/{chat-id}
更新聊天属性,例如群组聊天中的主题。 如果在一对一聊天上使用 400,则失败;如果没有权限,则为 403;如果未找到聊天,则为 404。
所需参数: chat-id,主题
图形聊天更新聊天消息
终结点:PATCH /v1.0/chats/{chat-id}/messages/{message-id}
使用新的纯文本内容更新聊天消息。 某些系统或合规性消息会阻止编辑。 如果不允许编辑,会返回 403 或 400;发生冲突时,会返回 409。
所需参数: chat-id,message-id
频道和团队工具
mcp_graph_teams_添加频道成员
终端节点:POST /v1.0/teams/{team-id}/channels/{channel-id}/members
使用user@odata.bind、@odata.type以及可选角色(拥有者或空)来将成员添加到私密或共享频道中。 在标准通道上失败。 如果成员已存在,则返回 409;如果缺少权限,则返回 403。
所需参数: team-id、channel-id、displayName、roles、user@odata.bind、@odata.type
mcp_graph_teams_createChannel(创建团队频道)
端点:POST /v1.0/teams/{team-id}/channels
在团队中创建包含 displayName可选说明、 membershipType (标准、专用、共享)和可选成员的频道。 私有或共享通道需要明确指定的成员。 重复或无效的成员身份会导致 400 或 409。
所需参数: team-id,displayName
可选参数: description, membershipType, members
mcp_graph_teams_createPrivateChannel
终结点:POST /v1.0/teams/{team-id}/channels
创建专用频道通过将 membershipType 设置为 private。 创建频道时必须包括成员,并且成员列表必须至少有一个所有者。 如果成员缺失,则返回 400;如果成员缺少重复名称,则返回 409;如果调用方没有权限,则返回 403。
必备参数: team-id、displayName、成员
mcp_graph_teams_getChannel
终结点:GET /v1.0/teams/{team-id}/channels/{channel-id}
检索具有可选$select 和 $filter的通道。 如果未找到通道或呼叫者缺少访问权限时,则返回 404;如果权限不足,则返回 403;对于不支持的筛选器,则返回 400。
所需参数: team-id, channel-id
可选参数:$select$filter
mcp_graph_teams_getTeam
终结点:GET /v1.0/teams/{team-id}
检索团队属性以及可选的 $select 和 $expand。 如果团队无法访问,则返回 403 或 404。
所需参数: team-id
可选参数:$select$expand
mcp_graph_teams_listChannelMembers
终结点:GET /v1.0/teams/{team-id}/channels/{channel-id}/members
列出特定Microsoft Teams通道的所有成员。 返回有关每个成员的元数据,例如标识、角色和成员身份状态。 此信息可用于审核通道参与、在角色更新之前验证成员身份或确保合规性。
所需参数: team-id, channel-id
可选参数:$top$expand
mcp_graph_teams_listChannelMessages
终结点:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages
列出频道中的消息。 使用可选 $top 参数和 $expand 参数自定义结果。 例如,使用 $expand 来包含回复。 分页通过 @odata.nextLink。 对于无效的查询选项,返回一个 403(没有读取权限)或 400。
所需参数: team-id, channel-id
可选参数:$top$expand
mcp_graph_teams_列出频道
终结点:GET /v1.0/teams/{team-id}/allChannels
列出团队中的频道。 使用可选 $select 或 $filter 参数自定义结果。 仅当调用方是成员时,才返回专用通道和共享通道。 如果调用方缺少读取权限,则返回 403;如果 OData 查询无效,则返回 400。
所需参数: 队伍编号
可选参数:$select$filter
mcp_graph_teams_listTeams
端点:GET /v1.0/users/{user-id}/joinedTeams
显示特定用户已加入的团队。 仅返回该用户的成员身份,而不是所有租户团队。 如果调用方无法查询用户,则返回 403;如果 ID 无效,则返回 404。
所需参数: 用户ID
mcp_graph_teams_postChannelMessage
终结点:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages
将纯文本消息发布到频道。 需要 team-id、channel-id 和 body.content。 返回一个没有 ChannelMessage.Send 的 403;如果未找到通道,则返回 404;如果缺少内容,则返回 400。
所需参数: 团队ID、频道ID、正文
mcp_graph_teams_replyToChannelMessage
终结点:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
使用 body.content 回复通道中的消息。 仅支持纯文本。 如果未找到父消息,则返回 404;如果没有权限,则返回 403;如果内容无效,则返回 400。
所需参数: 团队ID、频道ID、消息ID、正文
mcp_graph_teams_updateChannel
终结点:PATCH /teams/{team-id}/channels/{channel-id}
使用新displayName或新描述更新频道。 像 普通频道这样的特殊频道可能会受到限制。 返回一个没有权限的 403,对重复名称返回 409,或者返回 400 表示无效输入。
所需参数: 团队ID,频道ID。
可选参数: displayName, description
mcp_graph_teams_updateChannelMember(更新团队频道成员)
终结点:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}
通过更改角色更新成员在专用或共享频道中的角色。 标准频道会从团队继承角色,并且通常会拒绝更新。 如果在标准通道上尝试,则返回 400;如果未授权,则返回 403;如果未找到成员,则返回 404。
所需参数: 团队ID、频道ID、成员ID、角色
支持的操作
- 聊天管理(创建、读取、更新、删除)
- 消息操作(发送、获取、编辑、删除)
- 频道管理(创建、配置、列出)
- 成员管理(添加、更新、列表)
- 团队操作(检索、列出)
主要功能
- 对聊天和频道执行完整的创建、读取、更新和删除(CRUD)操作。
- 支持专用、共享和标准通道。
- 消息线程和回复。
- 成员角色管理。
- OData 查询支持筛选和分页。