การอ้างอิงเซิร์ฟเวอร์ MCP ของ Microsoft Teams

สำคัญ

คุณจําเป็นต้องเป็นส่วนหนึ่งของโปรแกรมการแสดงตัวอย่าง Frontier เพื่อเข้าถึง Microsoft Agent 365 ก่อน Frontier เชื่อมต่อคุณโดยตรงกับนวัตกรรม AI ล่าสุดของ Microsoft การแสดงตัวอย่างในส่วนหน้าจะต้องอยู่ภายใต้ข้อกําหนดการแสดงตัวอย่างที่มีอยู่ของข้อตกลงของลูกค้าของคุณ เนื่องจากคุณลักษณะเหล่านี้ยังคงอยู่ในการพัฒนา ความพร้อมใช้งานและความสามารถของพวกเขาอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป

ภาพรวม

ID ของเซิร์ฟเวอร์	ชื่อที่ใช้แสดง	Scope	รายละเอียด
mcp_TeamsServer	เซิร์ฟเวอร์ MCP ของ Microsoft Teams	McpServers.Teams.All	เซิร์ฟเวอร์ MCP ของ Microsoft Teams Graph เพื่อจัดการการสนทนา แชนเนล และผู้ใช้หรือข้อความภายในเซิร์ฟเวอร์ ใช้เซิร์ฟเวอร์ MCP นี้สําหรับการดําเนินงานของ Teams เช่นการสร้าง การอัปเดต และการดึงข้อมูลการสนทนาและการสนทนา การจัดการทีมและช่อง และการดําเนินงานด้านการดูแลระบบที่เกี่ยวข้องกับสิ่งเหล่านี้

เครื่องมือแชท

mcp_graph_chat_addChatMember

จุดสิ้นสุด: โพสต์ /v1.0/chats/{chat-id}/members

เพิ่มสมาชิกลงในการสนทนาโดยใช้ user@odata.bind@odata.typeและบทบาททางเลือก (สมาชิก เจ้าของ) แสดง 409 ถ้าเป็นสมาชิกอยู่แล้ว 400 สําหรับการอ้างอิงผู้ใช้ที่ไม่ถูกต้อง หรือ 403 ถ้านโยบายจํากัดการเพิ่ม

พารามิเตอร์ที่จําเป็น: chat-id, @odata.type, user@odata.bind, บทบาท

mcp_graph_chat_createChat

จุดสิ้นสุด: โพสต์ /v1.0/แชท

สร้างแชทของ Teams ใหม่ด้วย chatType (oneOnOne จําเป็นต้องมีผู้เข้าร่วมสองราย กลุ่มจําเป็นต้องมีมากกว่าสอง) และสมาชิก ส่งกลับ 400 หาก OneOnOne มีจํานวนสมาชิกที่ไม่ถูกต้อง 409 หากผู้เข้าร่วมการสนทนาเดียวกันมีการสนทนาอยู่แล้ว หรือ 403 หากผู้โทรไม่มีสิทธิ์

พารามิเตอร์ที่จําเป็น: chatType สมาชิก

mcp_graph_chat_deleteChat

จุดสิ้นสุด: ลบ /v1.0/การสนทนา/{chat-id}

ลบการสนทนาแบบนุ่มนวล แสดง 403 หากสิทธิ์หายไป 404 ถ้าถูกลบแล้ว และอยู่ภายใต้นโยบายการเก็บข้อมูลของผู้เช่า

พารามิเตอร์ที่จําเป็น: chat-id

mcp_graph_chat_deleteChatMessage

จุดสิ้นสุด: โพสต์ /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

ลบข้อความแชทแบบนุ่มนวล ส่งกลับ 403 โดยไม่มี Chat.ReadWrite, 404 สําหรับ ID ที่ไม่ถูกต้องและอาจยังคงรักษาข้อความสําหรับการปฏิบัติตามกฎระเบียบ

พารามิเตอร์ที่จําเป็น: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

จุดสิ้นสุด: รับ /v1.0/แชท/{chat-id}

เรียกใช้แชทตาม ID โดยส่งคืนเมตาดาต้า เช่น ประเภทและหัวข้อ แสดง 404 หากไม่มีแชทหรือมองไม่เห็น หรือ 403 หากปฏิเสธสิทธิ์

พารามิเตอร์ที่จําเป็น: chat-id

mcp_graph_chat_getChatMessage

จุดสิ้นสุด: รับ /v1.0/แชท/{chat-id}/message/{message-id}

เรียกใช้ข้อความแชทตาม ID แสดง 404 ถ้าข้อความไม่มีอยู่ หรือถูกซ่อน หรือ 403 โดยไม่มีสิทธิ์ที่เหมาะสม

พารามิเตอร์ที่จําเป็น: chat-id, message-id

mcp_graph_chat_listChatMembers

จุดสิ้นสุด: รับ /v1.0/แชท/{chat-id}/members

แสดงรายการผู้เข้าร่วมในแชท แสดงบทบาท (สมาชิก/เจ้าของ/ผู้เยี่ยมชม) ส่งกลับ 403 โดยไม่มีสิทธิ์ในการอ่านหรือ 404 หากไม่พบการสนทนา

พารามิเตอร์ที่จําเป็น: chat-id

mcp_graph_chat_listChatMessages

จุดสิ้นสุด: รับ /v1.0/แชท/{chat-id}/ข้อความ

แสดงรายการข้อความในแชทพร้อม$top $filter และ$orderby ที่เลือกได้ แสดงผลลัพธ์ที่มีหน้า แต่แสดงผลลัพธ์ การปฏิบัติตามกฎระเบียบอาจซ่อนเนื้อหา ข้อผิดพลาดรวม 400 สําหรับคิวรีที่ไม่ดีและ 429 สําหรับการจํากัดผลลัพธ์

พารามิเตอร์ที่จําเป็น: chat-id

พารามิเตอร์ตัวเลือก: $top $filter $orderby

mcp_graph_chat_listChats

จุดสิ้นสุด: รับ /v1.0/แชท

แสดงรายการแชทสําหรับผู้โทรที่มี$top $filter $expand และ$orderby ที่เลือกได้ แสดงเฉพาะการสนทนาที่มองเห็นได้เท่านั้น การสนทนาที่ซ่อนไว้หรือระบบอาจถูกแยกออก แสดง 400 สําหรับนิพจน์การเรียงลําดับที่ไม่ถูกต้อง

พารามิเตอร์ตัวเลือก: $top $orderby $expand $filter

mcp_graph_chat_postMessage

จุดสิ้นสุด: โพสต์ /v1.0/แชท/{chat-id}/ข้อความ

โพสต์ข้อความธรรมดาใหม่ในแชท ต้องการ chat-id และเนื้อความที่ไม่ว่างเปล่า รองรับเฉพาะข้อความเท่านั้น อาจส่งกลับ 429 สําหรับการจํากัดผลลัพธ์ 403 หากสิทธิ์หายไป หรือ 404 หากการแชทไม่ถูกต้อง ไม่เป็นนิจพล - หลีกเลี่ยงการทําซ้ําที่ตาบอด

พารามิเตอร์ที่จําเป็น: chat-id, body

mcp_graph_chat_updateChat

จุดสิ้นสุด: โปรแกรมแก้ไข /v1.0/การสนทนา/{chat-id}

อัปเดตคุณสมบัติการสนทนา เช่น หัวข้อสําหรับการสนทนากลุ่มเท่านั้น ล้มเหลวด้วย 400 หากใช้ในการแชทแบบตัวต่อตัว, 403 โดยไม่มีสิทธิ์หรือ 404 หากไม่พบการสนทนา

พารามิเตอร์ที่จําเป็น: chat-id, topic

mcp_graph_chat_updateChatMessage

จุดสิ้นสุด: โปรแกรมแก้ไข /v1.0/แชท/{chat-id}/message/{message-id}

อัปเดตข้อความแชทด้วยเนื้อหาข้อความธรรมดาใหม่ การแก้ไขอาจถูกบล็อกสําหรับข้อความระบบหรือการปฏิบัติตามกฎระเบียบบางอย่าง แสดง 403 หรือ 400 ถ้าการแก้ไขไม่ได้รับอนุญาต หรือ 409 บนข้อขัดแย้ง

พารามิเตอร์ที่จําเป็น: chat-id, message-id

เครื่องมือของแชนเนลและทีม

mcp_graph_teams_addChannelMember

ตําแหน่งข้อมูล: โพสต์ /v1.0/teams/{team-id}/channel/{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

จุดสิ้นสุด: โพสต์ /v1.0/teams/{team-id}/channel

สร้างช่องในทีมที่มี displayName คําอธิบายตัวเลือก การเป็นสมาชิกชนิด (มาตรฐาน ส่วนตัว แชร์) และสมาชิกทางเลือก ช่องส่วนตัวหรือช่องที่แชร์จําเป็นต้องมีสมาชิกที่ชัดเจน การซ้ําหรือการเป็นสมาชิกที่ไม่ถูกต้องทําให้ 400 หรือ 409

พารามิเตอร์ที่จําเป็น: team-id, displayName

พารามิเตอร์ตัวเลือก: คําอธิบาย ประเภทสมาชิก สมาชิก

mcp_graph_teams_createPrivateChannel

จุดสิ้นสุด: โพสต์ /v1.0/teams/{team-id}/channel

สร้างช่องส่วนตัวพร้อมสมาชิกประเภท: ส่วนตัว ต้องให้สมาชิกต้องสร้าง รวมถึงเจ้าของอย่างน้อยหนึ่งคน แสดง 400 ถ้าสมาชิกหายไป 409 สําหรับชื่อที่ซ้ํากัน หรือ 403 โดยไม่มีสิทธิ์อนุญาต

พารามิเตอร์ที่จําเป็น: team-id, displayName, members

mcp_graph_teams_getChannel

ตําแหน่งข้อมูล: รับ /v1.0/teams/{team-id}/channel/{channel-id}

เรียกใช้ช่องสัญญาณที่มี$select และ$filter ทางเลือก แสดง 404 หากไม่พบช่องหรือผู้เรียกขาดการเข้าถึง 403 หากสิทธิ์ไม่เพียงพอหรือ 400 สําหรับตัวกรองที่ไม่รองรับ

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก: $select $filter

mcp_graph_teams_getTeam

จุดสิ้นสุด: รับ /v1.0/teams/{team-id}

เรียกใช้คุณสมบัติของทีมด้วย$select และ$expand ทางเลือก ส่งกลับ 403 หรือ 404 ถ้าไม่สามารถเข้าถึงทีมได้

พารามิเตอร์ที่จําเป็น: team-id

พารามิเตอร์ตัวเลือก: $select $expand

mcp_graph_teams_listChannelMembers

จุดสิ้นสุด: รับ /v1.0/teams/{team-id}/channel/{channel-id}/members

แสดงรายการสมาชิกทั้งหมดของแชนเนล Microsoft Teams ที่เฉพาะเจาะจง ส่งกลับเมตาดาต้าเกี่ยวกับสมาชิกแต่ละราย เช่น ข้อมูลประจําตัว บทบาท และสถานะการเป็นสมาชิก มีประโยชน์สําหรับการตรวจสอบการเข้าร่วมแชนเนล ตรวจสอบการเป็นสมาชิกก่อนการอัปเดตบทบาท หรือยืนยันการปฏิบัติตามกฎระเบียบ

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก: $top, $expand

mcp_graph_teams_listChannelMessages

จุดสิ้นสุด: รับ /v1.0/teams/{team-id}/channel/{channel-id}/messages

แสดงรายการข้อความในช่องที่มี$top และ$expand ทางเลือก (ตัวอย่างเช่น ข้อความตอบกลับ) จัดการการแบ่งหน้าผ่าน@odata.nextLink แสดง 403 โดยไม่มีสิทธิ์ในการอ่านหรือ 400 สําหรับตัวเลือกคิวรีที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก: $top, $expand

mcp_graph_teams_listChannels

จุดสิ้นสุด: รับ /v1.0/teams/{team-id}/allChannels

แสดงรายการช่องในทีมที่มี$select หรือ$filter ทางเลือก ส่งกลับช่องส่วนตัวและช่องที่แชร์เฉพาะเมื่อผู้โทรเป็นสมาชิกเท่านั้น ล้มเหลวด้วย 403 ถ้าผู้เรียกไม่มีสิทธิ์ในการอ่านหรือ 400 บนคิวรี OData ที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id

พารามิเตอร์ตัวเลือก: $select $filter

mcp_graph_teams_listTeams

จุดสิ้นสุด: รับ /v1.0/users/{user-id}/joinedTeams

แสดงรายการทีมที่เข้าร่วมของผู้ใช้ที่ระบุ ส่งกลับเฉพาะสมาชิกของผู้ใช้รายนั้น ไม่ใช่ทีมผู้เช่าทั้งหมด แสดง 403 ถ้าผู้เรียกไม่สามารถสอบถามผู้ใช้หรือ 404 ถ้า ID ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: user-id

mcp_graph_teams_postChannelMessage

ปลายทาง: โพสต์ /v1.0/teams/{team-id}/channel/{channel-id}/messages

โพสต์ข้อความธรรมดาไปยังช่อง จําเป็นต้องมี team-id, channel-id และ body.content แสดง 403 โดยไม่มี ChannelMessage.Send, 404 ถ้าไม่พบช่อง หรือ 400 ถ้าเนื้อหาหายไป

พารามิเตอร์ที่จําเป็น: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

จุดสิ้นสุด: โพสต์ /v1.0/teams/{team-id}/channel/{channel-id}/message/{message-id}/replies

ตอบกลับข้อความในช่องด้วย body.content รองรับเฉพาะข้อความธรรมดาเท่านั้น แสดง 404 ถ้าไม่พบข้อความหลัก 403 โดยไม่มีสิทธิ์ หรือ 400 สําหรับเนื้อหาที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

จุดสิ้นสุด: โปรแกรมแก้ไข /teams/{team-id}/channel/{channel-id}

อัปเดตช่องด้วย displayName หรือคําอธิบายใหม่ ข้อจํากัดอาจนําไปใช้กับช่องพิเศษ เช่น ทั่วไป ส่งกลับ 403 โดยไม่มีสิทธิ์ 409 บนชื่อที่ซ้ํากัน หรือ 400 สําหรับการป้อนข้อมูลที่ไม่ถูกต้อง

พารามิเตอร์ที่จําเป็น: team-id, channel-id

พารามิเตอร์ตัวเลือก: displayName, description

mcp_graph_teams_updateChannelMember

จุดสิ้นสุด: PATCH /teams/{team-id}/channel/{channel-id}/members/{membership-id}

อัปเดตบทบาทของสมาชิกในช่องส่วนตัวหรือช่องที่แชร์โดยการเปลี่ยนบทบาท ช่องมาตรฐานสืบทอดบทบาทจากทีม และโดยปกติแล้วจะปฏิเสธการอัปเดต แสดง 400 ถ้ามีการพยายามใช้ช่องมาตรฐาน 403 ถ้าไม่ได้รับอนุญาต หรือ 404 ถ้าไม่พบสมาชิก

พารามิเตอร์ที่จําเป็น: team-id, channel-id, membership-id, roles

การดำเนินการที่รองรับ

1. การจัดการการสนทนา (สร้าง อ่าน อัปเดต ลบ)
2. การดําเนินการข้อความ (ส่ง เรียกใช้ แก้ไข ลบ)
3. การจัดการช่องทาง (สร้าง กําหนดค่า รายการ)
4. การจัดการสมาชิก (เพิ่ม อัปเดต รายการ)
5. การดําเนินการของทีม (เรียกใช้ รายการ)

คุณลักษณะสำคัญ

1. การดําเนินการ CRUD เต็มรูปแบบสําหรับการสนทนาและช่อง
2. การสนับสนุนสําหรับช่องส่วนตัว ที่ใช้งานร่วมกัน และช่องมาตรฐาน
3. การเธรดข้อความและการตอบกลับ
4. การจัดการบทบาทของผู้ใช้
5. การสนับสนุนคิวรี OData สําหรับการกรองและการแบ่งหน้า