Referencia de Work IQ Teams (versión preliminar)

Importante

• Esta es una función de vista previa.
• Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a términos de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan obtener acceso temprano y brindar comentarios.

Id. de servidor	Nombre para mostrar	Ámbito	Descripción
mcp_TeamsServer	Equipos de Work IQ	McpServers.Teams.All	Microsoft Teams servidor MCP de Graph para administrar chats, canales y usuarios o mensajes dentro de ellos. Use este servidor MCP para operaciones de Teams, como crear, actualizar y recuperar mensajes de chat y chat, administrar equipos y canales, y realizar tareas administrativas relacionadas con estas tareas.

Herramientas de chat

mcp_graph_chat_addChatMember

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

Agrega un miembro a un chat mediante user@odata.bind, @odata.type y roles opcionales (miembro, propietario). Devuelve un código de error 409 si el miembro ya está presente, un código de error 400 para referencias de usuario no válidas o un código de error 403 si las directivas restringen la adición.

Parámetros necesarios: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Punto final:POST /v1.0/chats

Crea un nuevo chat en Teams con chatType (oneOnOne requiere exactamente dos participantes, el grupo requiere más de dos) y miembros. Devuelve un 400 si oneOnOne tiene el recuento de miembros incorrecto, 409 si los mismos participantes ya tienen un chat o 403 si el autor de la llamada carece de derechos.

Parámetros requeridos:chatType miembros

mcp_graph_chat_eliminarChat

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

Elimina temporalmente un chat. Devuelve un 403 si falta el permiso o un 404 si ya se ha eliminado, y está sujeto a las políticas de retención de arrendatarios.

Parámetros necesarios: chat-id

mcp_graph_chat_deleteChatMessage

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

Elimina temporalmente un mensaje de chat. Devuelve un código 403 sin Chat.ReadWrite, un código 404 para identificadores no válidos y puede conservar el mensaje para el cumplimiento.

Parámetros necesarios: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Recupera un chat por identificador. Devuelve metadatos como el tipo y el tema. Devuelve un 404 si el chat no existe o no está visible, o un 403 si se deniegan los permisos.

Parámetros necesarios: chat-id

mcp_graph_chat_getChatMessage

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

Recupera un mensaje de chat por ID. Devuelve un 404 si el mensaje no existe o está oculto, o un 403 sin derechos adecuados.

Parámetros requeridos: chat-id, message-id

mcp_graph_chat_listChatMembers

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

Enumera participantes al chat. Devuelve los roles del sistema (miembro, propietario o invitado). Devuelve un 403 sin permisos de lectura o 404 si no se encuentra el chat.

Parámetros necesarios: chat-id

mcp_graph_chat_listChatMessages

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

Enumera los mensajes de un chat con $top, $filter y $orderby opcionales. Devuelve resultados paginados. El cumplimiento puede ocultar el contenido. Los errores incluyen un código de estado HTTP 400 para consultas incorrectas y un código de estado HTTP 429 para la restricción.

Parámetros necesarios: chat-id

Parámetros opcionales:$top, $filter, $orderby

mcp_graph_chat_listChats

Punto final:GET /v1.0/chats

Enumera los chats para el autor de la llamada con $top, $filter, $expand y $orderby, opcionales. Devuelve solo chats visibles; es posible que se excluyan los chats ocultos o del sistema. Devuelve 400 para expresiones de ordenación no válidas.

Parámetros opcionales:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

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

Publica un nuevo mensaje de texto sin formato en un chat. Necesita chat-id y un body.content no vacío; solo se admite texto. Podría devolver un código 429 por limitación, un 403 si no hay permisos, o un 404 si el chat no es válido. No idempotent—avoid intentos a ciegas.

Parámetros necesarios: chat-id, body

mcp_graph_chat_updateChat

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

Actualiza las propiedades de chat, como el tema solo para chats grupales. Se produce un error 400 si se usa en un chat uno en uno, 403 sin derechos o 404 si no se encuentra el chat.

Parámetros necesarios: id-del-chat, tema

mcp_graph_chat_updateChatMessage

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

Actualiza un mensaje de chat con nuevo contenido de texto sin formato. Algunos mensajes de cumplimiento o sistema bloquean la edición. La operación devuelve un 403 o un 400 si no se permite la edición, o un 409 para conflictos.

Parámetros requeridos: chat-id, message-id

Herramientas de canales y equipos

mcp_graph_teams_addChannelMember

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

Agrega un miembro a un canal privado o compartido mediante user@odata.bind, @odata.typey roles opcionales (propietario o vacío). Se produce un error en los canales estándar. Devuelve 409 si el miembro ya está presente y 403 si no tiene permisos.

Parámetros requeridos: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_equipos_crearCanal

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

Crea un canal en un equipo con displayName, descripción opcional, (estándar, membershipType privado, compartido) y miembros opcionales. Los canales privados o compartidos requieren miembros explícitos. Los duplicados o la membresía no válida provocan un error 400 o 409.

Parámetros necesarios: team-id, displayName

Parámetros opcionales: descripción, tipoDeMembresía, miembros

mcp_graph_teams_crearCanalPrivado

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

Crea un canal privado configurando membershipType en private. Debe incluir miembros al crear el canal y la lista de miembros debe tener al menos un propietario. Devuelve 400 si faltan los miembros, 409 para nombres duplicados o 403 si el autor de la llamada no tiene permisos.

Parámetros necesarios: team-id, displayName, members

mcp_graph_teams_getChannel

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

Recupera un canal con opcional $select y $filter. Devuelve el 404 si no se encuentra el canal o la persona que realiza la llamada carece de acceso, el 403 si los permisos son insuficientes o el 400 para filtros no admitidos.

Parámetros necesarios: team-id, channel-id

Parámetros opcionales:$select, $filter

mcp_graph_teams_getTeam

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

Recupera las propiedades del equipo con las opciones de $select y $expand opcionales. Devuelve un valor 403 o 404 si el equipo no es accesible.

Parámetros obligatorios: team-id

Parámetros opcionales:$select, $expand

mcp_graph_teams_listChannelMembers

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

Enumera todos los miembros de un canal de Microsoft Teams específico. Devuelve metadatos sobre cada miembro, como identidad, roles y estado de pertenencia. Esta información es útil para auditar la participación del canal, comprobar la pertenencia antes de las actualizaciones de roles o garantizar el cumplimiento.

Parámetros necesarios: team-id, channel-id

Parámetros opcionales:$top, $expand

mcp_graph_teams_listChannelMessages

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

Enumera los mensajes de un canal. Utilice los parámetros opcionales $top y $expand para personalizar los resultados. Por ejemplo, use $expand para incluir respuestas. La paginación se controla mediante @odata.nextLink. Devuelve 403 sin permiso de lectura o 400 para las opciones de consulta no válidas.

Parámetros necesarios: team-id, channel-id

Parámetros opcionales:$top, $expand

mcp_graph_teams_listChannels

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

Enumera los canales de un equipo. Utilice los parámetros opcionales $select o $filter para personalizar los resultados. Devuelve canales privados y compartidos solo si el autor de la llamada es miembro. Se produce un error 403 si el autor de la llamada carece de derechos de lectura o 400 en consultas de OData no válidas.

Parámetros obligatorios: team-id

Parámetros opcionales:$select, $filter

mcp_graph_teams_listTeams

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

Enumera los equipos a los que se unió un usuario específico. Devuelve solo las membresías de ese usuario, no todos los equipos de clientes. Devuelve un 403 si el autor de la llamada no puede consultar al usuario o a 404 si el identificador no es válido.

Parámetros obligatorios: user-id

mcp_graph_teams_postChannelMessage

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

Publica un mensaje de texto sin formato en un canal. Requiere team-id, channel-id y body.content. Devuelve 403 sin ChannelMessage.Send, 404 si no se encuentra el canal o 400 si falta contenido.

Parámetros obligatorios: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

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

Responde a un mensaje de un canal mediante body.content. Solo se admite texto sin formato. Devuelve 404 si no se encuentra el mensaje primario, 403 sin derechos o 400 para contenido no válido.

Parámetros obligatorios: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Punto final:PATCH /teams/{team-id}/channels/{channel-id}

Actualiza un canal con un nuevo displayName o una descripción. Podrían aplicarse restricciones a canales especiales como General. Devuelve un 403 por falta de derechos, un 409 por nombres duplicados o un 400 por entrada no válida.

Parámetros necesarios: team-id, channel-id

Parámetros opcionales: displayName, description

mcp_graph_teams_updateChannelMember

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

Actualiza el rol de un miembro en un canal privado o compartido cambiando los roles. Los canales estándar heredan los roles del equipo y normalmente rechazan las actualizaciones. Devuelve un 400 si se intenta en canales estándar, 403 si no está autorizado o 404 si no se encuentra el miembro.

Parámetros requeridos: team-id, channel-id, membership-id, roles

Operaciones soportadas

• Administración del chat (crear, leer, actualizar, eliminar)
• Operaciones de mensaje (enviar, recuperar, editar, eliminar)
• Administración de canales (crear, configurar, enumerar)
• Administración de miembros (agregar, actualizar, enumerar)
• Operaciones de equipo (recuperar, enumerar)

Características clave

• Operaciones completas de creación, lectura, actualización y eliminación (CRUD) para chats y canales
• Compatibilidad con canales privados, compartidos y estándar
• Subprocesos y respuestas de mensajes
• Administración de roles de miembros
• Compatibilidad con consultas de OData para filtrado y paginación