Naslag voor Teams (previewversie)

Note

Dit artikel beschrijft functies die worden gebruikt in agenten of agentstromen die gebruikmaken van het standard harness.

Important

Dit is een preview-functie.

• Microsoft brengt previewfuncties uit vóór een officiële release, zodat klanten vroegtijdig toegang kunnen krijgen en feedback kunnen geven.
• Preview-functies hebben beperkte functionaliteit en zijn niet bedoeld voor productiegebruik.
• Microsoft kan de namen en parameters van het MCP-hulpprogramma preview wijzigen. Vermijd in code vastgelegde afhankelijkheden. Microsoft ondersteuning voor scenario's onderhoudt.
• Preview-functies zijn onderhevig aan Microsoft aanvullende gebruiksvoorwaarden.

Overzicht

Server-ID	URL op tenantniveau	Weergavenaam	Scope	Description
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	Microsoft Teams-tools om chats, kanalen en gebruikers of berichten daarin te beheren. 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 tot deze taken.

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.typeen optionele rollen (lid, eigenaar). Retourneert een 409-foutcode als het lid al aanwezig is, een 400-foutcode voor ongeldige gebruikersverwijzingen of een 403-foutcode als 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, groep vereist meer dan twee) en leden. Retourneert een 400 als oneOnOne het aantal verkeerde leden is, 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 tijdelijk. Retourneert een 403 als de machtiging ontbreekt of een 404 als deze al is verwijderd. Bewaarbeleid voor tenants bepaalt deze bewerking.

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 tijdelijk een chatbericht. Retourneert een 403 zonder Chat.ReadWrite, een 404 voor ongeldige id's en behoudt het bericht mogelijk nog steeds voor naleving.

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

mcp_graph_chat_getChat

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

Haalt een chat op op basis van ID. Retourneert metagegevens zoals type en onderwerp. Retourneert een 404 als de chat niet bestaat of niet zichtbaar is, of een 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 via ID. Retourneert een 404 als het bericht niet bestaat of verborgen is, of een 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 of gast). Geeft een 403 bij ontbreken van leesmachtigingen of een 404 als de chat niet wordt gevonden.

Vereiste parameters: chat-id

mcp_graph_chat_listChatMessages

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

Geeft berichten in een chat weer met optionele $top, $filter en $orderby. Retourneert gepaginade resultaten. Naleving kan inhoud verbergen. Fouten zijn onder meer een 400 voor onjuiste query's en een 429 voor snelheidsbeperking.

Vereiste parameters: chat-id

Optionele parameters:$top, $filter, $orderby

mcp_graph_chat_listChats

Eindpunt:GET /v1.0/chats

Bevat chats voor de beller met optioneel $top, $filteren $expand$orderby. Retourneert alleen zichtbare chats; verborgen chats of systeemchats kunnen worden uitgesloten. Retourneert een 400 voor ongeldige sorteerexpressies.

Optionele parameters:$top, $orderby, $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 nonempty body.content nodig; alleen tekst wordt ondersteund. Kan een 429 retourneren vanwege snelheidsbeperking, een 403 als de vereiste machtigingen ontbreken, of een 404 als de chat ongeldig is. Geen idempotent—avoid blinde pogingen.

Vereiste parameters: chat-id, hoofdtekst

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 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 platte-tekst inhoud. Sommige systeem- of nalevingsberichten blokkeren bewerken. De bewerking retourneert een 403- of 400 als bewerken niet is toegestaan, of een 409 voor conflicten.

Vereiste parameters: chat-id, message-id

Kanaal- en teamtools

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 behulp van user@odata.bind, @odata.typeen optionele rollen (eigenaar of leeg). Mislukt op standaardkanalen. Retourneert een 409 als het lid al aanwezig is en een 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 displayNameeen optionele beschrijving membershipType (standaard, privé, gedeeld) en optionele leden. Voor privé- of gedeelde kanalen zijn expliciete leden vereist. Dubbele of ongeldige lidmaatschappen resulteren in een 400- of 409-fout.

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 door in te stellen membershipType op private. U moet leden opnemen wanneer u het kanaal maakt en de ledenlijst moet ten minste één eigenaar hebben. Retourneert een 400 als de leden ontbreken, een 409 voor dubbele namen of een 403 als de beller geen machtigingen heeft.

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 optioneel $select en $filter. Retourneert een 404 als het kanaal niet wordt gevonden of als de beller geen toegang heeft, een 403 als er onvoldoende machtigingen zijn of een 400 voor 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 haalt u de eigenschappen van een team op met optionele $select en $expand. Geeft een 403 of 404 terug 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. Retourneert metagegevens over elk lid, zoals identiteit, rollen en lidmaatschapsstatus. Deze informatie is handig voor het controleren van kanaaldeelname, het controleren van lidmaatschap vóór het bijwerken van rollen 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

Een lijst met berichten in een kanaal. Gebruik de optionele parameters $top en $expand om de resultaten aan te passen. Gebruik bijvoorbeeld $expand om reacties op te nemen. Paginering wordt afgehandeld via @odata.nextLink. Geeft een 403 bij gebrek aan leesrechten of een 400 voor ongeldige queryopties.

Vereiste parameters: team-id, kanaal-id

Optionele parameters:$top, $expand

mcp_graph_teams_listChannels

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

Geeft de kanalen in een team weer. Gebruik de optionele parameters $select of $filter om de resultaten aan te passen. Retourneert alleen privé- en gedeelde kanalen als de beller lid is. Mislukt met een 403 als de aanroeper geen leesrechten heeft of een 400 op 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 een 403 als de beller geen query's kan uitvoeren op de gebruiker of een 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 plaintextbericht in een kanaal. Vereist team-id, kanaal-id en body.content. Retourneert een 403 zonder ChannelMessage.Send, een 404 als het kanaal niet is gevonden of een 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 behulp van body.content. Alleen tekst zonder opmaak wordt ondersteund. Retourneert een 404 als het bovenliggende bericht niet wordt gevonden, een 403 zonder rechten of een 400 voor ongeldige inhoud.

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

mcp_graph_teams_updateChannel

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

Werkt een kanaal bij met een nieuwe displayName of beschrijving. Beperkingen kunnen van toepassing zijn op speciale kanalen, zoals Algemeen. Retourneert een 403 zonder rechten, een 409 op dubbele namen of een 400 voor ongeldige invoer.

Vereiste parameters: team-id, kanaal-id

Optionele parameters: displayName, beschrijving

mcp_graph_teams_updateChannelMember (functie om kanaalleden bij te werken in Teams)

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 een 400 als dit op standaardkanalen wordt geprobeerd, een 403 als niet geautoriseerd, of een 404 als het lid niet wordt gevonden.

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

Ondersteunde bewerkingen

• Chatbeheer (maken, lezen, bijwerken, verwijderen)
• Berichtbewerkingen (verzenden, ophalen, bewerken, verwijderen)
• Kanaalbeheer (maken, configureren, vermelden)
• Ledenbeheer (toevoegen, bijwerken, lijst)
• Teambewerkingen (ophalen, lijst)

Belangrijkste kenmerken

• Volledige CRUD-bewerkingen (maken, lezen, bijwerken en verwijderen) voor chats en kanalen.
• Ondersteuning voor privé-, gedeelde en standaardkanalen.
• Gespreksweergave en antwoorden.
• Rolbeheer van leden.
• Ondersteuning voor OData-query's voor filteren en pagineren.