본문으로 건너뛰기

Kollus MCP

Kollus Live 기능 미지원 안내

정식 Kollus MCP 서버는 Live 조회 및 JWT 검증 기능을 제공하지 않습니다. 해당 기능이 필요한 경우 Kollus MCP 베타 서버(mcp-beta.kollus.com)를 이용해 주세요.

Kollus MCP 서버란?​

Kollus MCP 서버는 Claude, ChatGPT와 같은 생성형 AI가 Kollus 공식 가이드, API 명세, 샘플 코드 및 워크스페이스 내 VOD 데이터를 자연어로 조회하고 활용할 수 있도록 지원하는 원격 MCP(Model Context Protocol) 서버입니다. 연동을 완료하면 AI 대화창에 질문하는 것만으로 Kollus 문서를 검색하고 API를 호출해 필요한 작업을 수행할 수 있습니다.

Kollus MCP 서버 연동 정보​

  • 서버 URL: https://mcp.kollus.com/mcp
  • 인증 방식: OAuth (Kollus VOD 콘솔 계정 인증)

사전 준비 사항​

연동 과정에서 Kollus MCP 로그인 화면이 나타납니다. 원활한 진행을 위해 아래 계정 정보를 미리 확인해 두세요.

항목입력 값확인 경로
아이디Kollus VOD 콘솔 로그인 이메일-
비밀번호Kollus VOD 콘솔 로그인 비밀번호-
리전한국(KR) / 일본(JP) / 글로벌(EN)Kollus VOD 콘솔 접속 리전 선택
서비스 계정 키워크스페이스 식별용 키Kollus VOD 콘솔 > [워크스페이스 설정] > [서비스 정보] > [서비스 계정 키]

AI 서비스별 연동 방법​

웹 또는 앱에서 연결하기​

  1. mcp.kollus.com 커넥터 연결 페이지로 이동한 후 [Claude에 연결]을 클릭합니다.
    커뮤니티 라벨 안내

    Kollus 커넥터에 표시되는 커뮤니티 라벨 및 안내 문구는 디렉터리에 등록된 서드파티 커넥터에 기본으로 부여되는 라벨입니다. mcp.kollus.com은 Kollus가 직접 공식 운영하는 커넥터입니다.

  2. Kollus MCP 로그인 창이 열리면 사전에 준비한 계정 정보를 입력하고 로그인합니다. (상단 [사전 준비 사항] 섹션 참고)
  3. 로그인 후 상태가 '연결됨'으로 변경되었는지 확인합니다.
  4. 대화 입력창의 [+] > [커넥터] 메뉴에서 mcp.kollus.com 토글이 활성화되어 있는지 확인합니다.

터미널에서 연결하기​

claude mcp add --transport http kollus https://mcp.kollus.com/mcp

프롬프트 활용 예시​

연결 완료 후 대화창에 아래 예시처럼 자연어로 질문을 입력해 보세요.

  • 인코딩 상태 확인

    "인코딩 오류(error) 상태인 영상 목록 보여줘" → 조건에 해당하는 영상 목록을 즉시 조회합니다.

  • 메타데이터 분석

    "upload_file_key=xxx 영상의 트랜스코딩 상태와 암호화 여부 알려줘" → 특정 영상의 상세 메타데이터와 상태값을 확인합니다.

  • 통계 리포트 생성

    "지난달 영상별 시청 순위 상위 10개 보여줘" → 통계 데이터를 기반으로 VOD 시청 순위를 보여줍니다.

  • 개발 가이드 검색

    "DRM 다운로드 콜백 kind 1 응답 필드 알려줘" → 공식 개발 가이드 문서를 검색해 정확한 스펙을 안내합니다.

주요 기능​

  • 문서 검색: 공식 가이드, API 명세, 샘플 코드, 에러 코드, 안티패턴 검색 및 문서 본문 조회
  • VOD 조회: 영상 목록 및 메타데이터, 카테고리, 채널, 인코딩 프로파일 조회
  • 통계 조회: 일별 전송량, 트래픽, 스토리지, 트랜스코딩, 방문자 통계, 영상별 시청 순위 조회
  • 기술 지원: Kollus 기술 지원 문의 티켓 접수

이용 시 주의사항​

  • 이용 제한 계정: 아래 계정은 연동 및 로그인은 가능하나, 보안 및 정책상 VOD 및 통계 조회 기능이 제한됩니다. (문서 검색 및 기술 지원 문의는 정상 이용 가능)
  • 연결 유지 기간: 보안을 위해 마지막 사용 후 7일간 활동이 없으면 연결이 자동으로 해제되며, 이후에는 다시 로그인(재인증)해야 합니다.

보안 및 데이터 보호​

  • 로그인 시 입력한 계정 비밀번호는 일회성 인증 검증에만 사용되며, 서버에 별도로 저장되지 않습니다.
  • 인증 완료 후 발급되는 VOD API 접근 권한은 서버에 암호화되어 보관되며, AI 서비스(Claude, ChatGPT)에는 식별 불가능한 난수 토큰만 전달되므로 안전합니다.
  • 로그인 시 선택한 리전(KR/JP/EN)으로 연동이 고정되므로, 다른 리전 데이터를 조회하려면 해당 계정으로 별도 연동해야 합니다.

기술 지원​

이용 중 오류가 발생하거나 문의 사항이 있는 경우 아래 이메일로 연락해 주세요.