Referencia del servidor MCP de Microsoft Teams

Importante

Debe formar parte del programa de versión preliminar de Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Información general

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

Herramientas de chat

mcp_graph_chat_addChatMember

Punto de conexión: 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 409 si el miembro ya está presente, 400 para referencias de usuario no válidas o 403 si las directivas restringen la adición.

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

mcp_graph_chat_createChat

Punto de conexión: POST /v1.0/chats

Crea un nuevo chat de Teams con chatType (oneOnOne requiere exactamente dos participantes, el grupo requiere más de dos) y miembros. Devuelve 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 necesarios: chatType, miembros

mcp_graph_chat_deleteChat

Punto de conexión: DELETE /v1.0/chats/{chat-id}

Elimina temporalmente un chat. Devuelve 403 si falta el permiso, 404 si ya se ha eliminado y está sujeto a directivas de retención de inquilinos.

Parámetros necesarios: chat-id

mcp_graph_chat_deleteChatMessage

Punto de conexión: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Elimina temporalmente un mensaje de chat. Devuelve 403 sin Chat.ReadWrite, 404 para id. no válidos y puede conservar todavía el mensaje para cumplimiento.

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

mcp_graph_chat_getChat

Punto de conexión: GET /v1.0/chats/{chat-id}

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

Parámetros necesarios: chat-id

mcp_graph_chat_getChatMessage

Punto de conexión: GET /v1.0/chats/{chat-id}/messages/{message-id}

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

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

mcp_graph_chat_listChatMembers

Punto de conexión: GET /v1.0/chats/{chat-id}/members

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

Parámetros necesarios: chat-id

mcp_graph_chat_listChatMessages

Punto de conexión: 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 400 para consultas incorrectas y 429 para limitación.

Parámetros necesarios: chat-id

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

mcp_graph_chat_listChats

Punto de conexión: GET /v1.0/chats

Enumera los chats del 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 de conexión: POST /v1.0/chats/{chat-id}/messages

Publica un nuevo mensaje de texto sin formato en un chat. Necesita chat-id y body.content no vacío; solo se admite texto. Puede devolver 429 para limitación, 403 si faltan permisos o 404 si el chat no es válido. No idempotente: evite reintentos ciegos.

Parámetros necesarios: chat-id, body

mcp_graph_chat_updateChat

Punto de conexión: 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: chat-id, topic

mcp_graph_chat_updateChatMessage

Punto de conexión: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Actualiza un mensaje de chat con nuevo contenido de texto sin formato. Es posible que la edición se bloquee para algunos mensajes de cumplimiento o del sistema. Devuelve 403 o 400 si no se permite la edición o 409 en conflictos.

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

Herramientas de canal y equipo

mcp_graph_teams_addChannelMember

Punto de conexión: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Agrega un miembro a un canal privado o compartido con user@odata.bind, @odata.type y 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 necesarios: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Punto de conexión: POST /v1.0/teams/{team-id}/channels

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

Parámetros necesarios: team-id, displayName

Parámetros opcionales: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Punto de conexión: POST /v1.0/teams/{team-id}/channels

Crea un canal privado con membershipType: private. Requiere miembros en la creación, incluido al menos un propietario. Devuelve 400 si faltan miembros, 409 para nombres duplicados o 403 sin permisos.

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

mcp_graph_teams_getChannel

Punto de conexión: GET /v1.0/teams/{team-id}/channels/{channel-id}

Recupera un canal con $select y $filter opcionales. Devuelve 404 si el canal no encontrado o el autor de la llamada carece de acceso, 403 si los permisos no son suficientes o 400 para los filtros no admitidos.

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

Parámetros opcionales: $select, $filter

mcp_graph_teams_getTeam

Punto de conexión: GET /v1.0/teams/{team-id}

Recupera las propiedades del equipo con $select y $expand opcionales. Devuelve 403 o 404 si el equipo es inaccesible.

Parámetros obligatorios: team-id

Parámetros opcionales: $select, $expand

mcp_graph_teams_listChannelMembers

Punto de conexión: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Enumera todos los miembros de un canal específico de Microsoft Teams, devolviendo metadatos sobre cada miembro, como identidad, roles y estado de pertenencia. Resulta ú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 de conexión: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Enumera los mensajes de un canal con $top y $expand opcionales (por ejemplo, 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 de conexión: GET /v1.0/teams/{team-id}/allChannels

Enumera los canales de un equipo con $select o $filter opcionales. Devuelve canales privados y compartidos solo si el autor de la llamada es miembro. Se produce un error con 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 de conexión: GET /v1.0/users/{user-id}/joinedTeams

Enumera los equipos unidos de un usuario específico. Devuelve solo las pertenencias de ese usuario, no todos los equipos de inquilinos. Devuelve 403 si el autor de la llamada no puede consultar al usuario o 404 si el id. no es válido.

Parámetros obligatorios: user-id

mcp_graph_teams_postChannelMessage

Punto de conexión: 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 de conexión: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Responde a un mensaje de un canal con 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 de conexión: PATCH /teams/{team-id}/channels/{channel-id}

Actualiza un canal con displayName o description nuevos. Las restricciones se pueden aplicar a canales especiales, como General. Devuelve 403 sin derechos, 409 en nombres duplicados o 400 para la entrada no válida.

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

Parámetros opcionales: displayName, description

mcp_graph_teams_updateChannelMember

Punto de conexión: 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 400 si se ha intentado en canales estándar, 403 si no está autorizado o 404 si no se encuentra el miembro.

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

Operaciones admitidas

1. Administración del chat (crear, leer, actualizar, eliminar)
2. Operaciones de mensaje (enviar, recuperar, editar, eliminar)
3. Administración de canales (crear, configurar, enumerar)
4. Administración de miembros (agregar, actualizar, enumerar)
5. Operaciones de equipo (recuperar, enumerar)

Características clave

1. Operaciones CRUD completas para chats y canales
2. Compatibilidad con canales privados, compartidos y estándar
3. Subprocesos y respuestas de mensajes
4. Administración de roles de miembros
5. Compatibilidad con consultas de OData para filtrado y paginación