메모
이 글의 특징들은 표준 하네스로 구동되며, 표준 하네스로 구동되는 에이전트에 대한 라이선스 청구 옵션을 사용합니다. Access 표준 에이전트와 에이전트 플로우에서 표준 기능에 접근하는 방법을 배워보세요.
Important
미리 보기 기능입니다.
- Microsoft 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 미리 보기 기능을 릴리스합니다.
- 미리 보기 기능은 기능이 제한되어 있으며 프로덕션용으로 사용되지 않습니다.
- Microsoft 미리 보기 MCP 도구 이름 및 매개 변수를 변경할 수 있습니다. 하드 코딩된 종속성을 방지합니다. Microsoft 시나리오 지원을 유지 관리합니다.
- 미리 보기 기능은 Microsoft 추가 사용 약관 적용됩니다.
Overview
| 서버 ID | 테넌트 수준의 URL | 표시 이름 | Scope | Description |
|---|---|---|---|---|
mcp_TeamsServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_TeamsServer |
Teams | McpServers.Teams.All |
Microsoft Teams 도구들은 채팅, 채널, 사용자 또는 메시지 내의 관리를 위한 것입니다. 채팅 및 채팅 메시지 만들기, 업데이트 및 검색, 팀 및 채널 관리 및 이러한 작업과 관련된 관리 작업 수행과 같은 이 MCP Server for Teams 작업을 사용합니다. |
채팅 도구
mcp_그래프_채팅_회원_추가
끝점:POST /v1.0/chats/{chat-id}/members
및 선택적 역할(멤버, 소유자)을 사용하여 user@odata.bind@odata.type채팅에 구성원을 추가합니다. 멤버가 이미 있는 경우 409 오류 코드, 잘못된 사용자 참조에 대한 400 오류 코드 또는 정책에서 추가를 제한하는 경우 403 오류 코드를 반환합니다.
필수 매개 변수: chat-id, @odata.type, user@odata.bind, 역할
mcp_graph_chat_createChat
끝점:POST /v1.0/chats
chatType(oneOnOne에는 정확히 두 명의 참가자가 필요하며, 그룹에는 두 명을 초과하는 참가자가 필요함) 및 구성원과 함께 새 Teams 채팅을 만듭니다. 잘못된 멤버 수가 있는 경우 oneOnOne 400을 반환하고, 동일한 참가자가 이미 채팅을 한 경우 409를 반환하고, 호출자에게 권한이 없는 경우 403을 반환합니다.
필수 매개 변수:chatType, 멤버
mcp_graph_chat_deleteChat
끝점: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
채팅 메시지를 일시 삭제합니다.
Chat.ReadWrite 없이 403을 반환하고, 잘못된 ID에 대해서는 404를 반환하며, 규정 준수를 위해 메시지를 계속 보관할 수도 있습니다.
필수 매개 변수: user-id, chat-id, chatMessage-id
mcp_graph_chat_getChat
끝점:GET /v1.0/chats/{chat-id}
ID로 채팅을 검색합니다. 형식 및 토픽과 같은 메타데이터를 반환합니다. 채팅이 없거나 표시되지 않는 경우 404를 반환하고, 사용 권한이 거부되면 403을 반환합니다.
필수 매개 변수: chat-id
mcp_graph_chat_getChatMessage
끝점:GET /v1.0/chats/{chat-id}/messages/{message-id}
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 .
필수 매개 변수: chat-id, 본문
mcp_graph_chat_updateChat
끝점:PATCH /v1.0/chats/{chat-id}
그룹 채팅에 대한 토픽과 같은 채팅 속성을 업데이트합니다. 일대일 채팅에서 사용되는 경우 400, 권한 없는 403, 채팅을 찾을 수 없는 경우 404로 실패합니다.
필수 매개 변수: chat-id, 토픽
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 채널의 모든 멤버를 나열합니다. ID, 역할 및 멤버 자격 상태와 같은 각 멤버에 대한 메타데이터를 반환합니다. 이 정보는 채널 참여를 감사하거나, 역할 업데이트 전에 멤버 자격을 확인하거나, 규정 준수를 확인하는 데 유용합니다.
필수 매개 변수: 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 오류를 반환하고, OData 쿼리가 잘못된 경우 400 오류를 반환합니다.
필수 매개 변수: team-id
선택적 매개 변수:$select, $filter
mcp_graph_teams_listTeams
끝점:GET /v1.0/users/{user-id}/joinedTeams
특정 사용자의 조인된 팀을 나열합니다. 모든 테넌트 팀이 아닌 해당 사용자의 멤버 자격만 반환합니다. 호출자가 사용자를 쿼리할 수 없는 경우 403을 반환하고 ID가 잘못된 경우 404를 반환합니다.
필수 매개 변수: user-id
mcp_graph_teams_postChannelMessage
끝점:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages
채널에 일반 텍스트 메시지를 게시합니다. team-id, channel-id 및 body.content가 필요합니다. ChannelMessage.Send가 없는 403, 채널을 찾을 수 없는 경우 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 또는 설명으로 채널을 업데이트합니다.
제한 사항은 일반과 같은 특수 채널에 적용될 수 있습니다. 권한이 없는 403, 중복 이름에 대해 409 또는 잘못된 입력의 경우 400을 반환합니다.
필수 매개 변수: team-id, channel-id
선택적 매개 변수: displayName, description
mcp_graph_teams_updateChannelMember
끝점:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}
역할을 변경하여 프라이빗 또는 공유 채널에서 멤버의 역할을 업데이트합니다. 표준 채널은 팀에서 역할을 상속하며 일반적으로 업데이트를 거부합니다. 표준 채널에서 시도된 경우 400을 반환하고, 권한이 없는 경우 403을 반환하고, 멤버를 찾을 수 없는 경우 404를 반환합니다.
필수 매개 변수: 팀 ID, 채널 ID, 멤버 자격 ID, 역할
지원되는 작업
- 채팅 관리(만들기, 읽기, 업데이트, 삭제)
- 메시지 작업(보내기, 검색, 편집, 삭제)
- 채널 관리(만들기, 구성, 나열)
- 멤버 관리(추가, 업데이트, 목록)
- 팀 작업(검색, 나열)
주요 기능
- 채팅 및 채널에 대한 CRUD(전체 만들기, 읽기, 업데이트 및 삭제) 작업입니다.
- 프라이빗, 공유 및 표준 채널에 대한 지원.
- 메시지 스레딩 및 회신
- 멤버 역할 관리.
- 필터링 및 페이지 매김에 대한 OData 쿼리 지원.