Référence du serveur MCP de Microsoft Teams

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

Vue d’ensemble

ID du serveur	Nom d’affichage	Portée	Description
mcp_TeamsServer	Serveur MCP de Microsoft Teams	McpServers.Teams.All	Le serveur MCP Graph de Microsoft Teams permet de gérer les conversations, les canaux et les utilisateurs ou messages qu’ils contiennent. Utilisez ce serveur MCP pour les opérations Teams telles que la création, la mise à jour et la récupération de conversations et de messages de conversation, la gestion des équipes et des canaux, ainsi que l’exécution de tâches d’administration associées.

Outils de conversation instantanée

mcp_graph_chat_addChatMember

Point de terminaison : POST /v1.0/chats/{chat-id}/members

Ajoute un membre à une conversation instantanée à l’aide de user@odata.bind@odata.type et de rôles facultatifs (membre, propriétaire). Renvoie un code 409 si le membre est déjà présent, 400 en cas de références utilisateur non valides, ou 403 si des stratégies empêchent l’ajout.

Paramètres requis : chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Point de terminaison : POST /v1.0/chats

Crée une conversation Teams avec le paramètre chatType (oneOnOne nécessite exactement deux participants, group en exige plus de deux) et les membres. Renvoie un code 400 si oneOnOne comporte un nombre incorrect de membres, 409 si les mêmes participants ont déjà une conversation, ou 403 si l’appelant ne dispose pas des droits nécessaires.

Paramètres requis : chatType, members

mcp_graph_chat_deleteChat

Point de terminaison : DELETE /v1.0/chats/{chat-id}

Supprime une conversation instantanée de manière réversible. Renvoie un code 403 si l’autorisation manque, 404 si la conversation est déjà supprimée, et est soumis aux stratégies de rétention du locataire.

Paramètres requis : chat-id

mcp_graph_chat_deleteChatMessage

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

Supprime un message de conversation instantanée de manière réversible. Renvoie un code 403 en l’absence de l’autorisation Chat.ReadWrite, 404 pour des identifiants non valides, et peut malgré tout conserver le message à des fins de conformité.

Paramètres requis : user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Point de terminaison : GET /v1.0/chats/{chat-id}

Récupère une conversation par ID et renvoie des métadonnées telles que le type et le sujet. Renvoie un code 404 si la conversation n’existe pas ou n’est pas visible, ou 403 si les autorisations sont refusées.

Paramètres requis : chat-id

mcp_graph_chat_getChatMessage

Point de terminaison : GET /v1.0/chats/{chat-id}/messages/{message-id}

Récupère un message de conversation par ID. Renvoie un code 404 si le message n’existe pas ou est masqué, ou 403 en l’absence des droits requis.

Paramètres requis : chat-id, message-id

mcp_graph_chat_listChatMembers

Point de terminaison : GET /v1.0/chats/{chat-id}/members

Répertorie les participants à la conversation instantanée. Renvoie les rôles (membre/propriétaire/invité). Renvoie un code 403 en l’absence d’autorisations de lecture ou 404 si la conversation est introuvable.

Paramètres requis : chat-id

mcp_graph_chat_listChatMessages

Point de terminaison : GET /v1.0/chats/{chat-id}/messages

Répertorie les messages d’une conversation avec les paramètres facultatifs $top, $filter et $orderby. Renvoie des résultats paginés ; la conformité peut masquer certains contenus. Les erreurs incluent un code 400 pour des requêtes incorrectes et 429 en cas de limitation de bande passante.

Paramètres requis : chat-id

Paramètres facultatifs : $top, $filter, $orderby

mcp_graph_chat_listChats

Point de terminaison : GET /v1.0/chats

Répertorie les conversations de l’appelant avec les paramètres facultatifs $top, $filter, $expand et $orderby. Renvoie uniquement les conversations visibles ; les conversations masquées ou système peuvent être exclues. Renvoie un code 400 pour des expressions de tri non valides.

Paramètres facultatifs : $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Point de terminaison : POST /v1.0/chats/{chat-id}/messages

Publie un nouveau message en texte brut dans une conversation. Nécessite l’ID de la conversation et un champ body.content non vide ; seul le texte est pris en charge. Peut renvoyer un code 429 en cas de limitation de débit, 403 si des autorisations sont manquantes, ou 404 si la conversation n’est pas valide. Non idempotent : éviter les tentatives de réexécution à l’aveugle.

Paramètres requis : chat-id, body

mcp_graph_chat_updateChat

Point de terminaison : PATCH /v1.0/chats/{chat-id}

Met à jour les propriétés d’une conversation, comme le sujet, uniquement pour les conversations de groupe. Renvoie une erreur 400 si utilisé sur une conversation en tête-à-tête, 403 en l’absence de droits, ou 404 si la conversation est introuvable.

Paramètres requis : chat-id, topic

mcp_graph_chat_updateChatMessage

Point de terminaison : PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Met à jour un message de conversation avec un nouveau contenu en texte brut. La modification peut être bloquée pour certains messages système ou de conformité. Renvoie un code 403 ou 400 si la modification n’est pas autorisée, ou 409 en cas de conflit.

Paramètres requis : chat-id, message-id

Outils pour les canaux et les équipes

mcp_graph_teams_addChannelMember

Point de terminaison : POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Ajoute un membre à un canal privé ou partagé avec user@odata.bind des @odata.type et des rôles facultatifs (propriétaire ou vide). Échoue sur les canaux standard, renvoie un code 409 si le membre est déjà présent, et 403 en cas d’autorisations insuffisantes.

Paramètres requis : team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Point de terminaison : POST /v1.0/teams/{team-id}/channels

Crée un canal dans une équipe avec displayName, une description facultative, membershipType (standard, privé, partagé) et des membres facultatifs. Les canaux privés ou partagés nécessitent des membres explicites ; les doublons ou des appartenances non valides entraînent un code 400 ou 409.

Paramètres requis : team-id, displayName

Paramètres facultatifs : description, membershipType, members

mcp_graph_teams_createPrivateChannel

Point de terminaison : POST /v1.0/teams/{team-id}/channels

Crée un canal privé avec membershipType : private. Nécessite des membres lors de la création, dont au moins un propriétaire. Renvoie un code 400 en l’absence de membres, 409 en cas de noms en double, ou 403 en l’absence d’autorisations.

Paramètres requis : team-id, displayName, members

mcp_graph_teams_getChannel

Point de terminaison : GET /v1.0/teams/{team-id}/channels/{channel-id}

Récupère un canal avec les paramètres facultatifs $select et $filter. Renvoie un code 404 si le canal est introuvable ou si l’appelant n’a pas accès, 403 en cas d’autorisations insuffisantes, ou 400 pour des filtres non pris en charge.

Paramètres requis : team-id, channel-id

Paramètres facultatifs : $select, $filter

mcp_graph_teams_getTeam

Point de terminaison : GET /v1.0/teams/{team-id}

Récupère les propriétés d’une équipe avec les paramètres facultatifs $select et $expand. Renvoie un code 403 ou 404 si l’équipe est inaccessible.

Paramètres requis : team-id

Paramètres facultatifs : $select, $expand

mcp_graph_teams_listChannelMembers

Point de terminaison : GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Répertorie tous les membres d’un canal Microsoft Teams donné et renvoie des métadonnées pour chacun, telles que l’identité, les rôles et le statut d’appartenance. Utile pour auditer la participation au canal, vérifier l’appartenance avant les mises à jour de rôle ou garantir la conformité.

Paramètres requis : team-id, channel-id

Paramètres facultatifs : $top, $expand

mcp_graph_teams_listChannelMessages

Point de terminaison : GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Répertorie les messages d’un canal avec les paramètres facultatifs $top et $expand (par exemple, les réponses). La pagination est gérée via @odata.nextLink. Renvoie un code 403 en l’absence d’autorisation de lecture ou 400 pour des options de requête non valides.

Paramètres requis : team-id, channel-id

Paramètres facultatifs : $top, $expand

mcp_graph_teams_listChannels

Point de terminaison : GET /v1.0/teams/{team-id}/allChannels

Répertorie les canaux d’une équipe avec les paramètres facultatifs $select ou $filter. Renvoie les canaux privés et partagés uniquement si l’appelant en est membre. Échoue avec un code 403 si l’appelant ne dispose pas des droits de lecture, ou 400 en cas de requêtes OData non valides.

Paramètres requis : team-id

Paramètres facultatifs : $select, $filter

mcp_graph_teams_listTeams

Point de terminaison : GET /v1.0/users/{user-id}/joinedTeams

Répertorie les équipes auxquelles un utilisateur spécifique a adhéré. Renvoie uniquement les appartenances de cet utilisateur, et non toutes les équipes du locataire. Renvoie un code 403 si l’appelant ne peut pas interroger l’utilisateur, ou 404 si l’identifiant est invalide.

Paramètres obligatoires : user-id

mcp_graph_teams_postChannelMessage

Point de terminaison : POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Publie un message en texte brut dans un canal. Nécessite team-id, channel-id et body.content Renvoie un code 403 en l’absence de l’autorisation ChannelMessage.Send, 404 si le canal est introuvable, ou 400 si le contenu est manquant.

Paramètres requis : team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

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

Répond à un message dans un canal avec body.content. Seul le texte brut est pris en charge. Renvoie un code 404 si le message parent est introuvable, 403 en l’absence de droits, ou 400 en cas de contenu non valide.

Paramètres requis : team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Point de terminaison : PATCH /teams/{team-id}/channels/{channel-id}

Met à jour un canal avec un nouveau displayName ou une nouvelle description. Des restrictions peuvent s’appliquer à certains canaux spéciaux, comme Général. Renvoie un code 403 en l’absence de droits, 409 en cas de noms en double, ou 400 pour une entrée non valide.

Paramètres requis : team-id, channel-id

Paramètres facultatifs : displayName, description

mcp_graph_teams_updateChannelMember

Point de terminaison : PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Met à jour le rôle d’un membre dans un canal privé ou partagé en modifiant ses rôles. Les canaux standard héritent des rôles de l’équipe et refusent généralement les mises à jour. Renvoie un code 400 si l’opération est tentée sur des canaux standard, 403 en cas d’absence d’autorisation, ou 404 si le membre est introuvable.

Paramètres requis : team-id, channel-id, membership-id, roles

Opérations prises en charge

1. Gestion des conversations (créer, lire, mettre à jour, supprimer)
2. Opérations message (envoyer, récupérer, modifier, supprimer)
3. Gestion des canaux (créer, configurer, répertorier)
4. Gestion des membres (ajouter, mettre à jour, répertorier)
5. Opérations d’équipe (récupérer, répertorier)

Fonctionnalités clés

1. Opérations CRUD complètes pour les conversations et les canaux
2. Prise en charge des canaux privés, partagés et standard
3. Fils de messages et réponses
4. Gestion des rôles des membres
5. Prise en charge des requêtes OData pour le filtrage et la pagination