重要
你需要參加 Frontier 預覽計畫 ，才能搶 先取得 Microsoft Agent 365 的使用權。 Frontier 直接連結你與 Microsoft 最新的 AI 創新。 Frontier 預覽受限於您現有的客戶協議預覽條款。 由於這些功能仍在開發中，其可用性與功能可能會隨時間改變。
概觀
| 伺服器識別碼 | Display name | 範圍 | Description |
|---|---|---|---|
| mcp_TeamsServer | Microsoft Teams MCP 伺服器 | McpServers.Teams.All | Microsoft Teams Graph MCP 伺服器用來管理聊天、頻道，以及其中的使用者或訊息。 使用此 MCP 伺服器處理 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_graph_chat_createChat
端點： POST /v1.0/chats
建立一個新的 Teams 聊天，包含 chatType（oneOnOne 需要恰好兩位參與者，群組則需超過兩位）和成員。 若 oneOnOne 的成員數錯誤，則回傳 400 分;若同一參與者已有聊天，則回傳 409 分;若來電者無權限則回傳 403 分。
必要參數： 聊天類型、成員
mcp_graph_chat_deleteChat
端點： 刪除 /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
刪除聊天訊息。 回傳 403 碼（不含 Chat.ReadWrite），404 碼用於無效 ID，且可能仍保留訊息以符合規定。
所需參數： 使用者識別碼、聊天識別碼、聊天訊息識別碼
mcp_graph_chat_getChat
端點： GET /v1.0/chats/{chat-id}
依 ID 檢索聊天，回傳類型與主題等元資料。 如果聊天視窗不存在或看不到，則回傳 404;如果被拒絕權限，則回傳 403。
必要參數： chat-id
mcp_graph_chat_getChatMessage
端點： 取得 /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
端點： 取得 /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。 不是冪能型——避免盲目重試。
必要參數： chat-id、body（對話識別碼）、身體
mcp_graph_chat_updateChat
端點： PATCH /v1.0/chats/{chat-id}
更新聊天屬性，例如僅限群組聊天的主題。 如果在一對一聊天中使用，會失敗，400 分不合格;沒有權限的話 403 分，聊天室找不到則是 404 分。
必要參數： chat-id、主題
mcp_graph_chat_updateChatMessage
端點： PATCH /v1.0/chats/{chat-id}/messages/{message-id}
更新聊天訊息，新增純文字內容。 編輯可能會因某些系統或合規訊息而被封鎖。 若不允許編輯，則回傳 403 或 400，衝突時則回傳 409。
所需參數： chat-id、message-id
頻道與團隊工具
mcp_graph_teams_addChannelMember
端點： 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
在團隊中建立一個頻道，包含顯示名稱、可選描述、成員類型（標準、私人、共享）及可選成員。 私人或共享頻道需要明確成員;重複或無效會員會導致 400 或 409。
所需參數： team-id、displayName
可選參數： 描述、會員類型、成員
mcp_graph_teams_createPrivateChannel
端點： POST /v1.0/teams/{team-id}/channels
建立一個私人頻道，成員類型：私人。 創建時需成員，且至少擁有一位擁有者。 若缺少成員則回傳 400，重複姓名回傳 409，未授權則回傳 403。
必要參數： 團隊識別碼、顯示名稱、成員
mcp_graph_teams_getChannel
端點： GET /v1.0/teams/{team-id}/channels/{channel-id}
可選用$select和$filter來檢索通道。 若找不到頻道或呼叫者無法存取，則回傳 404;權限不足則回傳 403;對於不支援的過濾器則回傳 400。
所需參數： 團隊識別碼、頻道識別碼
可選參數： $select、$filter
mcp_graph_teams_getTeam
Endpoint： GET /v1.0/teams/{team-id}
可選擇$select與$expand取得團隊屬性。 如果隊伍無法進入，則返回403或404。
所需參數： 隊伍識別碼
可選參數： $select、$expand
mcp_graph_teams_listChannelMembers
端點： GET /v1.0/teams/{team-id}/channels/{channel-id}/members
列出特定 Microsoft Teams 頻道的所有成員，並回傳每個成員的元資料，如身份、角色及會員狀態。 對於審核頻道參與度、在職務更新前驗證會員資格，或確保合規性非常有用。
所需參數： 團隊識別碼、頻道識別碼
可選參數： $top、$expand
mcp_graph_teams_listChannelMessages
端點： GET /v1.0/teams/{team-id}/channels/{channel-id}/messages
在頻道中列出訊息，並可選擇性$top與$expand（例如回覆）。 分頁透過 @odata.nextLink處理。 若無讀取權限，則回傳 403，或因查詢選項無效而回傳 400。
所需參數： 團隊識別碼、頻道識別碼
可選參數： $top、$expand
mcp_graph_teams_listChannels
端點： 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。
必要參數： 使用者識別碼
mcp_graph_teams_postChannelMessage
端點： POST /v1.0/teams/{team-id}/channels/{channel-id}/messages
向頻道發布純文字訊息。 需要 team-id、channel-id 和 body.content。 回傳 403 條（不含 ChannelMessage.Send）、找不到 channel 則回傳 404，或是內容遺失則回傳 400。
所需參數： 隊伍識別碼、頻道識別碼、身體
mcp_graph_teams_replyToChannelMessage
端點： POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replylies
回覆頻道中帶有 body.content 的訊息。 僅支援純文字。 如果找不到父訊息，則回傳 404，沒有權限的 403，或無效內容回傳 400。
所需參數： 團隊識別碼、頻道識別碼、訊息識別碼、正文
mcp_graph_teams_updateChannel
端點： PATCH /teams/{team-id}/channels/{channel-id}
更新頻道，新增顯示名稱或描述。 像一般頻道這類特殊頻道可能會有限制。 回傳 403 但沒有權利，回傳 409 重複名稱，或 400 輸入無效。
所需參數： 團隊識別碼、頻道識別碼
可選參數： displayName、description
mcp_graph_teams_updateChannelMember
端點： PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}
透過變更角色來更新成員在私人或共享頻道中的角色。 標準頻道會繼承團隊的角色，通常會拒絕更新。 嘗試在標準頻道回傳 400，未授權回傳 403，未找到成員則回傳 404。
所需參數： 團隊識別碼、頻道識別碼、會員識別碼、角色
支援的作業
- 聊天管理（建立、閱讀、更新、刪除）
- 訊息操作（傳送、取回、編輯、刪除）
- 通道管理（建立、配置、列表）
- 會員管理（新增、更新、列表）
- 團隊操作（檢索、列表）
主要功能
- 完整的聊天室與頻道 CRUD 作業
- 支援私人、共享及標準頻道
- 訊息串程與回覆
- 使用者角色管理
- OData 查詢支援的篩選與分頁