Skip to Content

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 (필수): 팀 ID
  • channel-id (필수): 채널 ID
  • content (필수): 메시지 내용
  • contentType (선택): 콘텐츠 타입 (text/html)
  • userMentions (선택): 사용자 멘션 목록
  • channelMentions (선택): 채널 멘션 목록

send-thread-reply

Teams 채널의 특정 메시지 스레드에 답글을 작성합니다.

입력 파라미터:

  • team-id (필수): 팀 ID
  • channel-id (필수): 채널 ID
  • message-id (필수): 메시지 ID
  • content (필수): 답글 내용
  • contentType (선택): 콘텐츠 타입 (text/html)
  • userMentions (선택): 사용자 멘션 목록

get-thread-replies

Teams 채널의 특정 메시지 스레드에 대한 모든 답글을 조회합니다.

입력 파라미터:

  • team-id (필수): 팀 ID
  • channel-id (필수): 채널 ID
  • message-id (필수): 메시지 ID

채팅 도구

list-chats

사용자가 참여한 모든 1:1 및 그룹 채팅을 조회합니다.

get-chat-messages

특정 채팅의 최근 메시지를 조회합니다.

입력 파라미터:

  • chat-id (필수): 채팅 ID

send-chat-message

채팅(1:1 또는 그룹)에 메시지를 전송합니다. 텍스트, HTML 포맷, @멘션을 지원합니다.

입력 파라미터:

  • chat-id (필수): 채팅 ID
  • content (필수): 메시지 내용
  • 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 호출 결과를 기반으로 채팅에서 응답합니다.
Last updated on