Microsoft Teams MCP sunucu başvurusu

Önemli

Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.

Genel bakış

Sunucu Kimliği	Görünen ad	Kapsam	Description
mcp_TeamsServer	Microsoft Teams MCP Sunucusu	McpServers.Teams.All	Microsoft Teams Graph MCP sunucusu; sohbetleri, kanalları ve kullanıcıları veya iletileri yönetmeye yöneliktir. Sohbet ve sohbet iletileri oluşturma, güncelleştirme ve alma, ekipleri ve kanalları yönetme ve bunlarla ilgili yönetim görevlerini gerçekleştirme gibi Teams işlemleri için bu MCP sunucusunu kullanın.

Sohbet araçları

mcp_graph_chat_addChatMember

Uç nokta: POST /v1.0/chats/{chat-id}/members

, @odata.typeve isteğe bağlı rolleri (üye, sahip) kullanarak user@odata.bindsohbete üye ekler. Üye zaten varsa 409, geçersiz kullanıcı başvuruları için 400 veya ilkeler eklemeyi kısıtlarsa 403 döndürür.

Gerekli parametreler: sohbet kimliği, @odata.type, user@odata.bind, roller

mcp_graph_chat_createChat

Uç nokta: POST /v1.0/sohbetler

chatType ile yeni bir Teams sohbeti oluşturur (oneOnOne tam olarak iki katılımcı gerektirir, grup ikiden fazla katılımcı gerektirir) ve üyeler. OneOnOne yanlış üye sayısına sahipse 400, aynı katılımcıların zaten sohbeti varsa 409 veya arayan haklara sahip değilse 403 döndürür.

Gerekli parametreler: chatType, üyeler

mcp_graph_chat_deleteChat

Uç nokta: DELETE /v1.0/chats/{chat-id}

Sohbeti geçici olarak siler. İzin eksikse 403, zaten silinmişse 404 döndürür ve kiracı bekletme ilkelerine tabidir.

Gerekli parametreler: chat-id

mcp_graph_chat_deleteChatMessage

Uç nokta: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Sohbet iletisini geçici olarak siler. Chat.ReadWrite, geçersiz kimlikler için 404 olmadan 403 döndürür ve hala uyumluluk için iletiyi koruyabilir.

Gerekli parametreler: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Uç nokta: GET /v1.0/chats/{chat-id}

Tür ve konu gibi meta verileri döndürerek kimliğe göre bir sohbet alır. Sohbet yoksa veya görünmüyorsa 404 veya izinler reddedilirse 403 döndürür.

Gerekli parametreler: chat-id

mcp_graph_chat_getChatMessage

Uç nokta: GET /v1.0/chats/{chat-id}/messages/{message-id}

Kimliğine göre bir sohbet iletisi alır. İleti yoksa veya gizliyse 404 veya uygun haklar olmadan 403 döndürür.

Gerekli parametreler: chat-id, message-id

mcp_graph_chat_listChatMembers

Uç nokta: GET /v1.0/chats/{chat-id}/members

Sohbet katılımcılarını listeler. Rolleri (üye/sahip/konuk) döndürür. Okuma izinleri olmadan 403 veya sohbet bulunamazsa 404 döndürür.

Gerekli parametreler: chat-id

mcp_graph_chat_listChatMessages

Uç nokta: GET /v1.0/chats/{chat-id}/messages

Sohbetteki iletileri isteğe bağlı $top, $filter ve $orderby listeler. Sayfalanmış sonuçları döndürür; uyumluluk içeriği gizleyebilir. Hatalar arasında hatalı sorgular için 400 ve azaltma için 429 bulunur.

Gerekli parametreler: chat-id

İsteğe Bağlı Parametreler: $top, $filter $orderby

mcp_graph_chat_listChats

Uç nokta: GET /v1.0/chats

İsteğe bağlı $top, $filter, $expand ve $orderby ile arayan için sohbetleri listeler. Yalnızca görünür sohbetleri döndürür; gizli veya sistem sohbetleri dışlanabilir. Geçersiz sıralama ifadeleri için 400 döndürür.

İsteğe Bağlı Parametreler: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Uç nokta: POST /v1.0/chats/{chat-id}/messages

Sohbette yeni bir düz metin iletisi yayınlar. Chat-id ve boş olmayan body.content gerekir; yalnızca metin desteklenir. Azaltma için 429, izinler eksikse 403 veya sohbet geçersizse 404 döndürebilir. Bir kez etkili değildir; kör yeniden denemelerden kaçının.

Gerekli parametreler: chat-id, gövde

mcp_graph_chat_updateChat

Uç nokta: PATCH /v1.0/chats/{chat-id}

Yalnızca grup sohbetleri için konu gibi sohbet özelliklerini güncelleştirir. Bire bir sohbette kullanılırsa 400, haksız 403 veya sohbet bulunamazsa 404 ile başarısız olur.

Gerekli parametreler: sohbet kimliği, konu

mcp_graph_chat_updateChatMessage

Uç nokta: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Sohbet iletisini yeni düz metin içeriğiyle güncelleştirir. Bazı sistem veya uyumluluk iletileri için düzenleme engellenebilir. Düzenlemeye izin verilmiyorsa 403 veya 400 veya çakışmalarda 409 döndürür.

Gerekli parametreler: chat-id, message-id

Kanal ve Ekip araçları

mcp_graph_teams_addChannelMember

Uç nokta: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

, @odata.typeve isteğe bağlı roller (sahip veya boş) ile user@odata.bindözel veya paylaşılan kanala üye ekler. Standart kanallarda başarısız olur, üye zaten varsa 409 ve izinler eksikse 403 döndürür.

Gerekli parametreler: team-id, channel-id, displayName, roles, , user@odata.bind@odata.type

mcp_graph_teams_createChannel

Uç nokta: POST /v1.0/teams/{team-id}/channels

Ekipte displayName, isteğe bağlı açıklama, membershipType (standart, özel, paylaşılan) ve isteğe bağlı üyeler içeren bir kanal oluşturur. Özel veya paylaşılan kanallar açık üyeler gerektirir; yinelenenler veya geçersiz üyelikler 400 veya 409'a neden olur.

Gerekli parametreler: team-id, displayName

İsteğe Bağlı Parametreler: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Uç nokta: POST /v1.0/teams/{team-id}/channels

membershipType: private ile özel bir kanal oluşturur. Oluşturma sırasında en az bir sahip de dahil olmak üzere üyeleri gerektirir. Eksik üyeler varsa 400, yinelenen adlar için 409 veya izinleri olmayan 403 döndürür.

Gerekli parametreler: team-id, displayName, members

mcp_graph_teams_getChannel

Uç nokta: GET /v1.0/teams/{team-id}/channels/{channel-id}

İsteğe bağlı $select ve $filter olan bir kanalı alır. Kanal bulunamazsa veya arayan erişime sahip değilse 404, izinler yetersizse 403 veya desteklenmeyen filtreler için 400 döndürür.

Gerekli parametreler: team-id, channel-id

İsteğe Bağlı Parametreler: $select, $filter

mcp_graph_teams_getTeam

Uç nokta: GET /v1.0/teams/{team-id}

İsteğe bağlı $select ve $expand ile ekip özelliklerini alır. Takım erişilemezse 403 veya 404 döndürür.

Gerekli parametreler: team-id

İsteğe Bağlı Parametreler: $select, $expand

mcp_graph_teams_listChannelMembers

Uç nokta: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Belirli bir Microsoft Teams kanalının tüm üyelerini listeler ve her üye hakkında kimlik, roller ve üyelik durumu gibi meta verileri döndürür. Kanal katılımını denetlemek, rol güncelleştirmeleri öncesinde üyeliği doğrulamak veya uyumluluğu sağlamak için kullanışlıdır.

Gerekli parametreler: team-id, channel-id

İsteğe Bağlı Parametreler: $top, $expand

mcp_graph_teams_listChannelMessages

Uç nokta: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Kanaldaki iletileri isteğe bağlı $top ve $expand (örneğin, yanıtlar) ile listeler. Sayfalandırma aracılığıyla @odata.nextLinkişlenir. Okuma izni olmadan 403 veya geçersiz sorgu seçenekleri için 400 döndürür.

Gerekli parametreler: team-id, channel-id

İsteğe Bağlı Parametreler: $top, $expand

mcp_graph_teams_listChannels

Uç nokta: GET /v1.0/teams/{team-id}/allChannels

İsteğe bağlı $select veya $filter olan ekipteki kanalları listeler. Özel ve paylaşılan kanalları yalnızca arayan üyeyse döndürür. Çağıranın okuma hakları yoksa 403 veya geçersiz OData sorgularında 400 ile başarısız olur.

Gerekli parametreler: team-id

İsteğe Bağlı Parametreler: $select, $filter

mcp_graph_teams_listTeams

Uç nokta: GET /v1.0/users/{user-id}/joinedTeams

Belirli bir kullanıcının katılmış ekiplerini listeler. Tüm kiracı ekiplerini değil, yalnızca o kullanıcının üyeliklerini döndürür. Arayan kullanıcıyı sorgulayamazsa 403 veya kimlik geçersizse 404 döndürür.

Gerekli parametreler: kullanıcı kimliği

mcp_graph_teams_postChannelMessage

Uç nokta: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Kanala düz metin iletisi gönderir. Team-id, channel-id ve body.content gerektirir. ChannelMessage.Send olmadan 403, kanal bulunamazsa 404 veya içerik eksikse 400 döndürür.

Gerekli parametreler: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

Uç nokta: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Body.content içeren bir kanaldaki iletiyi yanıtlar. Yalnızca düz metin desteklenir. Üst ileti bulunamazsa 404, hakları olmayan 403 veya geçersiz içerik için 400 döndürür.

Gerekli parametreler: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Uç nokta: PATCH /teams/{team-id}/channels/{channel-id}

Kanalı yeni displayName veya açıklamayla güncelleştirir. Kısıtlamalar Genel gibi özel kanallar için geçerli olabilir. Hakları olmayan 403, yinelenen adlarda 409 veya geçersiz giriş için 400 döndürür.

Gerekli parametreler: team-id, channel-id

İsteğe Bağlı Parametreler: displayName, description

mcp_graph_teams_updateChannelMember

Uç nokta: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Bir üyenin özel veya paylaşılan kanaldaki rolünü, rolleri değiştirerek güncelleştirir. Standart kanallar ekipten rolleri devralır ve genellikle güncelleştirmeleri reddeder. Standart kanallarda denenirse 400, yetkisizse 403 veya üye bulunamazsa 404 döndürür.

Gerekli parametreler: team-id, channel-id, membership-id, roles

Desteklenen işlemler

1. Sohbet yönetimi (oluşturma, okuma, güncelleştirme, silme)
2. İleti işlemleri (gönderme, alma, düzenleme, silme)
3. Kanal yönetimi (oluşturma, yapılandırma, listeleme)
4. Üye yönetimi (ekleme, güncelleştirme, liste)
5. Ekip işlemleri (alma, listeleme)

Önemli özellikler

1. Sohbetler ve kanallar için tam CRUD işlemleri
2. Özel, paylaşılan ve standart kanallar için destek
3. İleti iş parçacığı oluşturma ve yanıtlar
4. Kullanıcı rolü yönetimi
5. Filtreleme ve sayfalandırma için OData sorgu desteği