Takım referansı (önizleme)

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Important

Bu bir önizleme özelliğidir.

• Microsoft, müşterilerin erken erişim elde edebilmesi ve geri bildirim sağlayabilmesi için önizleme özelliklerini resmi bir sürümden önce yayınlar.
• Önizleme özellikleri sınırlı işlevlere sahiptir ve üretim kullanımı için tasarlanmamıştır.
• Microsoft, önizleme MCP araç adlarını ve parametrelerini değiştirebilir. Sabit kodlanmış bağımlılıklardan kaçının. Microsoft senaryo desteğini korur.
• Önizleme özellikleri Microsoft ek kullanım koşullarına tabidir.

Genel Bakış

Sunucu Kimliği	Kiracı düzeyinde URL	Ekran adı	Scope	Description
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	Microsoft Teams’de sohbetleri, kanalları ve bunların içindeki kullanıcıları veya mesajları yönetmeye yönelik araçlar. Sohbet ve sohbet iletileri oluşturma, güncelleştirme ve alma, ekipleri ve kanalları yönetme ve bu görevlerle ilgili yönetim görevlerini gerçekleştirme gibi Teams için bu MCP Sunucusunu kullanın.

Sohbet araçları

mcp_graph_chat_addChatMember

Bitiş noktası:POST /v1.0/chats/{chat-id}/members

user@odata.bind, @odata.type ve isteğe bağlı roller (üye, sahip) kullanılarak sohbete bir üye eklenir. Üye zaten mevcutsa 409 hata kodu, kullanıcı referansları geçersizse 400 hata kodu veya ilkeler eklemeyi kısıtlıyorsa 403 hata kodu döndürür.

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

mcp_graph_chat_createChat

Bitiş noktası:POST /v1.0/chats

chatType ve üyelerle yeni bir Teams sohbeti oluşturur (oneOnOne tam olarak iki katılımcı gerektirir, grup sohbeti ise ikiden fazla katılımcı gerektirir). Yanlış üye sayısına sahipse oneOnOne 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 (Sohbeti sil)

Bitiş noktası:DELETE /v1.0/chats/{chat-id}

Sohbeti geçici olarak siler. İzin eksikse 403 veya zaten silinmişse 404 döndürür. Bu işlemi kiracı bekletme ilkeleri yönetir.

Gerekli parametreler: chat-id

mcp_graph_chat_deleteChatMessage

Bitiş noktası:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Sohbet iletisini geçici olarak siler. Chat.ReadWrite olmadan 403 döndürür, geçersiz kimlikler için 404 döndürür ve uyumluluk nedeniyle mesajı yine de tutabilir.

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

mcp_graph_chat_getChat

Bitiş noktası:GET /v1.0/chats/{chat-id}

Bir sohbeti kimliğine göre getirir. Tür ve konu gibi meta verileri döndürür. Sohbet mevcut değilse veya görünür değilse 404, erişim izni yoksa 403 döndürür.

Gerekli parametreler: chat-id

mcp_graph_chat_getChatMessage

Bitiş noktası:GET /v1.0/chats/{chat-id}/messages/{message-id}

ID ile bir sohbet mesajı alır. İleti yoksa veya gizliyse 404 veya uygun hakları olmayan bir 403 döndürür.

Gerekli parametreler: chat-id, message-id

mcp_graph_chat_sohbetÜyeleriniListele

Bitiş noktası:GET /v1.0/chats/{chat-id}/members

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

Gerekli parametreler: chat-id

mcp_graph_chat_listChatMessages

Bitiş noktası:GET /v1.0/chats/{chat-id}/messages

Sohbetteki iletileri isteğe bağlı $top, $filterve $orderbyile listeler. Sayfalanmış sonuçları döndürür. Uyumluluk içeriği gizleyebilir. Hatalar, hatalı sorgular için 400'ü ve hız sınırlama için 429'u içerir.

Gerekli parametreler: chat-id

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

mcp_graph_chat_listChats

Bitiş noktası:GET /v1.0/chats

Arayan için isteğe bağlı $top, , $filter$expandve $orderbyile 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

Bitiş noktası:POST /v1.0/chats/{chat-id}/messages

Sohbette yeni bir düz metin iletisi yayınlar. chat-id ve boş olmayan body.content gerektirir; yalnızca metin desteklenir. Hız sınırlama için 429, izinler eksikse 403 ya da chat geçersizse 404 döndürebilir. idempotent—avoid Körü körüne yeniden denemeler değil.

Gerekli parametreler: chat-id, gövde

mcp_graph_chat_updateChat

Bitiş noktası: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, yetki yoksa 403 veya sohbet bulunamazsa 404 hatası verir.

Gerekli parametreler: sohbet kimliği, konu

mcp_graph_chat_updateChatMessage

Bitiş noktası: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 düzenlemeyi engeller. Düzenlemeye izin verilmiyorsa işlem 403 veya 400 veya çakışmalar için 409 döndürür.

Gerekli parametreler: chat-id, message-id

Kanal ve Ekip araçları

mcp_graph_teams_addChannelMember

Bitiş noktası:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

user@odata.bind, @odata.type ve isteğe bağlı roller (sahip veya boş) kullanarak özel veya paylaşılan bir kanala üye ekler. Standart kanallarda başarısız olur. Üye zaten mevcutsa 409, gerekli izinler yoksa 403 döndürür.

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

mcp_graph_teams_createChannel

Bitiş noktası:POST /v1.0/teams/{team-id}/channels

Bir 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 için açık üyeler gerekir. Yinelenen veya geçersiz üyelikler 400 veya 409 hatasına yol açar.

Gerekli parametreler: team-id, displayName

İsteğe Bağlı Parametreler: açıklama, üyelikTürü, üyeler

mcp_graph_teams_createPrivateChannel

Bitiş noktası:POST /v1.0/teams/{team-id}/channels

membershipType öğesini private olarak ayarlayarak özel bir kanal oluşturur. Kanalı oluştururken üyeleri eklemeniz ve üye listesinin en az bir sahibi olması gerekir. Üyeler eksikse 400, yinelenen adlar için 409 veya arayan izinlere sahip değilse 403 döndürür.

Gerekli parametreler: team-id, displayName, members

mcp_graph_teams_getChannel

Bitiş noktası:GET /v1.0/teams/{team-id}/channels/{channel-id}

İsteğe bağlı $select ve $filterile 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

Bitiş noktası:GET /v1.0/teams/{team-id}

İsteğe bağlı $select ve $expandile ekip özelliklerini alır. Takıma erişilemiyorsa 403 veya 404 döndürür.

Gerekli parametreler: team-id

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

mcp_graph_teams_listChannelMembers

Bitiş noktası:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Belirli bir Microsoft Teams kanalının tüm üyelerini listeler. Kimlik, roller ve üyelik durumu gibi her üyeyle ilgili meta verileri döndürür. Bu bilgiler kanal katılımını denetlemek, rol güncelleştirmeleri öncesinde üyeliği doğrulamak veya uyumluluğu sağlamak için yararlıdır.

Gerekli parametreler: team-id, channel-id

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

mcp_graph_teams_listChannelMessages

Bitiş noktası:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Kanaldaki iletileri listeler. sonuçları özelleştirmek için isteğe bağlı $top ve $expand parametrelerini kullanın. Örneğin, yanıtları eklemek için kullanın $expand . Sayfalandırma aracılığıyla @odata.nextLink işlenir. Okuma izni yoksa 403, sorgu seçenekleri geçersizse 400 döndürür.

Gerekli parametreler: team-id, channel-id

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

mcp_graph_teams_listChannels

Bitiş noktası:GET /v1.0/teams/{team-id}/allChannels

Ekipteki kanalları listeler. Sonuçları özelleştirmek için isteğe bağlı $select veya $filter parametrelerini kullanın. Özel ve paylaşılan kanalları yalnızca arayan üyeyse döndürür. Çağıranın okuma izinleri yoksa 403 hatası verir, OData sorguları geçersizse 400 hatası verir.

Gerekli parametreler: team-id

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

mcp_graph_teams_listTeams

Bitiş noktası: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

Bitiş noktası: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

Bitiş noktası:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Body.content kullanarak kanaldaki bir iletiyi yanıtlar. Yalnızca düz metin desteklenir. Üst ileti bulunamazsa 404, yetki yoksa 403 veya içerik geçersizse 400 döndürür.

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

mcp_graph_teams_updateChannel

Bitiş noktası:PATCH /teams/{team-id}/channels/{channel-id}

Bir kanalı yeni bir displayName veya açıklamayla günceller. Kısıtlamalar Genel gibi özel kanallar için geçerli olabilir. Gerekli yetkiler yoksa 403, yinelenen adlar için 409 veya geçersiz girdi için 400 döndürür.

Gerekli parametreler: team-id, channel-id

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

mcp_graph_teams_updateChannelMember

Bitiş noktası: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

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

Temel özellikler

• Sohbetler ve kanallar için oluşturma, okuma, güncelleştirme ve silme (CRUD) işlemlerinin tümü.
• Özel, paylaşılan ve standart kanallar için destek.
• İleti dizileri ve yanıtlar.
• Üye rolü yönetimi.
• Filtreleme ve sayfalandırma için OData sorgu desteği.