Teams-referanse (forhåndsvisning)

Bemerkning

Funksjonene i denne artikkelen drives av standardledningsnettet, som bruker faktureringsalternativene beskrevet i Lisensiering for agenter drevet av standardledningsnettet. Lær hvordan du får tilgang til standardfunksjoner i Access standardagenter og agentflyter.

Important

Dette er en forhåndsvisningsfunksjon.

  • Microsoft utgir forhåndsvisningsfunksjoner før en offisiell utgivelse, slik at kundene kan få tidlig tilgang og gi tilbakemelding.
  • Forhåndsvisningsfunksjoner har begrenset funksjonalitet og er ikke ment for produksjonsbruk.
  • Microsoft kan endre mcp-verktøynavn og parametere for forhåndsvisning. Unngå hardkodede avhengigheter. Microsoft opprettholder scenariostøtte.
  • Forhåndsvisningsfunksjoner er underlagt Microsoft ekstra vilkår for bruk.

Oversikt

Server-ID URL på leiernivå Visningsnavn Omfang Beskrivelse
mcp_TeamsServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_TeamsServer
Teams McpServers.Teams.All Microsoft Teams-verktøy for å administrere chatter, kanaler og brukere eller meldinger i dem. Bruk denne MCP-serveren for Teams-operasjoner som å opprette, oppdatere og hente chatter og chattemeldinger, administrere team og kanaler og utføre administrative oppgaver relatert til disse oppgavene.

Chatverktøy

mcp_graph_chat_addChatMember

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

Legger til et medlem i en chat ved hjelp user@odata.bindav , @odata.typeog valgfrie roller (medlem, eier). Returnerer en 409-feilkode hvis medlemmet allerede finnes, en 400-feilkode for ugyldige brukerreferanser eller en 403-feilkode hvis policyer begrenser tillegging.

Obligatoriske parametere: chat-ID, @odata.type, , user@odata.bindroller

mcp_graph_chat_createChat

Endepunkt:POST /v1.0/chats

Oppretter en ny Teams-chat med chatType (oneOnOne krever nøyaktig to deltakere, gruppe krever mer enn to) og medlemmer. Returnerer en 400 hvis oneOnOne har feil medlemsantall, 409 hvis de samme deltakerne allerede har en chat, eller 403 hvis innringeren mangler rettigheter.

Obligatoriske parametere:chatType, medlemmer

mcp_graph_chat_deleteChat

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

Myk sletter en chat. Returnerer en 403 hvis tillatelse mangler eller en 404 hvis den allerede er slettet. Policyer for leieroppbevaring styrer denne operasjonen.

Obligatoriske parametere: chat-ID

mcp_graph_chat_deleteChatMessage

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

Midlertidig sletter en chatmelding. Returnerer en 403 uten Chat.ReadWrite, en 404 for ugyldige IDer, og kan fortsatt beholde meldingen for samsvar.

Obligatoriske parametere: bruker-ID, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Henter en chat etter ID. Returnerer metadata som type og emne. Returnerer en 404 hvis chatten ikke finnes eller ikke er synlig, eller en 403 hvis tillatelser nektes.

Obligatoriske parametere: chat-ID

mcp_graph_chat_getChatMessage

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

Henter en chatmelding med ID. Returnerer en 404 hvis meldingen ikke finnes eller er skjult, eller en 403 uten riktige rettigheter.

Obligatoriske parametere: chat-ID, meldings-ID

mcp_graf_chat_listChatMedlemmer

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

Viser chatdeltakere. Returnerer roller (medlem, eier eller gjest). Returnerer en 403 uten lesetillatelser eller en 404 hvis chat ikke ble funnet.

Obligatoriske parametere: chat-ID

mcp_graph_chat_listChatMessages

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

Viser meldinger i en chat med valgfritt $top, $filterog $orderby. Returnerer sidedelte resultater. Samsvar kan skjule innhold. Feil omfatter 400 for ugyldige spørringer og 429 for struping.

Obligatoriske parametere: chat-ID

Valgfrie parametere:$top, $filter, $orderby

mcp_graph_chat_listSamtaler

Endepunkt:GET /v1.0/chats

Viser chatter for innringeren med valgfri $top, $filter, $expandog $orderby. Returnerer bare synlige chatter. skjulte chatter eller systemchatter kan utelates. Returnerer 400 for ugyldige sorteringsuttrykk.

Valgfrie parametere:$top, $orderby, , $expand$filter

mcp_graph_chat_postMessage

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

Legger inn en ny melding i ren tekst i en chat. Krever chat-id og ikke-tom body.content; kun tekst støttes. Kan returnere en 429 for begrensning, en 403 hvis tillatelser mangler, eller en 404 hvis chat er ugyldig. Ikke idempotent—avoid blinde forsøk på nytt.

Obligatoriske parametere: chat-ID, brødtekst

mcp_graph_chat_updateChat

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

Oppdaterer chategenskaper, for eksempel emnet bare for gruppechatter. Mislykkes med 400 hvis det brukes i en en-til-en-chat, 403 uten rettigheter eller 404 hvis chat ikke blir funnet.

Obligatoriske parametere: chat-ID, emne

mcp_graph_chat_updateChatMessage

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

Oppdaterer en chatmelding med nytt innhold i ren tekst. Enkelte system- eller samsvarsmeldinger blokkerer redigering. Operasjonen returnerer en 403 eller 400 hvis redigering ikke er tillatt, eller en 409 for konflikter.

Obligatoriske parametere: chat-ID, meldings-ID

Kanal- og teamverktøy

mcp_graph_teams_addChannelMember

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

Legger til et medlem i en privat eller delt kanal ved hjelp user@odata.bindav , @odata.typeog valgfrie roller (eier eller tom). Mislykkes på standardkanaler. Returnerer en 409 hvis medlemmet allerede finnes, og en 403 hvis mangler tillatelser.

Obligatoriske parametere: team-ID, kanal-ID, displayName, roller, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Oppretter en kanal i et team med displayName, valgfri beskrivelse membershipType ( standard, privat, delt) og valgfrie medlemmer. Private eller delte kanaler krever eksplisitte medlemmer. Duplikater eller ugyldig medlemskap forårsaker 400 eller 409.

Obligatoriske parametere: team-ID, displayName

Valgfrie parametere: beskrivelse, membershipType, medlemmer

mcp_graph_teams_createPrivateChannel

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

Oppretter en privat kanal ved å angi membershipType til private. Du må inkludere medlemmer når du oppretter kanalen, og medlemslisten må ha minst én eier. Returnerer en 400 hvis medlemmene mangler, en 409 for dupliserte navn, eller en 403 hvis innringeren ikke har tillatelser.

Obligatoriske parametere: team-ID, displayName, medlemmer

mcp_graph_teams_getChannel

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

Henter en kanal med valgfritt $select og $filter. Returnerer en 404 hvis kanalen ikke blir funnet eller innringeren mangler tilgang, en 403 hvis tillatelser er utilstrekkelige, eller en 400 for filtre som ikke støttes.

Obligatoriske parametere: team-ID, kanal-ID

Valgfrie parametere:$select, $filter

mcp_graph_teams_getTeam

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

Henter gruppeegenskaper med valgfritt $select og $expand. Returnerer en 403 eller 404 hvis teamet er utilgjengelig.

Obligatoriske parametere: team-ID

Valgfrie parametere:$select, $expand

mcp_graph_teams_listChannelMembers

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

Viser alle medlemmer av en bestemt Microsoft Teams kanal. Returnerer metadata om hvert medlem, for eksempel identitet, roller og medlemskapsstatus. Denne informasjonen er nyttig for å overvåke kanaldeltakelse, bekrefte medlemskap før rolleoppdateringer eller sikre samsvar.

Obligatoriske parametere: team-ID, kanal-ID

Valgfrie parametere:$top, $expand

mcp_graph_teams_listChannelMessages

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

Viser meldinger i en kanal. Bruk valgfrie $top parametere og $expand parametere til å tilpasse resultatene. Bruk $expand for eksempel til å inkludere svar. Paginering håndteres gjennom @odata.nextLink. Returnerer en 403 uten lesetillatelse eller 400 for ugyldige spørringsalternativer.

Obligatoriske parametere: team-ID, kanal-ID

Valgfrie parametere:$top, $expand

mcp_graph_teams_listChannels

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

Viser kanaler i et team. Bruk valgfrie $select parametere eller $filter parametere til å tilpasse resultatene. Returnerer bare private og delte kanaler hvis innringeren er medlem. Mislykkes med en 403 hvis innringeren mangler leserettigheter eller 400 på ugyldige OData-spørringer.

Obligatoriske parametere: team-ID

Valgfrie parametere:$select, $filter

mcp_graph_teams_listTeams

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

Viser de sammenføyde teamene til en bestemt bruker. Returnerer bare medlemskap for denne brukeren, ikke alle leierteam. Returnerer en 403 hvis innringeren ikke kan spørre brukeren eller en 404 hvis ID-en er ugyldig.

Obligatoriske parametere: bruker-ID

mcp_graph_teams_postChannelMessage

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

Legger inn en melding i ren tekst i en kanal. Krever team-ID, kanal-ID og body.content. Returnerer en 403 uten ChannelMessage.Send, en 404 hvis kanalen ikke ble funnet, eller en 400 hvis innholdet mangler.

Obligatoriske parametere: team-ID, kanal-ID, brødtekst

mcp_graph_teams_replyToChannelMessage

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

Svarer på en melding i en kanal ved hjelp av body.content. Bare ren tekst støttes. Returnerer en 404 hvis den overordnede meldingen ikke blir funnet, en 403 uten rettigheter, eller en 400 for ugyldig innhold.

Obligatoriske parametere: team-ID, kanal-ID, meldings-ID, brødtekst

mcp_graph_teams_updateChannel

Endepunkt:PATCH /teams/{team-id}/channels/{channel-id}

Oppdaterer en kanal med en ny displayName eller beskrivelse. Begrensninger kan gjelde for spesielle kanaler som Generelt. Returnerer en 403 uten rettigheter, en 409 på dupliserte navn, eller en 400 for ugyldige inndata.

Obligatoriske parametere: team-ID, kanal-ID

Valgfrie parametere: displayName, description

mcp_graph_teams_updateChannelMember

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

Oppdaterer et medlems rolle i en privat eller delt kanal ved å endre roller. Standardkanaler arver roller fra teamet og avviser vanligvis oppdateringer. Returnerer en 400 hvis forsøkt på standardkanaler, en 403 hvis uautorisert, eller en 404 hvis medlemmet ikke finner.

Obligatoriske parametere: team-ID, kanal-ID, medlemskap-ID, roller

Støttede operasjoner

  • Chatbehandling (opprette, lese, oppdatere, slette)
  • Meldingsoperasjoner (send, hent, rediger, slett)
  • Kanalbehandling (opprett, konfigurer, liste)
  • Medlemsadministrasjon (legg til, oppdater, liste)
  • Gruppeoperasjoner (hente, liste)

Viktige funksjoner

  • Fullstendige operasjoner for oppretting, lesing, oppdatering og sletting (CRUD) for chatter og kanaler.
  • Støtte for private, delte og standardkanaler.
  • Meldingstråder og svar.
  • Administrasjon av medlemsroller.
  • OData-spørringsstøtte for filtrering og paginering.