Microsoft Teams MCP 伺服器參考

概觀

聊天工具

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。

所需參數： 團隊識別碼、頻道識別碼、會員識別碼、角色

支援的作業

1. 聊天管理（建立、閱讀、更新、刪除）
2. 訊息操作（傳送、取回、編輯、刪除）
3. 通道管理（建立、配置、列表）
4. 會員管理（新增、更新、列表）
5. 團隊操作（檢索、列表）

主要功能

1. 完整的聊天室與頻道 CRUD 作業
2. 支援私人、共享及標準頻道
3. 訊息串程與回覆
4. 使用者角色管理
5. OData 查詢支援的篩選與分頁