Microsoft Teamsin MCP-palvelinviittaus

Tärkeä

Sinun on oltava osa Frontier-esiversio-ohjelmaa, jotta pääset tutustumaan Microsoft Agent 365:een ennen sen käyttöä. Frontier yhdistää sinut suoraan Microsoftin uusimpiin tekoälyinnovaatioihin. Frontier-esiversioita koskevat asiakassopimusten nykyiset esikatseluehdot. Koska nämä ominaisuudet ovat vielä kehitteillä, niiden käytettävyys ja ominaisuudet voivat muuttua ajan mittaan.

Yleiskatsaus

Palvelintunnus	Näyttönimi	Käyttöalue	Description
mcp_TeamsServer	Microsoft Teams MCP Server	McpServers.Teams.All	Microsoft Teamsin Graph MCP -palvelin niiden sisältämien keskustelujen, kanavien ja käyttäjien tai viestien hallintaan. Käytä tätä MCP-palvelinta Teams-toiminnoille, kuten keskusteluiden ja keskusteluviestien luominen, päivittäminen ja noutaminen, tiimien ja kanavien hallinta sekä näihin liittyvien hallintatehtävien suorittaminen.

Keskustelutyökalut

mcp_graph_chat_addChatMember

Päätepiste: POST /v1.0/chats/{chat-id}/members

Lisää jäsenen keskusteluun käyttämällä - user@odata.bind, @odata.type- ja valinnaisia rooleja (jäsen, omistaja). Palauttaa arvon 409, jos jäsen on jo olemassa, 400 virheellisille käyttäjäviittauksille tai 403, jos käytännöt rajoittavat lisäämistä.

Pakolliset parametrit: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Päätepiste: POST /v1.0/chats

Luo uuden Teams-keskustelun chatTypen avulla (oneOnOne edellyttää täsmälleen kaksi osallistujaa, ryhmä vaatii enemmän kuin kaksi) ja jäsenet. Palauttaa arvon 400, jos oneOnOne-kohteen jäsenmäärä on väärä, 409, jos samoilla osallistujilla on jo keskustelu, tai 403, jos soittajalla ei ole oikeuksia.

Pakolliset parametrit: chatType, members

mcp_graph_chat_deleteChat

Päätepiste: POISTA /v1.0/chats/{chat-id}

Poistaa keskustelu pehmeästi. Palauttaa arvon 403, jos käyttöoikeus puuttuu, 404, jos se on jo poistettu, ja se on vuokraajan säilytyskäytäntöjen alainen.

Pakolliset parametrit: chat-id

mcp_graph_chat_deleteChatMessage

Päätepiste: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Poistaa keskusteluviestin pehmeästi. Palauttaa arvon 403 ilman Chat.ReadWrite-tiedostoa, 404 virheellisille tunnuksille, ja se saattaa silti säilyttää sanoman yhteensopivuuden puolesta.

Pakolliset parametrit: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Päätepiste: GET /v1.0/chats/{chat-id}

Noutaa keskustelun tunnuksen mukaan palauttaen metatietoja, kuten tyypin ja aiheen. Palauttaa arvon 404, jos keskustelu ei ole olemassa tai se ei ole näkyvissä, tai arvon 403, jos käyttöoikeudet on estetty.

Pakolliset parametrit: chat-id

mcp_graph_chat_getChatMessage

Päätepiste: GET /v1.0/chats/{chat-id}/messages/{message-id}

Noutaa keskusteluviestin tunnuksen mukaan. Palauttaa arvon 404, jos viestiä ei ole olemassa tai se on piilotettu, tai arvon 403 ilman asianmukaisia oikeuksia.

Pakolliset parametrit: chat-id, message-id

mcp_graph_chat_listChatMembers

Päätepiste: GET /v1.0/chats/{chat-id}/members

Näyttää luettelon keskusteluiden osallistujista. Palauttaa roolit (jäsen/omistaja/vieras). Palauttaa arvon 403 ilman lukuoikeuksia tai 404, jos keskustelusta ei löydy.

Pakolliset parametrit: chat-id

mcp_graph_chat_listChatMessages

Päätepiste: GET /v1.0/chats/{chat-id}/messages

Näyttää luettelon keskusteluviestistä, joka sisältää valinnaisia $top, $filter ja $orderby. Palauttaa sivutetut tulokset. yhteensopivuus saattaa piilottaa sisällön. Virheitä ovat esimerkiksi 400 virheellisille kyselyille ja 429 rajoittamista varten.

Pakolliset parametrit: chat-id

Valinnaiset parametrit: $top, $filter, $orderby

mcp_graph_chat_listChats

Päätepiste: GET /v1.0/chats

Näyttää luettelon soittajan keskusteluista, jotka voivat sisältää valinnaisia $top, $filter, $expand ja $orderby. Palauttaa vain näkyvät keskustelut; piilotettuja tai järjestelmäkeskusteluja voidaan sulkea pois. Palauttaa virheellisille lajittelulausekkeille arvon 400.

Valinnaiset parametrit: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Päätepiste: POST /v1.0/chats/{chat-id}/messages

Julkaisee uuden tekstimuotoisen viestin keskustelussa. Edellyttää chat-id-tunnusta ja ei-tyhjää body.content-sisältöä; vain teksti, jota tuetaan. Voi palauttaa arvon 429 rajoittamisesta, 403, jos oikeuksia puuttuu, tai 404, jos keskustelu on virheellinen. Ei idempotenttia – vältä sokeita uudelleensyistä.

Pakolliset parametrit: chat-id, body

mcp_graph_chat_updateChat

Päätepiste: PATCH /v1.0/chats/{chat-id}

Päivittää keskusteluominaisuudet, kuten vain ryhmäkeskusteluja koskevat ohjeet. Epäonnistuu kun käytössä on 400, jos käytetään yksi yhteen -keskustelulle, 403 ilman oikeuksia tai 404, jos chatia ei löydy.

Pakolliset parametrit: chat-id, topic

mcp_graph_chat_updateChatMessage

Päätepiste: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Päivittää keskusteluviestin uudella tekstimuotoisessa sisällössä. Jotkin järjestelmän tai yhteensopivuuden sanomat saattavat estää muokkaamisen. Palauttaa arvon 403 tai 400, jos muokkausta ei sallita, tai arvon 409 ristiriitojen yhteydessä.

Pakolliset parametrit: chat-id, message-id

Kanava- ja tiimityökalut

mcp_graph_teams_addChannelMember

Päätepiste: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Lisää jäsenen yksityiseen tai jaettuun kanavaan , - ja valinnaisten roolien (omistaja tai tyhjä) kanssauser@odata.bind@odata.type. Epäonnistuu vakiokanavissa, palauttaa arvon 409, jos jäsen on jo olemassa, ja 403, jos käyttöoikeuksia ei ole.

Pakolliset parametrit: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Päätepiste: POST /v1.0/teams/{team-id}/channels

Luo tiimiin kanavan, jossa on displayName, valinnainen kuvaus, jäsenyystyyppi (vakio, yksityinen, jaettu) ja valinnaiset jäsenet. Yksityiset tai jaetut kanavat edellyttävät eksplisiittisiä jäseniä; Kaksoiskappaleet tai virheellinen jäsenyys aiheuttavat luvun 400 tai 409.

Pakolliset parametrit: team-id, displayName

Valinnaiset parametrit: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Päätepiste: POST /v1.0/teams/{team-id}/channels

Luo yksityisen kanavan, jonka jäsenyystyyppi on yksityinen. Edellyttää jäseniä luonnin aikana, mukaan lukien vähintään yksi omistaja. Palauttaa arvon 400, jos jäseniä puuttuu, 409 nimien kaksoiskappaleille tai 403 ilman käyttöoikeuksia.

Pakolliset parametrit: team-id, displayName, members

mcp_graph_teams_getChannel

Päätepiste: GET /v1.0/teams/{team-id}/channels/{channel-id}

Hakee kanavan valinnaisilla $select ja $filter. Palauttaa arvon 404, jos kanavaa ei löydy tai soittajalta puuttuu käyttöoikeus, arvon 403, jos käyttöoikeudet eivät riitä, tai 400 suodattimen, joita ei tueta.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit: $select, $filter

mcp_graph_teams_getTeam

Päätepiste: GET /v1.0/teams/{team-id}

Hakee tiimin ominaisuudet valinnaisilla $select ja $expand. Palauttaa arvon 403 tai 404, jos joukkue ei ole käytettävissä.

Pakolliset parametrit: team-id

Valinnaiset parametrit: $select, $expand

mcp_graph_teams_listChannelMembers

Päätepiste: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Näyttää luettelon tietyn Microsoft Teams -kanavan jäsenistä ja palauttaa metatietoja kustakin jäsenestä, kuten käyttäjätiedot, roolit ja jäsenyyden tilan. Tästä on hyötyä kanavan osallistumisen valvonnan, jäsenyyden tarkistamisen ennen roolipäivityksiä tai yhteensopivuuden varmistamisessa.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit: $top, $expand

mcp_graph_teams_listChannelMessages

Päätepiste: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Näyttää kanavan viestit, jotka voivat sisältää valinnaisia $top ja $expand (esimerkiksi vastauksia). Sivutus käsitellään :n kautta @odata.nextLink. Palauttaa arvon 403 ilman lukuoikeutta tai 400 virheellisille kyselyasetuksille.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit: $top, $expand

mcp_graph_teams_listChannels

Päätepiste: GET /v1.0/teams/{team-id}/allChannels

Näyttää luettelon ryhmän kanavista, joissa on valinnaisia $select tai $filter. Palauttaa yksityiset ja jaetut kanavat vain, jos soittaja on jäsen. Epäonnistuu virheellä 403, jos soittajalta puuttuvat lukuoikeudet tai 400 virheellisille OData-kyselyille.

Pakolliset parametrit: team-id

Valinnaiset parametrit: $select, $filter

mcp_graph_teams_listTeams

Päätepiste: GET /v1.0/users/{user-id}/joinedTeams

Näyttää luettelon tietyn käyttäjän yhdistetyistä tiimeistä. Palauttaa vain kyseisen käyttäjän jäsenyydet, ei kaikkia vuokraajaryhmiä. Palauttaa arvon 403, jos soittaja ei voi tehdä kyselyä käyttäjälle, tai arvon 404, jos tunnus on virheellinen.

Pakolliset parametrit: user-id

mcp_graph_teams_postChannelMessage

Päätepiste: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Julkaisee vain teksti -viestin kanavalle. Edellyttää team-id-, channel-id- ja body.content-parametria. Palauttaa arvon 403 ilman ChannelMessage.Send-tiedostoa, 404, jos kanavaa ei löydy, tai 400, jos sisältöä puuttuu.

Pakolliset parametrit: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

Päätepiste: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/answers

Vastaa viestiin kanavassa, jossa on body.content. Vain pelkkää tekstiä tuetaan. Palauttaa arvon 404, jos pääviestiä ei löydy, 403:n ilman oikeuksia tai 400 virheellisen sisällön osalta.

Pakolliset parametrit: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Päätepiste: PATCH /teams/{team-id}/channels/{channel-id}

Päivittää kanavan, jossa on uusi displayName tai kuvaus. Rajoitukset voivat koskea erikoiskanavia, kuten Yleisiä. Palauttaa arvon 403 ilman oikeuksia, 409 päällekkäisille nimille ja 400 virheellisille syötteille.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit: displayName, description

mcp_graph_teams_updateChannelMember

Päätepiste: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Päivittää jäsenen roolin yksityisessä tai jaetussa kanavassa muuttamalla rooleja. Vakiokanavat perivät rooleja tiimiltä ja hylkäävät päivitykset yleensä. Palauttaa arvon 400, jos on yritetty vakiokanavissa, 403, jos se ei ole sallittua, tai 404, jos jäsentä ei löydy.

Pakolliset parametrit: team-id, channel-id, membership-id, roles

Tuetut toiminnot

1. Keskusteluiden hallinta (luo, lue, päivitä, poista)
2. Viestitoiminnot (lähetä, nouda, muokkaa, poista)
3. Kanavan hallinta (luo, määritä, luettelo)
4. Jäsenten hallinta (lisää, päivitä, luettelo)
5. Ryhmän toiminnot (noutaminen, luettelo)

Tärkeimmät ominaisuudet

1. Täydet CRUD-toiminnot keskusteluille ja kanaville
2. Yksityisten, jaettujen ja vakiokanavien tuki
3. Viestien ketjutus ja vastaukset
4. Käyttäjäroolien hallinta
5. OData-kyselyjen tuki suodattamiselle ja sivutetuille sivutuksille