MCP Teams Summarizer

Teams 채널의 대화 내용을 가져오는 역할을 수행하는 MCP 서버입니다.

주요 기능

• Teams 채팅방의 대화 내용 요약
• 다양한 요약 형식 지원
  • 간단 요약 (brief)
  • 상세 요약 (detailed)
  • 주요 포인트 (bullet_points)
  • 액션 아이템 (action_items)
• Teams 목록 및 채널 조회
• 원본 메시지 데이터 조회

환경 설정

MCP 클라이언트 설정에서 다음 환경변수들을 설정해주세요:

{
  "mcpServers": {
    "teams-summarizer": {
      "command": "npx",
      "args": ["mcp-teams-summarizer"],
      "env": {
        "AZURE_APP_TENANT_ID": "your-tenant-id",
        "AZURE_APP_CLIENT_ID": "your-client-id",
        "AZURE_APP_SECRET_VALUE": "your-secret-value"
      }
    }
  }
}

사용 가능한 명령어

1. summarize-teams-chat: Teams 채팅방의 대화 내용을 요약

   • 필수 파라미터:
     • teamId: Teams 팀 ID
     • channelId: Teams 채널 ID
     • startTime: 요약 시작 시간 (ISO 8601)
   • 선택 파라미터:
     • endTime: 요약 종료 시간 (기본값: 현재 시간)
     • maxMessages: 최대 메시지 수 (1-1000, 기본값: 100)
     • summaryType: 요약 유형 (brief/detailed/bullet_points/action_items)

권한 요구사항

• Microsoft Graph API 접근을 위한 Azure AD 앱 등록 필요
• 필요한 API 권한: ChannelMessage.Read.All

오류 처리

다음과 같은 일반적인 오류 상황에 대한 처리를 포함하고 있습니다:

• 인증 실패 (401)
• 권한 부족 (403)
• 리소스 미존재 (404)
• API 요청 한도 초과 (429)
• 잘못된 요청 (400)

요약 유형 상세 설명

각 요약 유형별 특징과 결과물 포맷은 다음과 같습니다:

1. 간단 요약 (brief)

   • 대화의 핵심 내용을 2-3문장으로 간단히 요약
   • 전체적인 맥락을 빠르게 파악하기 위한 용도

2. 상세 요약 (detailed)

   • 다음 항목들에 대한 구조화된 상세 요약 제공:
     • 주요 논의 주제
     • 주요 결정사항
     • 참여자별 주요 의견
     • 미해결 이슈
     • 다음 단계

3. 주요 포인트 (bullet_points)

   • 대화의 중요 포인트들을 불릿 포인트 형식으로 정리
   • 핵심 내용을 한눈에 파악하기 좋은 형태

4. 액션 아이템 (action_items)

   • 실행 가능한 항목들을 중심으로 정리:
     • 결정된 액션 아이템
     • 담당자 정보
     • 마감일 정보
     • 후속 미팅/논의 예정 사항

응답 메타데이터

요약 결과에는 다음과 같은 메타데이터가 포함됩니다:

• 대화 기간 (시작 시간 ~ 종료 시간)
• 총 메시지 수
• 대화 참여자 목록
• 채널 정보

메시지 처리 특징

• HTML 태그 제거 및 특수문자 정제 처리
• 시간순 정렬 지원
• 첨부파일 및 답글 처리 지원
• 최대 1000개 메시지까지 처리 가능

성능 및 제한사항

• 한 번에 최대 50개 메시지씩 페이지네이션 처리
• Graph API 요청 한도 준수
• 대량의 메시지 처리 시 시간 간격을 적절히 조정 권장

문제 해결

일반적인 문제 해결 방법:

1. 인증 실패 (401)

   • Azure AD 앱 등록 정보 확인
   • 환경 변수 설정 검증

2. 권한 부족 (403)

   • ChannelMessage.Read.All 권한 부여 확인
   • Azure AD 앱의 API 권한 설정 검토

3. 리소스 미존재 (404)

   • teamId와 channelId 정확성 확인
   • 채널 접근 권한 확인

4. API 요청 한도 초과 (429)

   • 요청 간격 조정
   • maxMessages 값 조정 고려

5. 잘못된 요청 (400)

   • 파라미터 형식 검증 (특히 ISO 8601 날짜 형식)
   • startTime이 endTime보다 이전인지 확인