Referência ao servidor Microsoft Teams MCP

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Visão geral

ID de servidor	Display name	Escopo	Description
mcp_TeamsServer	Servidor MCP do Microsoft Teams	McpServers.Teams.All	Servidor MCP do Microsoft Teams Graph para gerenciar chats, canais e usuários ou mensagens dentro deles. Use este servidor MCP para operações do Teams como criar, atualizar e recuperar chats e mensagens de chat, gerenciar equipes e canais, e realizar tarefas administrativas relacionadas a esses.

Ferramentas de chat

mcp_graph_chat_addChatMember

Endpoint: POST /v1.0/chats/{chat-id}/membros

Adiciona um membro ao chat usando user@odata.bind, @odata.type, e papéis opcionais (membro, proprietário). Retorna 409 se o membro já estiver presente, 400 para referências de usuário inválidas, ou 403 se as políticas restringirem a adição.

Parâmetros necessários: chat-id, @odata.type, user@odata.bind, papéis

mcp_graph_chat_createChat

Endpoint: POST /v1.0/chats

Cria um novo chat no Teams com o ChatType (oneOnOne requer exatamente dois participantes, o grupo exige mais de dois) e os membros. Retorna 400 se o oneOnOne tiver a contagem errada de membros, 409 se os mesmos participantes já tiverem um chat, ou 403 se o chamador não tiver direitos.

Parâmetros obrigatórios: chatType, membros

mcp_graph_chat_deleteChat

Endpoint: DELETAR /v1.0/chats/{chat-id}

Deleta um chat de forma suave. Retorna o 403 se a permissão estiver faltando, a 404 se já foi excluída, e está sujeita às políticas de retenção de inquilinos.

Parâmetros necessários: chat-id

mcp_graph_chat_deleteChatMessage

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

Exclui uma mensagem de chat. Retorna 403 sem Chat.ReadWrite, 404 para IDs inválidos, e ainda pode manter a mensagem para conformidade.

Parâmetros necessários: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Recupera um chat por ID, retornando metadados como tipo e tópico. Retorna o 404 se o chat não existir ou não estiver visível, ou o 403 se as permissões forem negadas.

Parâmetros necessários: chat-id

mcp_graph_chat_getChatMessage

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

Recupera uma mensagem no chat por ID. Retorna 404 se a mensagem não existir ou estiver oculta, ou 403 sem os direitos adequados.

Parâmetros exigidos: chat-id, message-id

mcp_graph_chat_listChatMembers

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

Listar participantes do chat Retorna os papéis (membro/proprietário/convidado). Retorna o 403 sem permissões de leitura ou o 404 se o chat não for encontrado.

Parâmetros necessários: chat-id

mcp_graph_chat_listChatMessages

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

Lista mensagens no chat com $top, $filter e $orderby opcionais. Retorna resultados paginados; A conformidade pode ocultar conteúdo. Os erros incluem 400 para consultas ruins e 429 para limitação.

Parâmetros necessários: chat-id

Parâmetros opcionais: $top, $filter, $orderby

mcp_graph_chat_listChats

Endpoint: GET /v1.0/chats

Lista os chats para o interlocutor com $top opcionais, $filter, $expand e $orderby. Retorna apenas chats visíveis; Conversas ocultas ou de sistema podem ser excluídas. Retorna 400 para expressões de ordenação inválidas.

Parâmetros opcionais: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

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

Posta uma nova mensagem em texto simples em um chat. Precisa de chat-id e body.content não vazio; Só é suportado por texto. Pode devolver 429 por limitação, 403 se faltar permissões, ou 404 se o chat for inválido. Não idempotente — evite tentativas cegas.

Parâmetros obrigatórios: chat-id, corpo

mcp_graph_chat_updateChat

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

Atualiza propriedades do chat, como o tópico apenas para grupos de conversa. Falha com 400 se usado em um chat individual, 403 sem direitos, ou 404 se o chat não for encontrado.

Parâmetros necessários: chat-id, tópico

mcp_graph_chat_updateChatMessage

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

Atualiza uma mensagem de chat com novo conteúdo em texto simples. A edição pode ser bloqueada para algumas mensagens do sistema ou de conformidade. Retorna 403 ou 400 se a edição for proibida, ou 409 em conflitos.

Parâmetros exigidos: chat-id, message-id

Ferramentas de canal e equipe

mcp_graph_teams_addChannelMember

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

Adiciona um membro a um canal privado ou compartilhado com user@odata.bind, @odata.type, e funções opcionais (proprietário ou vazio). Falha nos canais padrão, retorna 409 se o membro já estiver presente, e 403 se não tiver permissões.

Parâmetros necessários: equipe-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Cria um canal em uma equipe com displayName, descrição opcional, membershipType (padrão, privado, compartilhado) e membros opcionais. Canais privados ou compartilhados exigem membros explícitos; Duplicados ou membros inválidos causam 400 ou 409.

Parâmetros necessários: team-id, displayName

Parâmetros Opcionais: descrição, TypeMembro, membros

mcp_graph_teams_createPrivateChannel

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

Cria um canal privado com membershipType: private. Exige membros na criação, incluindo pelo menos um proprietário. Retorna 400 se membros faltam, 409 para nomes duplicados ou 403 sem permissões.

Parâmetros exigidos: team-id, displayName, membros

mcp_graph_teams_getChannel

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

Recupera um canal com $select e $filter opcionais. Retorna 404 se o canal não for encontrado ou o chamador não tiver acesso, 403 se as permissões não forem suficientes, ou 400 se filtros não suportados.

Parâmetros exigidos: team-id, channel-id

Parâmetros Opcionais: $select, $filter

mcp_graph_teams_getTeam

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

Recupera propriedades do time com $select e $expand opcionais. Devolve 403 ou 404 se a equipe estiver inacessível.

Parâmetros exigidos: team-id

Parâmetros Opcionais: $select, $expand

mcp_graph_teams_listChannelMembers

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

Lista todos os membros de um canal específico do Microsoft Teams, retornando metadados sobre cada membro, como identidade, funções e status de membro. Útil para auditar a participação no canal, verificar a membresia antes de atualizações de funções ou garantir a conformidade.

Parâmetros exigidos: team-id, channel-id

Parâmetros opcionais: $top, $expand

mcp_graph_teams_listChannelMessages

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

Lista mensagens em um canal com $top e $expand opcionais (por exemplo, respostas). A paginação é feita por meio @odata.nextLinkde . Retorna 403 sem permissão de leitura ou 400 para opções de consulta inválidas.

Parâmetros exigidos: team-id, channel-id

Parâmetros opcionais: $top, $expand

mcp_graph_teams_listChannels

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

Lista canais em um time com $select ou $filter opcionais. Retorna canais privados e compartilhados somente se o interlocutor for membro. Falha com 403 se o chamador não tiver direitos de leitura ou 400 em consultas OData inválidas.

Parâmetros exigidos: team-id

Parâmetros Opcionais: $select, $filter

mcp_graph_teams_listTeams

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

Lista as equipes que se juntaram a um usuário específico. Retorna apenas as assinaturas desse usuário, não todas as equipes de tenant. Retorna 403 se o chamador não puder consultar o usuário ou 404 se o ID for inválido.

Parâmetros necessários: user-id

mcp_graph_teams_postChannelMessage

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

Posta uma mensagem em texto simples para um canal. Requer team-id, channel-id e body.content. Retorna 403 sem ChannelMessage.Send, 404 se canal não encontrado ou 400 se o conteúdo estiver faltando.

Parâmetros exigidos: time-id, channel-id, corpo

mcp_graph_teams_replyToChannelMessage

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

Responde a uma mensagem em um canal com body.content. Apenas texto simples é suportado. Retorna 404 se a mensagem pai não for encontrada, 403 sem direitos, ou 400 para conteúdo inválido.

Parâmetros exigidos: equipe-id, channel-id, message-id, corpo

mcp_graph_teams_updateChannel

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

Atualiza um canal com um novo displayName ou descrição. Restrições podem se aplicar a canais especiais como o General. Retorna 403 sem direitos, 409 em nomes duplicados, ou 400 por entrada inválida.

Parâmetros exigidos: team-id, channel-id

Parâmetros Opcionais: NomeDisplay, Descrição

mcp_graph_teams_updateChannelMember

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

Atualiza o papel do membro em um canal privado ou compartilhado mudando de funções. Canais padrão herdam papéis da equipe e geralmente rejeitam atualizações. Retorna 400 se tentado nos canais padrão, 403 se não autorizado ou 404 se membro não encontrado.

Parâmetros exigidos: equipe-id, channel-id, membership-id, funções

Operações com suporte

1. Gerenciamento de chat (criar, ler, atualizar, excluir)
2. Operações de mensagem (enviar, recuperar, editar, excluir)
3. Gerenciamento de canal (criar, configurar, listar)
4. Gestão de membros (adicionar, atualizar, listar)
5. Operações da equipe (recuperar, listar)

Recursos principais

1. Operações completas de CRUD para chats e canais
2. Suporte para canais privados, compartilhados e padrão
3. Threading de mensagens e respostas
4. Gerenciamento de funções de usuário
5. Suporte a consultas OData para filtragem e paginação