Справочник Teams (предварительный просмотр)

Note

В этой статье описываются особенности, используемые в агентах или потоках агентов, питаемых стандартным жгутом.

Important

Это предварительная версия функции.

• Microsoft выпускает предварительные версии функций перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
• Предварительные версии функций имеют ограниченные функциональные возможности и не предназначены для использования в производственной среде.
• Microsoft может изменить названия и параметры инструментов MCP на стадии предварительной версии. Избегайте жестко закодированных зависимостей. Microsoft обеспечивает поддержку сценариев.
• Предварительные версии функции регулируются дополнительными условиями использования Microsoft.

Note

Специализированные инструменты Microsoft 365 MCP (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User и Word) предназначены только для обратной совместимости и не должны использоваться в производственных средах или новых проектах. Для новых проектов, требующих доступа к ресурсам Microsoft 365, используйте Work IQ MCP с использованием GitHub Copilot. Для получения дополнительной информации смотрите раздел Work IQ MCP in Copilot Studio.

Overview

Идентификатор сервера	URL-адрес на уровне клиента	Показать имя	Scope	Description
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Teams	McpServers.Teams.All	Инструменты Microsoft Teams для управления чатами, каналами и пользователями или сообщениями внутри них. Используйте этот MCP-сервер для операций Teams, таких как создание, обновление и получение чатов и сообщений, управление командами и каналами, а также выполнение административных задач, связанных с этими операциями.

Средства чата

mcp_graph_chat_addChatMember

Конечная точка:POST /v1.0/chats/{chat-id}/members

Добавляет участника в чат с помощью user@odata.bind, @odata.type и необязательных ролей (участник, владелец). Возвращает код ошибки 409, если участник уже присутствует, код ошибки 400 при недопустимых ссылках на пользователя или код ошибки 403, если политики запрещают добавление.

Обязательные параметры: идентификатор чата, @odata.type, user@odata.bindроли

mcp_graph_chat_createChat

Конечная точка:POST /v1.0/chats

Создает новый чат в Teams с chatType (oneOnOne требует ровно двух участников, группа — больше двух) и участниками. Возвращает 400, если oneOnOne имеет неверное количество участников, 409 если у тех же участников уже есть чат, или 403, если у инициатора запроса нет нужных прав.

Требуемые параметры:chatType, members

mcp_graph_chat_удалитьЧат

Конечная точка:DELETE /v1.0/chats/{chat-id}

Обратимое удаление чата. Возвращает 403, если отсутствуют необходимые разрешения, или 404, если чат уже удален. Политики хранения данных арендатора регулируют эту операцию.

Обязательные параметры: chat-id

mcp_graph_chat_deleteChatMessage

Конечная точка:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Мягкое удаление сообщения чата. Возвращает 403 при отсутствии Chat.ReadWrite, 404 при недействительных идентификаторах, и может все равно сохранять сообщение для соответствия.

Обязательные параметры: идентификатор пользователя, идентификатор чата, идентификатор сообщения чата

mcp_graph_chat_getChat

Конечная точка:GET /v1.0/chats/{chat-id}

Извлекает чат по идентификатору. Возвращает метаданные, такие как тип и тема. Возвращает 404, если чат не найден или скрыт, или 403 при отсутствии необходимых разрешений.

Обязательные параметры: chat-id

mcp_graph_chat_getChatMessage

Конечная точка:GET /v1.0/chats/{chat-id}/messages/{message-id}

Извлекает сообщение чата по идентификатору. Возвращает 404, если сообщение отсутствует или скрыто, или 403 при отсутствии соответствующих прав.

Обязательные параметры: chat-id, message-id

mcp_graph_chat_listChatMembers

Конечная точка:GET /v1.0/chats/{chat-id}/members

Выводит список участников чата. Возвращает роли (участник, владелец или гость). Возвращает 403 при отсутствии разрешений на чтение или 404, если чат не найден.

Обязательные параметры: chat-id

mcp_graph_chat_listChatMessages

Конечная точка:GET /v1.0/chats/{chat-id}/messages

Перечисляет сообщения в чате, с необязательными параметрами $top, $filter и $orderby. Возвращает результаты с разбивкой по страницам. Политики соответствия могут скрывать содержимое. Ошибки включают 400 — неверные запросы и 429 — превышение лимита запросов.

Обязательные параметры: chat-id

Необязательные параметры:$top, $filter, $orderby

mcp_graph_chat_listChats

Конечная точка:GET /v1.0/chats

Перечисляет чаты для инициатора запроса, с необязательными параметрами $top, $filter, $expand и $orderby. Возвращает только видимые чаты; Скрытые или системные чати могут быть исключены. Возвращает 400 в случае недопустимых выражений сортировки.

Необязательные параметры:$top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Конечная точка:POST /v1.0/chats/{chat-id}/messages

Публикует новое текстовое сообщение в чате. Требуются chat-id и body.content, который не должен быть пустым; поддерживается только текст. Может возвращать 429 при регулировании количества запросов, 403 при отсутствии разрешений, или 404, если чат недействителен. Слепые повторные попытки idempotent—avoid не делаются.

Обязательные параметры: чат-идентификатор, текст

mcp_graph_chat_updateChat

Конечная точка:PATCH /v1.0/chats/{chat-id}

Обновляет свойства чата, например раздел только для групповых чатов. Возвращает ошибку 400, если используется в личном чате, 403 без доступа, или 404, если чат не найден.

Обязательные параметры: идентификатор чата, раздел

mcp_graph_chat_updateChatMessage

Конечная точка:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Обновляет сообщение чата с новым текстовым содержимым. Некоторые системные сообщения или сообщения, необходимые для соответствия, блокируют редактирование. Операция возвращает 403 или 400, если редактирование запрещено, или 409 при возникновении конфликтов.

Обязательные параметры: chat-id, message-id

Инструменты канала и команды

mcp_graph_teams_addChannelMember

Конечная точка:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Добавляет участника в частный или общий канал с использованием user@odata.bind, @odata.type и необязательной роли (владельца или без роли). Не работает на стандартных каналах. Возвращает 409, если участник уже добавлен, и 403 в случае нехватки разрешений.

Обязательные параметры: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Конечная точка:POST /v1.0/teams/{team-id}/channels

Создает канал в команде с displayName, необязательным описанием, membershipType (стандартный, частный, общий) и необязательными участниками. Для частных или общих каналов необходимо явно указывать участников. Дублирующиеся или недействительные участники приводят к ошибкам 400 или 409.

Обязательные параметры: team-id, displayName

Необязательные параметры: описание, тип членства, участники

mcp_graph_teams_createPrivateChannel

Конечная точка:POST /v1.0/teams/{team-id}/channels

Создает частный канал, устанавливая membershipType в значение private. При создании канала необходимо указать участников, и в списке участников должен быть как минимум один владелец. Возвращает 400, если не указаны участники, 409, если имя уже используется, или 403, если у инициатора запроса нет разрешений.

Обязательные параметры: team-id, displayName, участники

mcp_graph_teams_getChannel

Конечная точка:GET /v1.0/teams/{team-id}/channels/{channel-id}

Извлекает канал, с необязательными параметрами $select и $filter. Возвращает 404, если канал не найден или отсутствует доступ, 403, если разрешений недостаточно, и 400 при неподдерживаемых фильтрах.

Обязательные параметры: team-id, channel-id

Необязательные параметры:$select, $filter

mcp_graph_teams_getTeam

Конечная точка:GET /v1.0/teams/{team-id}

Извлекает свойства команды, с необязательными параметрами $select и $expand. Возвращает 403 или 404, если команда недоступна.

Обязательные параметры: team-id

Необязательные параметры:$select, $expand

mcp_graph_teams_listChannelMembers

Конечная точка:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Перечисляет всех участников конкретного канала Microsoft Teams. Возвращает метаданные о каждом участнике, такие как идентификатор, роли и статус членства. Эта информация полезна для аудита участия в каналах, проверки членства перед обновлением ролей или обеспечения соответствия.

Обязательные параметры: team-id, channel-id

Необязательные параметры:$top, $expand

mcp_graph_teams_listChannelMessages

Конечная точка:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Перечисляет сообщения в канале. Используйте необязательные параметры $top и $expand для настройки результатов. Например, используйте $expand для включения ответов. Разбиение на страницы выполняется через @odata.nextLink. Возвращает 403 при отсутствии права на чтение или 400 при некорректных параметрах запроса.

Обязательные параметры: team-id, channel-id

Необязательные параметры:$top, $expand

mcp_graph_teams_listChannels

Конечная точка:GET /v1.0/teams/{team-id}/allChannels

Перечисляет каналы в команде. Используйте необязательные параметры $select или $filter для настройки результатов. Возвращает частные и общие каналы только, если вызывающая сторона является членом. Возвращает ошибку 403, если у инициатора запроса нет прав на чтение, или ошибку 400 при некорректных OData-запросах.

Обязательные параметры: team-id

Необязательные параметры:$select, $filter

mcp_graph_teams_listTeams

Конечная точка:GET /v1.0/users/{user-id}/joinedTeams

Перечисляет присоединенные команды определенного пользователя. Возвращает только членство этого пользователя, а не все команды клиентов. Возвращает 403, если инициатор запроса не может запрашивать пользователя, или 404, если идентификатор недействителен.

Обязательные параметры: идентификатор пользователя

mcp_graph_teams_postChannelMessage

Конечная точка:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Отправляет в канал сообщение с открытым текстом. Требуется идентификатор команды, идентификатор канала и body.content. Возвращает 403 при отсутствии ChannelMessage.Send, 404, если канал не найден, или 400, если отсутствует контент.

Обязательные параметры: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

Конечная точка:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Отвечает на сообщение в канале, используя body.content. Поддерживается только обычный текст. Возвращает 404, если родительское сообщение не найдено, 403 при отсутствии прав или 400 при недопустимом содержимом.

Обязательные параметры: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Конечная точка:PATCH /teams/{team-id}/channels/{channel-id}

Обновляет канал новым displayName или описанием. К специальным каналам, таким как General, могут применяться ограничения. Возвращает 403 при отсутствии прав, 409 при дублировании имен или 400 при некорректном вводе.

Обязательные параметры: team-id, channel-id

Необязательные параметры: displayName, описание

mcp_graph_teams_updateChannelMember

Конечная точка:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Обновляет роль участника в частном или общем канале, изменяя роли. Стандартные каналы наследуют роли от команды и обычно отклоняют обновления. Возвращает 400 при попытке выполнить операцию на стандартных каналах, 403 при отсутствии прав или 404, если участник не найден.

Обязательные параметры: team-id, channel-id, membership-id, роли

Поддерживаемые операции

• Управление чатом (создание, чтение, обновление, удаление)
• Операции сообщения (отправка, извлечение, изменение, удаление)
• Управление каналами (создание, настройка, список)
• Управление членами (добавление, обновление, список)
• Действия команды (получение, перечисление)

Ключевые особенности

• Полный набор операций создания, чтения, обновления и удаления (CRUD) для чатов и каналов.
• Поддержка частных, совместных и стандартных каналов.
• Работа с цепочками сообщений и ответами.
• Управление ролями участников.
• Поддержка OData-запросов для фильтрации и разбивки на страницы.