Referensi server MCP Microsoft Teams

Penting

Anda harus menjadi bagian dari program pratinjau Frontier untuk mendapatkan akses awal ke Microsoft Agent 365. Frontier menghubungkan Anda langsung dengan inovasi AI terbaru Microsoft. Pratinjau frontier tunduk pada ketentuan pratinjau yang ada dari perjanjian pelanggan Anda. Karena fitur-fitur ini masih dalam pengembangan, ketersediaan dan kemampuannya dapat berubah dari waktu ke waktu.

Ikhtisar

ID Penjual	Nama tampilan	Scope	KETERANGAN
mcp_TeamsServer	Microsoft Teams MCP Server	McpServers.Teams.All	Server MCP Microsoft Teams Graph untuk mengelola obrolan, saluran, dan pengguna atau pesan di dalamnya. Gunakan server MCP ini untuk operasi Teams seperti membuat, memperbarui, dan mengambil obrolan dan pesan obrolan, mengelola tim dan saluran, dan melakukan tugas administratif yang terkait dengan ini.

Alat obrolan

mcp_graph_chat_addChatMember

Titik akhir: POST /v1.0/chats/{chat-id}/members

Menambahkan anggota ke obrolan dengan menggunakan user@odata.bindperan opsional , , @odata.typedan (anggota, pemilik). Mengembalikan 409 jika anggota sudah ada, 400 untuk referensi pengguna yang tidak valid, atau 403 jika kebijakan membatasi penambahan.

Parameter yang diperlukan: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Titik akhir: POST /v1.0/chats

Membuat obrolan Teams baru dengan chatType (oneOnOne membutuhkan tepat dua peserta, grup memerlukan lebih dari dua) dan anggota. Mengembalikan 400 jika oneOnOne memiliki jumlah anggota yang salah, 409 jika peserta yang sama sudah memiliki obrolan, atau 403 jika pemanggil tidak memiliki hak.

Parameter yang diperlukan: chatType, anggota

mcp_graph_chat_deleteChat

Titik akhir: DELETE /v1.0/chats/{chat-id}

Menghapus sementara obrolan. Mengembalikan 403 jika izin hilang, 404 jika sudah dihapus, dan tunduk pada kebijakan retensi penyewa.

Parameter yang diperlukan: chat-id

mcp_graph_chat_deleteChatMessage

Titik akhir: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Menghapus sementara pesan obrolan. Mengembalikan 403 tanpa Chat.ReadWrite, 404 untuk ID yang tidak valid, dan mungkin masih mempertahankan pesan untuk kepatuhan.

Parameter yang diperlukan: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Titik akhir: GET /v1.0/chats/{chat-id}

Mengambil obrolan berdasarkan ID, mengembalikan metadata seperti jenis dan topik. Mengembalikan 404 jika obrolan tidak ada atau tidak terlihat, atau 403 jika izin ditolak.

Parameter yang diperlukan: chat-id

mcp_graph_chat_getChatMessage

Titik akhir: GET /v1.0/chats/{chat-id}/messages/{message-id}

Mengambil pesan obrolan berdasarkan ID. Mengembalikan 404 jika pesan tidak ada atau disembunyikan, atau 403 tanpa hak yang tepat.

Parameter yang diperlukan: chat-id, message-id

mcp_graph_chat_listChatMembers

Titik akhir: GET /v1.0/chats/{chat-id}/members

Mencantumkan peserta obrolan. Mengembalikan peran (anggota/pemilik/tamu). Mengembalikan 403 tanpa izin baca atau 404 jika obrolan tidak ditemukan.

Parameter yang diperlukan: chat-id

mcp_graph_chat_listChatMessages

Titik akhir: GET /v1.0/chats/{chat-id}/messages

Mencantumkan pesan dalam obrolan dengan $top opsional, $filter, dan $orderby. Mengembalikan hasil halaman; kepatuhan dapat menyembunyikan konten. Kesalahan termasuk 400 untuk kueri yang buruk dan 429 untuk pembatasan.

Parameter yang diperlukan: chat-id

Parameter Opsional: $top, $filter, $orderby

mcp_graph_chat_listChats

Titik akhir: GET /v1.0/chats

Mencantumkan obrolan untuk pemanggil dengan $top opsional, $filter, $expand, dan $orderby. Mengembalikan hanya obrolan yang terlihat; obrolan tersembunyi atau sistem mungkin dikecualikan. Mengembalikan 400 untuk ekspresi pengurutan yang tidak valid.

Parameter Opsional: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Titik akhir: POST /v1.0/chats/{chat-id}/messages

Memposting pesan teks biasa baru dalam obrolan. Membutuhkan chat-id dan body.content yang tidak kosong; hanya teks yang didukung. Dapat mengembalikan 429 untuk pembatasan, 403 jika izin hilang, atau 404 jika obrolan tidak valid. Tidak idempotensi—hindari percobaan ulang buta.

Parameter yang diperlukan: id obrolan, isi

mcp_graph_chat_updateChat

Titik akhir: PATCH /v1.0/chats/{chat-id}

Memperbarui properti obrolan, seperti topik untuk obrolan grup saja. Gagal dengan 400 jika digunakan pada obrolan satu-satu, 403 tanpa hak, atau 404 jika obrolan tidak ditemukan.

Parameter yang diperlukan: id obrolan, topik

mcp_graph_chat_updateChatMessage

Titik akhir: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Memperbarui pesan obrolan dengan konten teks biasa baru. Pengeditan mungkin diblokir untuk beberapa pesan sistem atau kepatuhan. Mengembalikan 403 atau 400 jika pengeditan tidak diizinkan, atau 409 pada konflik.

Parameter yang diperlukan: chat-id, message-id

Alat Saluran dan Tim

mcp_graph_teams_addChannelMember

Titik akhir: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Menambahkan anggota ke saluran privat atau bersama dengan user@odata.bindperan opsional , @odata.type, dan (pemilik atau kosong). Gagal pada saluran standar, mengembalikan 409 jika anggota sudah ada, dan 403 jika tidak memiliki izin.

Parameter yang diperlukan: team-id, channel-id, displayName, roles, , user@odata.bind@odata.type

mcp_graph_teams_createChannel

Titik akhir: POST /v1.0/teams/{team-id}/channels

Membuat saluran dalam tim dengan displayName, deskripsi opsional, membershipType (anggota standar, privat, bersama), dan opsional. Saluran privat atau bersama memerlukan anggota eksplisit; duplikat atau keanggotaan yang tidak valid menyebabkan 400 atau 409.

Parameter yang diperlukan: id-tim, displayName

Parameter Opsional: deskripsi, membershipType, anggota

mcp_graph_teams_createPrivateChannel

Titik akhir: POST /v1.0/teams/{team-id}/channels

Membuat saluran privat dengan membershipType: privat. Memerlukan anggota saat pembuatan, termasuk setidaknya satu pemilik. Mengembalikan 400 jika anggota hilang, 409 untuk nama duplikat, atau 403 tanpa izin.

Parameter yang diperlukan: id tim, displayName, anggota

mcp_graph_teams_getChannel

Titik akhir: GET /v1.0/teams/{team-id}/channels/{channel-id}

Mengambil saluran dengan $select opsional dan $filter. Mengembalikan 404 jika saluran tidak ditemukan atau pemanggil tidak memiliki akses, 403 jika izin tidak mencukup, atau 400 untuk filter yang tidak didukung.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional: $select, $filter

mcp_graph_teams_getTeam

Titik akhir: GET /v1.0/teams/{team-id}

Mengambil properti tim dengan $select opsional dan $expand. Mengembalikan 403 atau 404 jika tim tidak dapat diakses.

Parameter yang diperlukan: id-tim

Parameter Opsional: $select, $expand

mcp_graph_teams_listChannelMembers

Titik akhir: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Mencantumkan semua anggota saluran Microsoft Teams tertentu, mengembalikan metadata tentang setiap anggota seperti identitas, peran, dan status keanggotaan. Berguna untuk mengaudit partisipasi saluran, memverifikasi keanggotaan sebelum pembaruan peran, atau memastikan kepatuhan.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional: $top, $expand

mcp_graph_teams_listChannelMessages

Titik akhir: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Mencantumkan pesan dalam saluran dengan $top opsional dan $expand (misalnya, balasan). Penomoran halaman ditangani melalui @odata.nextLink. Mengembalikan 403 tanpa izin baca atau 400 untuk opsi kueri yang tidak valid.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional: $top, $expand

mcp_graph_teams_listChannels

Titik akhir: GET /v1.0/teams/{team-id}/allChannels

Mencantumkan saluran dalam tim dengan $select atau $filter opsional. Mengembalikan saluran privat dan bersama hanya jika penelepon adalah anggota. Gagal dengan 403 jika pemanggil tidak memiliki hak baca atau 400 pada kueri OData yang tidak valid.

Parameter yang diperlukan: id-tim

Parameter Opsional: $select, $filter

mcp_graph_teams_listTeams

Titik akhir: GET /v1.0/users/{user-id}/joinedTeams

Mencantumkan tim gabungan dari pengguna tertentu. Mengembalikan hanya keanggotaan pengguna tersebut, bukan semua tim penyewa. Mengembalikan 403 jika pemanggil tidak dapat mengkueri pengguna atau 404 jika ID tidak valid.

Parameter yang diperlukan: id pengguna

mcp_graph_teams_postChannelMessage

Titik akhir: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Memposting pesan teks biasa ke saluran. Memerlukan team-id, channel-id, dan body.content. Mengembalikan 403 tanpa ChannelMessage.Send, 404 jika saluran tidak ditemukan, atau 400 jika konten hilang.

Parameter yang diperlukan: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

Titik akhir: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Membalas pesan di saluran dengan body.content. Hanya teks biasa yang didukung. Mengembalikan 404 jika pesan induk tidak ditemukan, 403 tanpa hak, atau 400 untuk konten yang tidak valid.

Parameter yang diperlukan: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Titik akhir: PATCH /teams/{team-id}/channels/{channel-id}

Memperbarui saluran dengan displayName atau deskripsi baru. Pembatasan mungkin berlaku untuk saluran khusus seperti Umum. Mengembalikan 403 tanpa hak, 409 pada nama duplikat, atau 400 untuk input yang tidak valid.

Parameter yang diperlukan: team-id, channel-id

Parameter Opsional: displayName, deskripsi

mcp_graph_teams_updateChannelMember

Titik akhir: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Memperbarui peran anggota di saluran privat atau bersama dengan mengubah peran. Saluran standar mewarisi peran dari tim dan biasanya menolak pembaruan. Mengembalikan 400 jika dicoba pada saluran standar, 403 jika tidak sah, atau 404 jika anggota tidak ditemukan.

Parameter yang diperlukan: id tim, id saluran, id keanggotaan, peran

Operasi yang Didukung

1. Manajemen obrolan (membuat, membaca, memperbarui, menghapus)
2. Operasi pesan (kirim, ambil, edit, hapus)
3. Manajemen saluran (membuat, mengonfigurasi, mencantumkan)
4. Manajemen anggota (tambahkan, perbarui, daftar)
5. Operasi tim (ambil, daftar)

Fitur utama

1. Operasi CRUD penuh untuk obrolan dan saluran
2. Dukungan untuk saluran privat, bersama, dan standar
3. Utas dan balasan pesan
4. Manajemen peran pengguna
5. Dukungan kueri OData untuk pemfilteran dan penomoran halaman