Referência do servidor Microsoft Teams MCP

Descrição geral

Ferramentas de chat

mcp_graph_chat_addChatMember

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

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

Parâmetros obrigatórios: chat-id, @odata.type, user@odata.bind, funções

mcp_graph_chat_createChat

Endpoint: POST /v1.0/chats

Cria um novo chat no Teams com o ChatType (o oneOnOne requer exatamente dois participantes, o grupo requer mais de dois) e os membros. Devolve 400 se o oneOnOne tiver o número errado de membros, 409 se os mesmos participantes já tiverem conversa, ou 403 se o interlocutor não tiver direitos.

Parâmetros obrigatórios: chatType, membros

mcp_graph_chat_deleteChat

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

Apaga suavemente uma conversa. Devolve 403 se a permissão estiver em falta, 404 se já foi apagada, e está sujeita às políticas de retenção de inquilinos.

Parâmetros obrigatórios: chat-id

mcp_graph_chat_deleteChatMessage

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

Apaga suavemente uma mensagem de chat. Devolve 403 sem Chat.ReadWrite, 404 para IDs inválidos, e pode ainda assim 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, devolvendo metadados como tipo e tópico. Devolve o 404 se o chat não existir ou não for visível, ou o 403 se as permissões forem negadas.

Parâmetros obrigatórios: chat-id

mcp_graph_chat_getChatMessage

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

Recupera uma mensagem de chat por identificação. Devolve 404 se a mensagem não existir ou estiver oculta, ou 403 sem os direitos adequados.

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

mcp_graph_chat_listChatMembers

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

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

Parâmetros obrigatórios: chat-id

mcp_graph_chat_listChatMessages

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

Lista mensagens num chat com $top, $filter e $orderby opcionais. Devolve resultados pagados; A conformidade pode ocultar conteúdo. Os erros incluem 400 por consultas inadequadas e 429 por limitação.

Parâmetros obrigatórios: chat-id

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

mcp_graph_chat_listChats

Endpoint: GET /v1.0/chats

Lista as conversas para o interlocutor com $top opcionais, $filter, $expand e $orderby. Só devolve conversas visíveis; Conversas ocultas ou do sistema podem ser excluídas. Devolve 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

Publica uma nova mensagem em texto simples num chat. Precisa do chat-id e do non-empty body.content; Só é suportado texto. Pode devolver 429 por limitação, 403 se faltar permissões, ou 404 se o chat for inválido. Não idempotente—evita tentativas cegas.

Parâmetros necessários: chat-id, corpo

mcp_graph_chat_updateChat

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

Atualiza propriedades de chat, como o tema apenas para chats de grupo. Falha com 400 se usado numa conversa individual, 403 sem direitos, ou 404 se o chat não for encontrado.

Parâmetros obrigató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. Devolve 403 ou 400 se a edição for proibida, ou 409 em conflitos.

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

Ferramentas de canal e equipa

mcp_graph_teams_addChannelMember

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

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

Parâmetros obrigatórios: team-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 numa equipa com displayName, descrição opcional, membershipType (padrão, privado, partilhado) e membros opcionais. Canais privados ou partilhados requerem 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 membroTipo: privado. Requer membros na criação, incluindo pelo menos um proprietário. Devolve 400 se houver membros em falta, 409 para nomes duplicados, ou 403 sem permissões.

Parâmetros obrigatórios: 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. Devolve 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 obrigatórios: team-id, channel-id

Parâmetros opcionais: $select, $filter

mcp_graph_teams_getTeam

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

Recupera propriedades da equipa com $select e $expand opcionais. Devolve 403 ou 404 se a equipa estiver inacessível.

Parâmetros obrigatórios: 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, devolvendo metadados sobre cada membro, como identidade, funções e estado de membro. Útil para auditar a participação no canal, verificar a adesão antes de atualizações de funções ou garantir a conformidade.

Parâmetros obrigatórios: 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 num canal com $top e $expand opcionais (por exemplo, respostas). A paginação é tratada através de @odata.nextLink. Devolve 403 sem permissão de leitura ou 400 para opções de consulta inválidas.

Parâmetros obrigatórios: team-id, channel-id

Parâmetros opcionais: $top, $expand

mcp_graph_teams_listChannels

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

Lista os canais numa equipa com $select ou $filter opcionais. Retorna canais privados e partilhados apenas 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 obrigatórios: team-id

Parâmetros opcionais: $select, $filter

mcp_graph_teams_listTeams

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

Lista as equipas juntadas a um utilizador específico. Só devolve as subscrições desse utilizador, não todas as equipas de tenants. Devolve 403 se o chamador não conseguir consultar o utilizador 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

Publica uma mensagem em texto simples num canal. Requer team-id, channel-id e body.content. Devolve 403 sem ChannelMessage.Send, 404 se o canal não for encontrado, ou 400 se o conteúdo estiver em falta.

Parâmetros obrigatórios: identificação da equipa, identificação do canal, corpo

mcp_graph_teams_replyToChannelMessage

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

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

Parâmetros obrigatórios: 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 aplicar-se a canais especiais como o General. Devolve 403 sem direitos, 409 em nomes duplicados, ou 400 por entrada inválida.

Parâmetros obrigatórios: team-id, channel-id

Parâmetros opcionais: displayName, descrição

mcp_graph_teams_updateChannelMember

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

Atualiza o papel de um membro num canal privado ou partilhado, mudando de funções. Os canais padrão herdam os papéis da equipa e normalmente rejeitam atualizações. Devolve 400 se tentado nos canais padrão, 403 se não autorizado, ou 404 se o membro não for encontrado.

Parâmetros obrigatórios: team-id, channel-id, membership-id, funções

Operações suportadas

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

Funcionalidades principais

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