Microsoft Teams
Microsoft Teams와 연결하여 팀/채널 관리, 메시지 전송, 채팅, 사용자 검색 등의 커뮤니케이션 기능을 사용할 수 있습니다.
개인용 Microsoft 계정(Personal Microsoft Account)으로 연동할 경우, 팀 목록 불러오기, 사용자 검색, 메시지 전송 등 대부분의 기능을 정상적으로 사용할 수 없습니다. 이는 Microsoft Graph API 공식 스펙에 따른 제한사항입니다. 모든 기능을 사용하려면 조직(회사/학교) 계정으로 연동해야 합니다.
주요 기능
- 참여한 팀 및 채널 목록 조회
- 채널 메시지 전송 및 조회
- 1:1 및 그룹 채팅 관리
- 메시지 검색 (KQL 쿼리 지원)
- 스레드 답글 작성 및 조회
- 팀 멤버 및 사용자 검색
- HTML 포맷 및 @멘션 지원
- 새 채팅 생성
기본 정보
인증 방식
OAuth 2.0을 사용하여 인증합니다.
지원하는 MCP 도구
API 요청 도구
request
Microsoft Teams Graph API에 직접 요청을 보내는 범용 도구입니다.
팀 관리 도구
list-joined-teams
사용자가 참여한 모든 Microsoft Teams 목록을 조회합니다. 팀 이름, 설명, ID를 반환합니다.
list-channels
특정 Microsoft Team의 모든 채널을 조회합니다.
입력 파라미터:
team-id(필수): 팀 ID
list-team-members
Microsoft Team의 모든 멤버를 조회합니다.
입력 파라미터:
team-id(필수): 팀 ID
채널 메시지 도구
get-channel-messages
Teams 채널의 최근 메시지를 조회합니다.
send-channel-message
Teams 채널에 메시지를 전송합니다. 텍스트, HTML 포맷, @멘션을 지원합니다.
입력 파라미터:
team-id(필수): 팀 IDchannel-id(필수): 채널 IDcontent(필수): 메시지 내용contentType(선택): 콘텐츠 타입 (text/html)userMentions(선택): 사용자 멘션 목록channelMentions(선택): 채널 멘션 목록
send-thread-reply
Teams 채널의 특정 메시지 스레드에 답글을 작성합니다.
입력 파라미터:
team-id(필수): 팀 IDchannel-id(필수): 채널 IDmessage-id(필수): 메시지 IDcontent(필수): 답글 내용contentType(선택): 콘텐츠 타입 (text/html)userMentions(선택): 사용자 멘션 목록
get-thread-replies
Teams 채널의 특정 메시지 스레드에 대한 모든 답글을 조회합니다.
입력 파라미터:
team-id(필수): 팀 IDchannel-id(필수): 채널 IDmessage-id(필수): 메시지 ID
채팅 도구
list-chats
사용자가 참여한 모든 1:1 및 그룹 채팅을 조회합니다.
get-chat-messages
특정 채팅의 최근 메시지를 조회합니다.
입력 파라미터:
chat-id(필수): 채팅 ID
send-chat-message
채팅(1:1 또는 그룹)에 메시지를 전송합니다. 텍스트, HTML 포맷, @멘션을 지원합니다.
입력 파라미터:
chat-id(필수): 채팅 IDcontent(필수): 메시지 내용contentType(선택): 콘텐츠 타입 (text/html)userMentions(선택): 사용자 멘션 목록
create-chat
지정된 사용자와 새로운 1:1 또는 그룹 채팅을 생성합니다.
입력 파라미터:
members(필수): 채팅에 참여할 사용자 목록
검색 도구
search-messages
Microsoft Search API와 KQL 쿼리 구문을 사용하여 Teams 전체에서 메시지를 검색합니다.
입력 파라미터:
query(필수): KQL 검색 쿼리
search-users
조직 내 사용자를 이름 또는 이메일로 검색합니다.
입력 파라미터:
query(필수): 검색 쿼리
사용 예시
예를 들어,
- Prompt로 “Teams의 ‘개발팀’ 채널에 ‘배포 완료되었습니다’ 메시지를 보내줘”라고 입력하면,
- LLM은 MCP를 통해
send-channel-message도구를 호출하여 메시지를 전송합니다. - 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.