Work IQ Teams-reference (prøveversion)

Vigtig

Dette er en prøveversionsfunktion.

  • Microsoft udgiver prøveversionsfunktioner før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
  • Prøveversionsfunktioner har begrænset funktionalitet og er ikke beregnet til produktionsbrug.
  • Microsoft kan ændre navne og parametre for MCP-værktøjer i forhåndsversion. Undgå hardkodede afhængigheder. Microsoft vedligeholder scenariesupport.
  • Prøveversionsfunktioner er underlagt Microsoft supplerende vilkår for anvendelse.
Server-ID URL-adresse på lejerniveau Vis navn Omfanget Beskrivelse
mcp_TeamsServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_TeamsServer
Work IQ Teams McpServers.Teams.All Microsoft Teams Graph MCP-server til administration af chats, kanaler og brugere eller meddelelser i dem. Brug denne MCP Server til Teams-handlinger, f.eks. oprettelse, opdatering og hentning af chats og chatmeddelelser, administration af teams og kanaler og udførelse af administrative opgaver, der er relateret til disse opgaver.

Chatværktøjer

mcp_graph_chat_addChatMember

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

Føjer et medlem til en chat ved hjælp user@odata.bindaf , @odata.typeog valgfri roller (medlem, ejer). Returnerer en 409-fejlkode, hvis medlemmet allerede findes, en 400-fejlkode for ugyldige brugerreferencer eller en 403-fejlkode, hvis politikker begrænser tilføjelse.

Påkrævede parametre: chat-id, @odata.type, , user@odata.bindroller

mcp_graph_chat_createChat

Slutpunkt:POST /v1.0/chats

Opretter en ny Teams-chat med chatType (oneOnOne kræver præcis to deltagere, gruppe kræver mere end to) og medlemmer. Returnerer en 400, hvis oneOnOne har det forkerte medlemsantal, 409, hvis de samme deltagere allerede har en chat, eller 403, hvis den, der ringer op, ikke har rettigheder.

Obligatoriske parametre:chatType, medlemmer

mcp_graph_chat_deleteChat

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

Midlertidigt sletter en chat. Returnerer en 403, hvis der mangler en tilladelse, eller en 404, hvis den allerede er slettet. Lejeropbevaringspolitikker styrer denne handling.

Påkrævede parametre: chat-id

mcp_graph_chat_deleteChatMessage

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

Udfører en midlertidig sletning af en chatmeddelelse. Returnerer en 403 uden Chat.ReadWrite, en 404 for ugyldige id'er og bevarer muligvis stadig meddelelsen for overholdelse af angivne standarder.

Obligatoriske parametre: bruger-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Henter en chat ud fra id'et. Returnerer metadata som type og emne. Returnerer en 404, hvis chatten ikke findes eller ikke er synlig, eller en 403, hvis tilladelser afvises.

Påkrævede parametre: chat-id

mcp_graph_chat_getChatMessage

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

Henter en chatmeddelelse efter id. Returnerer en 404, hvis meddelelsen ikke findes eller er skjult, eller en 403 uden de rette rettigheder.

Påkrævede parametre: chat-id, meddelelses-id

mcp_graph_chat_listChatMembers

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

Viser chatdeltagere. Returnerer roller (medlem, ejer eller gæst). Returnerer en 403 uden læserettigheder eller 404, hvis chat ikke blev fundet.

Påkrævede parametre: chat-id

mcp_graph_chat_listChatMessages

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

Viser meddelelser i en chat med valgfri $top, $filterog $orderby. Returnerer sideopdelte resultater. Overholdelse kan skjule indhold. Fejl omfatter blandt andet en 400 for ugyldige forespørgsler og en 429 for hastighedsbegrænsning.

Påkrævede parametre: chat-id

Valgfrie parametre:$top, $filter, $orderby

mcp_graph_chat_listChats

Slutpunkt:GET /v1.0/chats

Viser chats for den, der ringer op, med valgfri $top, $filter, $expandog $orderby. Returnerer kun synlige chats. skjulte chats, eller systemchats kan blive udelukket. Returnerer en 400 for ugyldige sorteringsudtryk.

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

mcp_graph_chat_postMessage

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

Sender en ny almindelig tekstmeddelelse i en chat. Har brug for chat-id og nonempty body.content; understøttes kun tekst. Returnerer muligvis en 429 for begrænsning, en 403, hvis der mangler tilladelser, eller en 404, hvis chat er ugyldig. Ikke idempotent—avoid blinde gentagelsesforsøg.

Påkrævede parametre: chat-id, brødtekst

mcp_graph_chat_updateChat

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

Opdaterer chategenskaber, f.eks. kun emnet for gruppechat. Mislykkes med 400, hvis det bruges på en en-til-en-chat, 403 uden rettigheder eller 404, hvis chat ikke blev fundet.

Obligatoriske parametre: chat-id, emne

mcp_graph_chat_updateChatMessage

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

Opdaterer en chatmeddelelse med nyt indhold i almindelig tekst. Nogle system- eller overholdelsesmeddelelser blokerer redigering. Handlingen returnerer en 403 eller 400, hvis redigering ikke er tilladt, eller en 409 for konflikter.

Påkrævede parametre: chat-id, meddelelses-id

Værktøjer til kanal og team

mcp_graph_teams_addChannelMember

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

Føjer et medlem til en privat eller delt kanal ved hjælp user@odata.bindaf , @odata.typeog valgfri roller (ejer eller tom). Mislykkes på standardkanaler. Returnerer en 409, hvis medlemmet allerede findes, og en 403, hvis der mangler tilladelser.

Påkrævede parametre: team-id, kanal-id, displayName, roller, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Opretter en kanal i et team med displayNamevalgfri beskrivelse (standard, membershipType privat, delt) og valgfrie medlemmer. Private eller delte kanaler kræver eksplicitte medlemmer. Dubletter eller ugyldigt medlemskab medfører en 400 eller 409.

Obligatoriske parametre: team-id, displayName

Valgfri parametre: beskrivelse, medlemskabType, medlemmer

mcp_graph_teams_createPrivateChannel

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

Opretter en privat kanal ved at angive membershipType til private. Du skal inkludere medlemmer, når du opretter kanalen, og medlemslisten skal have mindst én ejer. Returnerer en 400, hvis medlemmerne mangler, en 409 for dublerede navne eller en 403, hvis den, der ringer op, ikke har tilladelser.

Obligatoriske parametre: team-id, displayName, medlemmer

mcp_graph_teams_getChannel

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

Henter en kanal med valgfri $select og $filter. Returnerer en 404, hvis kanalen ikke findes, eller den, der ringer op, mangler adgang, en 403, hvis tilladelserne ikke er tilstrækkelige, eller en 400 for filtre, der ikke understøttes.

Påkrævede parametre: team-id, channel-id

Valgfrie parametre:$select, $filter

mcp_graph_teams_getTeam

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

Henter teamegenskaber med valgfri $select og $expand. Returnerer en 403 eller 404, hvis teamet ikke er tilgængeligt.

Obligatoriske parametre: team-id

Valgfrie parametre:$select, $expand

mcp_graph_teams_listChannelMembers

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

Viser alle medlemmer af en bestemt Microsoft Teams kanal. Returnerer metadata om hvert enkelt medlem, f.eks. identitet, roller og medlemskabsstatus. Disse oplysninger er nyttige til overvågning af kanaldeltagelse, bekræftelse af medlemskab før rolleopdateringer eller sikring af overholdelse.

Påkrævede parametre: team-id, channel-id

Valgfrie parametre:$top, $expand

mcp_graph_teams_listChannelMessages

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

Viser meddelelser i en kanal. Brug de valgfrie $top parametre og $expand til at tilpasse resultaterne. Brug f.eks $expand . til at inkludere svar. Sideinddeling håndteres via @odata.nextLink. Returnerer en 403 uden læsetilladelse eller 400 for ugyldige forespørgselsindstillinger.

Påkrævede parametre: team-id, channel-id

Valgfrie parametre:$top, $expand

mcp_graph_teams_listChannels

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

Viser kanaler i et team. Brug de valgfrie $select parametre eller $filter til at tilpasse resultaterne. Returnerer kun private og delte kanaler, hvis den person, der ringer op, er medlem. Mislykkes med en 403, hvis kalderen mangler læserettigheder eller 400 på ugyldige OData-forespørgsler.

Obligatoriske parametre: team-id

Valgfrie parametre:$select, $filter

mcp_graph_teams_listTeams

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

Viser en liste over en bestemt brugers joinforbundne teams. Returnerer kun medlemskaber af den pågældende bruger, ikke alle lejerteams. Returnerer en 403, hvis kalderen ikke kan forespørge brugeren, eller en 404, hvis id'et er ugyldigt.

Obligatoriske parametre: bruger-id

mcp_graph_teams_postChannelMessage

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

Sender en meddelelse i almindelig tekst til en kanal. Kræver team-id, kanal-id og body.content. Returnerer en 403 uden ChannelMessage.Send, en 404, hvis kanalen ikke blev fundet, eller en 400, hvis indholdet mangler.

Obligatoriske parametre: team-id, kanal-id, brødtekst

mcp_graph_teams_replyToChannelMessage

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

Svarer på en meddelelse i en kanal ved hjælp af body.content. Kun almindelig tekst understøttes. Returnerer en 404, hvis den overordnede meddelelse ikke findes, en 403 uden rettigheder eller en 400 for ugyldigt indhold.

Påkrævede parametre: team-id, kanal-id, meddelelses-id, brødtekst

mcp_graph_teams_updateChannel

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

Opdaterer en kanal med en ny displayName eller beskrivelse. Der kan være begrænsninger for særlige kanaler, f.eks. Generelt. Returnerer en 403 uden rettigheder, en 409 på dubletnavne eller en 400 for ugyldigt input.

Påkrævede parametre: team-id, channel-id

Valgfrie parametre: displayName, beskrivelse

mcp_graph_teams_opdaterKanalMedlem

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

Opdaterer et medlems rolle i en privat eller delt kanal ved at ændre roller. Standardkanaler nedarver roller fra teamet og afviser normalt opdateringer. Returnerer en 400, hvis det forsøges på standardkanaler, en 403, hvis uautoriseret, eller en 404, hvis medlemmet ikke blev fundet.

Påkrævede parametre: team-id, kanal-id, medlemskabs-id, roller

Understøttede handlinger

  • Chatadministration (opret, læs, opdater, slet)
  • Meddelelseshandlinger (send, hent, rediger, slet)
  • Kanaladministration (opret, konfigurer, liste)
  • Medlemsadministration (tilføj, opdater, liste)
  • Teamoperationer (hente, liste)

Nøglefunktioner

  • Fuld oprettelses-, læse-, opdaterings- og sletningshandlinger (CRUD) for chats og kanaler.
  • Understøttelse af private, delte og standardkanaler.
  • Meddelelsestrådning og svar.
  • Administration af medlemsrolle.
  • Understøttelse af OData-forespørgsler til filtrering og sideinddeling.