MCP-serverreferentie van Microsoft Teams

Belangrijk

U moet deelnemen aan het preview-programma Frontier om vroegtijdige toegang te krijgen tot Microsoft Agent 365. Frontier verbindt u rechtstreeks met de nieuwste AI-innovaties van Microsoft. Op Frontier-previews zijn de bestaande preview-voorwaarden van uw klantovereenkomsten van toepassing. Omdat deze functies nog in ontwikkeling zijn, kunnen de beschikbaarheid en mogelijkheden hiervan na verloop van tijd veranderen.

Overzicht

Server ID	Weergavenaam	Bereik	Omschrijving
mcp_TeamsServer	MCP-server van Microsoft Teams	McpServers.Teams.All	Microsoft Teams Graph MCP-server voor het beheren van chats, kanalen en gebruikers of berichten daarin. Gebruik deze MCP-server voor Teams-bewerkingen, zoals het maken, bijwerken en ophalen van chats en chatberichten, het beheren van teams en kanalen en het uitvoeren van beheertaken met betrekking hiertoe.

Chathulpprogramma's

mcp_graph_chat_addChatMember

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

Voegt een lid toe aan een chat met behulp van user@odata.bind, @odata.type en optionele rollen (lid, eigenaar). Retourneert 409 als het lid al aanwezig is, 400 voor ongeldige gebruikersverwijzingen of 403 als het beleid het toevoegen beperkt.

Vereiste parameters: chat-id, @odata.type, user@odata.bind rollen

mcp_graph_chat_createChat

Eindpunt: POST /v1.0/chats

Hiermee maakt u een nieuwe Teams-chat met chatType (oneOnOne vereist precies twee deelnemers, een groep vereist meer dan twee) en leden. Retourneert 400 als oneOnOne het verkeerde aantal leden heeft, 409 als dezelfde deelnemers al een chatgesprek hebben of 403 als de beller geen rechten heeft.

Vereiste parameters: chatType, leden

mcp_graph_chat_deleteChat

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

Hiermee verwijdert u een chat. Retourneert 403 als de machtiging ontbreekt, 404 als deze al is verwijderd en onderhevig is aan tenantretentiebeleid.

Vereiste parameters: chat-id

mcp_graph_chat_deleteChatMessage

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

Hiermee verwijdert u een chatbericht. Retourneert 403 zonder Chat.ReadWrite, 404 voor ongeldige id's en kan het bericht nog steeds behouden voor naleving.

Vereiste parameters: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Haalt een chat per id op, retourneert metagegevens zoals type en onderwerp. Retourneert 404 als de chat niet bestaat of niet zichtbaar is, of 403 als machtigingen worden geweigerd.

Vereiste parameters: chat-id

mcp_graph_chat_getChatMessage

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

Hiermee wordt een chatbericht opgehaald op id. Retourneert 404 als het bericht niet bestaat of verborgen is, of 403 zonder de juiste rechten.

Vereiste parameters: chat-id, message-id

mcp_graph_chat_listChatMembers

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

Een lijst met chatdeelnemers. Retourneert rollen (lid/eigenaar/gast). Retourneert 403 zonder leesmachtigingen of 404 als de chat niet is gevonden.

Vereiste parameters: chat-id

mcp_graph_chat_listChatMessages

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

Bevat berichten in een chat met optionele $top, $filter en $orderby. Retourneert gepagineerde resultaten; naleving kan inhoud verbergen. Fouten omvatten 400 voor ongeldige query's en 429 voor beperking.

Vereiste parameters: chat-id

Optionele parameters: $top, $filter, $orderby

mcp_graph_chat_listChats

Eindpunt: GET /v1.0/chats

Toont chats voor de beller met optionele $top, $filter, $expand en $orderby. Retourneert alleen zichtbare chats; verborgen chats of systeemchats kunnen worden uitgesloten. Retourneert 400 voor ongeldige sorteerexpressies.

Optionele parameters: $top, $filter, $expand, $filter

mcp_graph_chat_postMessage

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

Plaatst een nieuw bericht zonder opmaak in een chat. Heeft chat-id en niet-lege body.content nodig; alleen tekst wordt ondersteund. Kan 429 retourneren voor beperking, 403 als er machtigingen ontbreken of 404 als de chat ongeldig is. Niet idempotent - vermijd blinde pogingen.

Vereiste parameters: chat-id, body

mcp_graph_chat_updateChat

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

Hiermee worden chateigenschappen bijgewerkt, zoals het onderwerp voor groepschats. Mislukt met 400 als deze wordt gebruikt voor een een-op-een-chat, 403 zonder rechten of 404 als de chat niet is gevonden.

Vereiste parameters: chat-id, onderwerp

mcp_graph_chat_updateChatMessage

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

Hiermee werkt u een chatbericht bij met nieuwe inhoud zonder opmaak. Bewerken kan worden geblokkeerd voor bepaalde systeem- of nalevingsberichten. Retourneert 403 of 400 als bewerken niet is toegestaan of 409 bij conflicten.

Vereiste parameters: chat-id, message-id

Hulpprogramma's voor kanalen en teams

mcp_graph_teams_addChannelMember

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

Voegt een lid toe aan een privé- of gedeeld kanaal met user@odata.bind, @odata.type en optionele rollen (eigenaar of leeg). Mislukt op standaardkanalen, retourneert 409 als het lid al aanwezig is en 403 als er geen machtigingen zijn.

Vereiste parameters: team-id, kanaal-id, displayName, rollen, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Hiermee maakt u een kanaal in een team met displayName, optionele beschrijving, membershipType (standaard, privé, gedeeld) en optionele leden. Voor privé- of gedeelde kanalen zijn expliciete leden vereist; duplicaten of ongeldig lidmaatschap veroorzaken 400 of 409.

Vereiste parameters: team-id, displayName

Optionele parameters: beschrijving, membershipType, leden

mcp_graph_teams_createPrivateChannel

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

Hiermee maakt u een privékanaal met membershipType: privé. Vereist dat leden worden gemaakt, inclusief ten minste één eigenaar. Retourneert 400 bij ontbrekende leden, 409 voor dubbele namen of 403 als er geen machtigingen zijn.

Vereiste parameters: team-id, displayName, leden

mcp_graph_teams_getChannel

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

Hiermee haalt u een kanaal op met optionele $select en $filter. Retourneert 404 als het kanaal niet is gevonden of als de beller geen toegang heeft, 403 als er onvoldoende machtigingen zijn of 400 bij niet-ondersteunde filters.

Vereiste parameters: team-id, kanaal-id

Optionele parameters: $select, $filter

mcp_graph_teams_getTeam

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

Hiermee worden teameigenschappen opgehaald met optionele $select en $expand. Retourneert 403 of 404 als het team niet toegankelijk is.

Vereiste parameters: team-id

Optionele parameters: $select, $expand

mcp_graph_teams_listChannelMembers

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

Een lijst met alle leden van een specifiek Microsoft Teams-kanaal, met metagegevens over elk lid, zoals identiteit, rollen en lidmaatschapsstatus. Handig voor het controleren van kanaaldeelname, het controleren van lidmaatschap vóór rolupdates of het garanderen van naleving.

Vereiste parameters: team-id, kanaal-id

Optionele parameters: $top, $expand

mcp_graph_teams_listChannelMessages

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

Bevat berichten in een kanaal met optionele $top en $expand (bijvoorbeeld antwoorden). Paginering wordt afgehandeld via @odata.nextLink. Retourneert 403 als er geen leesmachtiging is of 400 bij ongeldige queryopties.

Vereiste parameters: team-id, kanaal-id

Optionele parameters: $top, $expand

mcp_graph_teams_listChannels

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

Lijsten met kanalen in een team met optionele $select of $filter. Retourneert alleen privé- en gedeelde kanalen als de beller lid is. Mislukt met 403 als de aanroeper geen leesrechten heeft of 400 bij ongeldige OData-query's.

Vereiste parameters: team-id

Optionele parameters: $select, $filter

mcp_graph_teams_listTeams

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

Geeft een lijst weer van de gekoppelde teams van een specifieke gebruiker. Retourneert alleen lidmaatschappen van die gebruiker, niet alle tenantteams. Retourneert 403 als de beller geen query's kan uitvoeren op de gebruiker of 404 als de id ongeldig is.

Vereiste parameters: gebruikers-id

mcp_graph_teams_postChannelMessage

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

Plaatst een bericht zonder opmaak in een kanaal. Vereist team-id, kanaal-id en body.content. Retourneert 403 zonder ChannelMessage.Send, 404 als het kanaal niet is gevonden of 400 als inhoud ontbreekt.

Vereiste parameters: team-id, kanaal-id, hoofdtekst

mcp_graph_teams_replyToChannelMessage

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

Antwoorden op een bericht in een kanaal met body.content. Alleen platte tekst wordt ondersteund. Retourneert 404 als het bovenliggende bericht niet wordt gevonden, 403 als er rechten ontbreken of 400 bij ongeldige inhoud.

Vereiste parameters: team-id, kanaal-id, bericht-id, hoofdtekst

mcp_graph_teams_updateChannel

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

Hiermee wordt een kanaal bijgewerkt met nieuwe displayName of beschrijving. Beperkingen kunnen van toepassing zijn op speciale kanalen, zoals Algemeen. Retourneert 403 als rechten ontbreken, 409 bij dubbele namen of 400 bij ongeldige invoer.

Vereiste parameters: team-id, kanaal-id

Optionele parameters: displayName, beschrijving

mcp_graph_teams_updateChannelMember

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

Hiermee wordt de rol van een lid in een privé- of gedeeld kanaal bijgewerkt door rollen te wijzigen. Standaardkanalen nemen rollen over van het team en weigeren meestal updates. Retourneert 400 als een poging wordt uitgevoerd op standaardkanalen, 403 als dit niet is toegestaan of 404 als het lid niet is gevonden.

Vereiste parameters: team-id, kanaal-id, lidmaatschaps-id, rollen

Ondersteunde bewerkingen

1. Chatbeheer (maken, lezen, bijwerken, verwijderen)
2. Berichtbewerkingen (verzenden, ophalen, bewerken, verwijderen)
3. Kanaalbeheer (maken, configureren, vermelden)
4. Ledenbeheer (toevoegen, bijwerken, weergeven)
5. Teambewerkingen (ophalen, weergeven)

Belangrijke functies

1. Volledige CRUD-bewerkingen voor chats en kanalen
2. Ondersteuning voor privé-, gedeelde en standaardkanalen
3. Bericht-threading en antwoorden
4. Rollenbeheer van leden
5. OData-queryondersteuning voor filteren en pagineren