Kollus MCP 서버 베타 오픈 및 기능 안내
✨ Kollus MCP 서버란 무엇인가요?
Kollus MCP 서버는 Claude Code, Codex 등 AI 코딩 에이전트가 Kollus VOD/Live API, 공식 가이드, 샘플 코드를 자연어로 활용할 수 있도록 지원하는 원격 MCP 서버입니다. 개발자가 개발 환경 내에서 자연어로 질문하면, AI 에이전트가 정보를 검색하고 답변합니다.
🛠️ 도입 배경 및 필요성
기존에 고객사 개발자가 Kollus 서비스를 연동할 때는 공식 가이드, API 명세서, 샘플 코드 등이 각각 분산되어 있어 정보 탐색에 많은 시간이 소요되었습니다. 예를 들어 'DRM 콜백 검증 방법', '플레이어 JWT 유효성 확인', '-2106 에러 코드 의미' 등을 확인할 때마다 매번 문서를 개별 검색하거나 기술 지원 답변을 기다려야 했습니다.
이제는 AI 코딩 에이전트에 Kollus MCP 서버를 연결하면, 개발자가 자연어로 질문하는 즉시 에이전트가 Kollus 문서를 검색하고 API를 호출하여 맥락에 맞는 해답을 실시간으로 제공합니다.
주요 도입 효과 (고객사 개발팀 관점)
- 연동 생산성 향상 및 대기 시간 절감: 공식 가이드, API 명세서, 샘플 코드, 안티 패턴 등을 AI 에이전트가 즉각 탐색하므로 시행착오가 줄어듭니다.
- 맥락 전환 최소화: API 응답 결과 및 JWT 검증 결과를 개발 도구 내부에서 바로 확인할 수 있어, 웹 콘솔과 코드 에디터를 오가는 번거로움이 사라집니다.
- 기술 지원 효율화: 자주 발생하는 연동 관련 질의를 AI 에이전트가 1차적으로 해결하여, 기술 지원팀 문의 대기 시간이 단축됩니다.
활용 예시 (개발자 관점)
MCP 서버 연결 후, AI 에이전트의 채팅 창에 자연어로 질문하여 아래와 같은 작업을 수행할 수 있습니다.
질문 예시 1: "DRM 다운로드 콜백 kind1 응답 필드 알려줘."
AI 동작: Kollus 공식 가이드를 검색하여 해당 필드 명세 답변
질문 예시 2: "
upload_file_key=xxx영상의 인코딩 진행률 알려줘."
AI 동작: Kollus VOD API를 통해 영상 상세 메타데이터를 조회하여 결과 반 환
질문 예시 3: "이 JWT가 유효한가?
eyJhbGciOiJIUzI1NiI..."
AI 동작: 서명, 만료 시간, DRM 종류를 로컬에서 검증하여 리포트 제공
질문 예시 4: "이번 달 일별 시청 통계 보여줘."
AI 동작: Kollus 통계 API를 호출하여 일별 시청 데이터 요약
📋 제공 기능 명세
Kollus MCP 서버가 제공하는 주요 기능 영역입니다. 보안을 위해 모든 도구는 읽기 전용(Read-Only)을 기본으로 하며, 쓰기 권한이 필요한 도구는 엄격한 보안 검토 후 제한적으로 제공됩니다.
| 기능 영역 | 설명 및 가능 작업 |
|---|---|
| 문서 검색 | 공식 가이드, API 명세서, 샘플 코드, 에러 코드 및 안티패턴 문서의 키워드 검색을 지원합니다. |
| VOD 조회 | 영상 목록, 상세 메타데이터, 카테고리, 채널, 인코딩 프로파일, 시청 통계 및 순위를 Kollus VOD API 호출을 통해 실시간으로 조회합니다. |
| Live 조회 | 라이브 채널 정보, 방송 상태, 실시간 시청자 수 통계, 녹화 파일 목록 조회를 지원하며, Kollus Live API 호출을 통해 다운로드 URL을 발급합니다. |
| JWT 검증 | VOD 플레이어 및 라이브 방송용 JWT의 서명, 만료일, DRM 종류를 검증 합니다. 외부 네트워크 호출 없이 로컬 가상 환경에서 안전하게 검증이 수행됩니다. |
| 기술 지원 | Kollus 기술 지원팀에 문의 티켓을 직접 접수합니다. |
🔐 보안 설계
Kollus MCP 서버는 고객사의 자격 증명(Credentials) 정보를 서버에 저장하지 않습니다.
- Access Token, 보안 키 등 모든 비밀 키는 클라이언트 측 토큰(Blob) 형태로 암호화되어 매 요청마다 전달됩니다.
- MCP 서버의 디스크 및 데이터베이스(DB)에는 어떠한 인증 정보도 보관되지 않습니다.
🌏 멀티 리전(Multi-region) 지원
Kollus는 KR(Global) 및 JP 두 개의 리전을 운영하고 있습니다.
- API 호출형 도구는 리전 정보를 인자로 받으며, 기본값은 KR입니다.
- AI 에이전트가 사용자의 컨텍스트를 분석하여 알맞은 리전의 API를 자동으로 호출합니다.
💡 시작하기
Kollus MCP 서버 베타 버전은 2026년 6월 22일부터 이용 가능합니다.
1. 사전 준비 (인증 키 확인)
사용하고자 하는 기능에 따라 Kollus 콘솔에서 아래 인증 키를 미리 확보하세요.
| 인증 키 명칭 | 확인 경로 | 필수 여부 |
|---|---|---|
| VOD Access Token | Kollus VOD 콘솔 > [서비스 계정] > [API] | 필수 |
| 보안 키 (Security Key) | Kollus VOD 콘솔 > [서비스 계정] > [사용자 키] > [보안 키] | JWT 검증 기능 사용 시 필수 |
| Live Personal Access Token | Kollus Live 콘솔 > [설정] > [기본 정보] > [서비스 계정] 탭 하단 [Personal Access Tokens] | Live 기능 사용 시 필수 |
| 서비스 계정 키 | Kollus VOD 콘솔 > [서비스 계정] > [기본 정보] > [서비스 계정] 탭 > [서비스 계정 키] | Live 기능 사용 시 필수 |
2. AI 에이전트별 등록 방법
- Claude Code 등록
claude mcp add --transport http kollus https://mcp.kollus.com/mcp-beta
- Codex 등록
codex mcp add kollus --url https://mcp.kollus.com/mcp-beta
등록 후 처음 연결할 때 브라우저를 통해 OAuth 2.1 인증 페이지가 열립니다. OAuth 2.1 표준을 지원하는 다른 AI 코딩 에이전트도 위 URL을 통해 연동 가능합니다.
3. Kollus MCP 인증
입력한 값은 클라이언트 측 토큰에만 담기며 서버에는 저장되지 않습니다.
💬 문의 사항
Kollus MCP 서버 이용과 관련된 문의 사항은 아래 기술 지원 채널로 연락해 주세요.
- 기술 지원: tech_support@catenoid.net