중요
Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.
개요
| 서버 ID입니다. | 표시 이름 | Scope | 설명 |
|---|---|---|---|
| mcp_TeamsServer | Microsoft Teams MCP Server | McpServers.Teams.All | Microsoft Teams Graph MCP 서버는 채팅, 채널, 사용자 또는 메시지 내의 메시지를 관리합니다. 채팅 및 채팅 메시지 만들기, 업데이트 및 검색, 팀 및 채널 관리 및 이와 관련된 관리 작업 수행과 같은 Teams 작업에 이 MCP 서버를 사용합니다. |
채팅 도구
mcp_graph_chat_addChatMember
엔드포인트: 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을 사용하여 새 Teams 채팅을 만듭니다(oneOnOne에는 정확히 두 명의 참가자가 필요하고 그룹은 2명 이상 필요) 및 구성원이 필요합니다. 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
채팅에서 새 일반 텍스트 메시지를 게시합니다. 채팅 ID 및 비어있지 않은 body.content가 필요합니다. 지원되는 텍스트만 있습니다. 제한에 대해 429를 반환하거나, 권한이 누락된 경우 403을 반환하거나, 채팅이 유효하지 않은 경우 404를 반환할 수 있습니다. idempotent가 아닙니다. 블라인드 재시도를 피하십시오.
필수 매개 변수: 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, 역할, user@odata.bind, @odata.type
mcp_graph_teams_createChannel
엔드포인트: POST /v1.0/teams/{team-id}/channels
displayName, 선택적 설명, membershipType(표준, 프라이빗, 공유) 및 선택적 멤버를 사용하여 팀에 채널을 만듭니다. 프라이빗 또는 공유 채널에는 명시적 멤버가 필요합니다. 중복되거나 잘못된 멤버 자격으로 인해 400 또는 409가 발생합니다.
필수 매개 변수: team-id, displayName
선택적 매개 변수: description, membershipType, members
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
ID, 역할 및 멤버 자격 상태와 같은 각 멤버에 대한 메타데이터를 반환하는 특정 Microsoft Teams 채널의 모든 멤버를 나열합니다. 채널 참여를 감사하거나, 역할 업데이트 전에 멤버 자격을 확인하거나, 규정 준수를 확인하는 데 유용합니다.
필수 매개 변수: team-id, channel-id
선택적 매개 변수: $top, $expand
mcp_graph_teams_listChannelMessages
엔드포인트: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages
선택적 $top 및 $expand 있는 채널의 메시지를 나열합니다(예: 회신). 페이지 매김은 .를 통해 @odata.nextLink처리됩니다. 읽기 권한이 없는 403을 반환하고 잘못된 쿼리 옵션의 경우 400을 반환합니다.
필수 매개 변수: team-id, channel-id
선택적 매개 변수: $top, $expand
mcp_graph_teams_listChannels
엔드포인트: GET /v1.0/teams/{team-id}/allChannels
선택적 $select 또는 $filter 있는 팀의 채널을 나열합니다. 호출자가 멤버인 경우에만 프라이빗 및 공유 채널을 반환합니다. 호출자가 읽기 권한이 없거나 잘못된 OData 쿼리에서 400이면 403으로 실패합니다.
필수 매개 변수: 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 쿼리 지원