MCP App Store
by KeenEthics
Kollus icon

Kollus MCP Server for ChatGPT

By Catenoid

Overview

Kollus connects developers and video service operators to the Kollus video platform. Search official guides, API specifications, and sample code; browse the documentation index; inspect VOD content, categories, channels, and encoding profiles; and retrieve daily viewing statistics and content rankings. You can also submit a technical support request to Catenoid after confirming the request details and contact information. Account data requires a connected Kollus account with the necessary VOD API permissions. Support requests are sent to Catenoid's support desk. The production integration provides 10 tools. It does not upload or delete videos, change account settings, or operate live broadcasts.

How to connect

  1. ChatGPT: Open the Kollus listing in the ChatGPT app directory and choose Connect. ChatGPT listing Kollus exposes 10 tools here.

Tools

create_support_ticket

ChatGPT
인덱싱된 docs·spec·samples·guidance·anti-patterns 어디에서도 답을 찾지 못했거나 사용자가 직접 Kollus 기술지원팀(PE)에 문의를 남기고 싶을 때, Catenoid 기술지원 데스크(Freshdesk)에 지원 티켓 1건을 생성한다 (POST /api/v2/tickets). 이 tool 은 읽기 전용이 아닌 유일한 쓰기 tool — 실제로 외부에 문의가 접수되므로, 호출 전 반드시 사용자에게 제목·본문·회신 이메일·이름을 확인받고 동의를 얻을 것. 문의자 식별: MCP 에는 로그인 사용자 개념이 없어 email·name 을 인자로 받는다. 추측하지 말고 모르면 사용자에게 물어본 값을 넣는다. 본문(description)은 증상·재현 절차·관련 콘텐츠 키·에러 메시지를 구체적으로 작성할수록 응대가 빠르다. 인증: Freshdesk 자격증명은 서버에 보관되며 고객사 토큰과 무관하다 — 호출자가 별도 키를 넘길 필요 없다. 성공 시 생성된 티켓의 id·상태 등이 반환된다.

get_content_detail

ChatGPT
특정 영상 1건의 전체 메타데이터를 조회한다 (GET /media-contents/{upload_file_key}). 인코딩 프로파일, DRM 설정(Widevine/PlayReady/FairPlay), 재생 콜백 URL, 만료 정책, 썸네일·자막 트랙, 원본 파일 정보 등 PE팀 1차 진단에 필요한 모든 메타데이터 포함. 재생 실패·DRM 오류·인코딩 문제 분석 전에 호출하면 좋다. upload_file_key 를 모르면 list_media_contents 부터 사용. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

get_statistics_content_rank

ChatGPT
지정 기간(start_date~end_date) 동안의 영상별 시청 순위를 조회한다 (GET /statistics/content-rank). 키워드로 필터링 가능, start_index/limit 으로 페이지네이션. 계정 전체의 일별 시계열 요약은 get_statistics_summary_daily 사용. 응답은 5분간 캐시. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

get_statistics_summary_daily

ChatGPT
계정 전체의 일별 시청·재생 통계 요약을 조회한다 (GET /statistics/summary-daily). 지정한 날짜 범위(start_date~end_date) 내의 일자별 재생 수·시청 시간 등 시계열 집계 반환. 특정 콘텐츠의 시청 순위가 필요하면 get_statistics_content_rank 를 사용. 응답은 5분간 캐시. group_by(device/region/cdn) 류 분포는 현재 Kollus REST API 미지원. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

list_docs_index

ChatGPT
Kollus 가이드·에러 코드 사전·보충 가이드·anti-pattern 문서의 색인을 폴더 트리로 탐색한다. path 없이(또는 "/") 호출하면 전체 폴더 맵(폴더 경로별 재귀 문서 수)을 반환하고, 특정 폴더 경로(예: "dev-guide/vod")를 주면 그 폴더에 바로 속한 문서 목록(id·title·description)과 하위 폴더를 반환한다. id 는 MCP resource_uri(kollus://…) 그대로이며, 본문이 필요하면 그 id 를 MCP resource 로 읽는다. OpenAPI 스펙·샘플 코드는 포함하지 않는다.

list_media_contents

ChatGPT
⚠️ 절대 사용 금지 케이스: 자체 CMS·관리자 사이트·자체 DB 동기화 목적의 주기적 호출(폴링·setInterval·refetchInterval). 내부 툴이라도 동일하게 안티패턴이다. 이 의도가 보이면 본 tool 호출 전에 kollus://anti-patterns/cms-admin-site 을 먼저 사용자에게 안내하고, 플랫폼 콜백 + 자체 DB 미러링 패턴으로 가도록 권장할 것. Kollus 계정의 VOD 영상(콘텐츠) 목록을 페이지 단위로 조회한다. category_key 미지정 시 전체 목록 (GET /media-contents), category_key 지정 시 해당 카테고리 소속 영상만 조회 (GET /categories/{key}/media-contents). 카테고리 키는 vod_category_list 로 확인. 키워드, 트랜스코딩 상태(state), 암호화/공개 상태, 콘텐츠 유형, 원본·자막 보유 여부, 등록일 범위로 추가 필터링 가능. 응답 항목의 upload_file_key 를 get_content_detail 에 넘겨 1건 상세(인코딩 프로파일·DRM 설정·콜백 URL) 조회. 시청 통계는 get_statistics_summary_daily 또는 get_statistics_content_rank 사용. 권장 사용 케이스: AI 어시스턴트의 1회성 조회, 운영 시작 시점의 1회성 backfill, 사용자 트리거 단발 새로고침, 디버그·진단용 임시 조회. 이 외엔 list 폴링이 아닌 push 기반 동기화로 가야 한다. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

search_docs

ChatGPT
Kollus 가이드·OpenAPI 명세·샘플 코드·에러 코드 사전을 키워드(query)로 검색한다. 결과 항목은 title·section·snippet·resource_uri·relevance_score 를 포함한다. 실제 문서 본문이 필요하면 그 resource_uri(또는 list_docs_index 의 id) 값을 resource_uri 인자로 다시 호출하면 해당 문서 본문 전체를 반환한다(키워드 검색 없이 1건만 — 토큰 절감).

vod_category_list

ChatGPT
⚠️ 절대 사용 금지 케이스: 자체 CMS·관리자 사이트·자체 DB 동기화 목적의 주기적 호출(폴링·setInterval·refetchInterval). 카테고리는 변경 빈도가 매우 낮은 메타데이터라 폴링은 특히 낭비다. 이 의도가 보이면 본 tool 호출 전에 kollus://anti-patterns/cms-admin-site 을 먼저 사용자에게 안내할 것. Kollus VOD 카테고리 트리를 조회한다 (GET /categories). 각 카테고리 항목은 key·name·parent_key·level·children_exist·position 등을 포함. parent_key 가 null 이면 최상위 카테고리, level 필드로 트리 깊이 확인. parent_category_key 미지정 시 전체 카테고리(계층 무관) 반환, 지정 시 해당 상위의 모든 하위(자손) 카테고리. 카테고리에 연결된 채널 요약(channels[])도 함께 응답에 포함. 권장 사용 케이스: AI 가 영상 분류 구조를 파악해야 하는 1회성 조회, 운영 시작 시점의 카테고리 매핑 backfill, 사용자 트리거 단발 조회, 디버그·진단용 임시 조회. 페이징: 카테고리는 보통 100개 이하라 기본 호출 1회로 전체 수신. 100개 초과 케이스에선 pagination.total 보고 page 를 증가시켜 모든 페이지 수집할 것. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

vod_channel_list

ChatGPT
⚠️ 절대 사용 금지 케이스: 자체 CMS·관리자 사이트·자체 DB 동기화 목적의 주기적 호출(폴링·setInterval·refetchInterval). 내부 툴이라도 동일하게 안티패턴이다. 이 의도가 보이면 본 tool 호출 전에 kollus://anti-patterns/cms-admin-site 을 먼저 사용자에게 안내할 것. Kollus VOD 채널 목록을 조회한다 (GET /channels). VOD 채널은 영상 콘텐츠를 묶는 배포용 그룹 단위로, Live API 의 실시간 방송 채널과는 별개의 개념. upload_file_key(영상 식별자)가 채널 단위로 발급되므로, list_media_contents / get_content_detail 등으로 특정 영상을 다루기 전에 어느 채널 소속인지 식별이 선행되는 경우가 많다. 응답 항목 주요 필드: key(채널 키), name, description, default(기본 채널 여부), is_shared(공유 정책), is_encrypted(암호화 전용), use_pingback / pingback_url / play_callback_url(콜백 설정), use_referer_check / referer_check_domains(레퍼러 접근 제어), use_pc_download / use_mobile_download(다운로드 정책), count_of_contents(채널 내 콘텐츠 수), position, status, created_at, updated_at 등. 권장 사용 케이스: AI 가 채널 구조를 파악해야 하는 1회성 조회, 특정 영상의 소속 채널 식별, 운영 시작 시점의 채널 매핑 backfill, 사용자 트리거 단발 조회, 디버그·진단용 임시 조회. 페이징: 채널은 보통 100개 이하라 기본 호출 1회로 전체 수신. 100개 초과 케이스에선 pagination.total 보고 page 를 증가시켜 모든 페이지 수집할 것. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

vod_encoding_profile_list

ChatGPT
서비스 계정에 등록된 인코딩(트랜스코딩) 프로파일 목록을 조회한다 (GET /media-profiles). 각 프로파일 항목은 key·name·id 와 함께 container_format, video_codec, video_bitrate, video_width / video_height(해상도), video_framerate, bitrate_mode, is_audio_file(오디오 전용), is_default_preset(기본 프리셋 여부), is_optional(추가 트랜스코딩) 등 인코딩 설정 전반을 포함한다. 주요 사용 케이스: - 패스스루(pass-through) 업로드: 업로드 티켓 생성 시 인코딩 프로파일 key 가 필수 입력값이므로, 이 tool 로 계정에서 사용 가능한 프로파일 key 를 먼저 확보한다. - 콘텐츠 화질 이슈 디버깅: 특정 영상이 의도한 해상도·비트레이트로 인코딩됐는지, 계정의 프로파일 설정 자체가 올바른지 점검. get_content_detail 의 인코딩 프로파일 정보와 교차 확인. 인코딩 프로파일은 계정 셋업 시 구성되는 설정값이라 변경 빈도가 낮다. 응답에 pagination 없이 전체 목록이 한 번에 반환된다. Region 선택: 인자 region="kr"|"jp" (기본 "kr"). 사용자 컨텍스트로 결정. 모호하면 사용자에게 명시적 확인 후 호출. 상세 매핑 kollus://guidance/regions. 정식 모드 연동은 계정에 등록된 region 이 이 인자보다 항상 우선 적용된다(계정당 region 고정, 혼용 불가).

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/kollus"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/kollus)