REST API + MCP Server

비디오 인텔리전스로 개발

두 가지 통합 방법: 맞춤 애플리케이션을 위한 완전한 REST API와 AI 어시스턴트가 비디오를 네이티브로 사용할 수 있는 MCP 서버.

REST API

완전한 프로그래밍 제어

업로드 및 인코딩부터 AI 분석, 전사, 검색, 팀 관리까지 전체 비디오 라이프사이클을 다루는 포괄적인 RESTful API.

업로드 및 가져오기

YouTube에서 비디오를 가져오거나 사전 서명된 S3 URL로 직접 업로드. 인코딩은 백그라운드에서 자동으로 진행됩니다.

AI 분석

AI 기반 분석을 위해 비디오를 제출 — 챕터 생성, 장면 감지, 엔티티 추출, 상세 요약 생성.

전사

Whisper로 오디오를 전사하고 100개 이상의 언어로 번역. 즉시 사용 가능한 다국어 자막 지원.

검색 및 채팅

라이브러리 전체에서 하이브리드 시맨틱 + 키워드 검색. 개별 비디오 또는 전체 컬렉션에 RAG 기반 AI 채팅 활성화.

임베딩

분석 및 전사 데이터에서 벡터 임베딩을 생성하여 시맨틱 검색과 RAG 기반 AI 채팅을 지원.

조직

역할 기반 접근 제어, 그룹 간 데이터 격리, 초대 워크플로로 팀을 관리 — 모두 API를 통해.

bash
curl -X POST "https://www.coniviso.com/api/v1/videos/{id}/analyze" \
  -H "Authorization: Bearer vi_live_..." \
  -H "Content-Type: application/json" \
  -d '{"analysisType": "comprehensive"}'
MCP 서버

모든 AI 어시스턴트에서 비디오를

Coniviso는 Model Context Protocol (MCP) 서버를 제공하여 Claude, Cursor 등의 AI 어시스턴트와 커스텀 에이전트가 비디오 라이브러리에 접근하고, 콘텐츠를 검색하고, 전사를 읽고, 분석을 트리거할 수 있습니다 — 모두 표준 MCP 인터페이스를 통해.

MCP란?

Model Context Protocol은 AI 모델이 외부 도구 및 데이터 소스와 안전하게 상호 작용할 수 있는 개방형 표준입니다. 맞춤 통합을 작성하는 대신, MCP 호환 AI 클라이언트가 Coniviso에 연결하여 즉시 비디오를 컨텍스트로 사용할 수 있습니다.

21개 도구

모든 도구는 API 키 권한으로 제한됩니다. AI 어시스턴트는 비디오 목록 조회, 검색, 업데이트 및 삭제, 조직, 그룹, 권한 및 공개 설정 관리, 분석 및 전사 조회, 개별 비디오 또는 전체 라이브러리와 채팅, 임베딩 생성, 새 분석 작업 제출이 가능합니다 — 모두 대화에서 벗어나지 않고 수행됩니다.

  • list_videos페이지네이션 및 상태 필터로 비디오 라이브러리 탐색
  • get_video비디오의 전체 메타데이터, 처리 상태, 구성 가져오기
  • search_videos접근 가능한 모든 비디오에서 하이브리드 시맨틱 + 키워드 검색
  • chat_with_libraryRAG를 사용하여 전체 비디오 컬렉션에 질문
  • chat_with_video멀티턴 대화 지원으로 특정 비디오에 대한 Q&A
  • get_analysisAI 분석 결과 검색: 요약, 챕터, 장면, 엔티티
  • get_transcription언어별 필터링 가능한 전사 데이터 가져오기
  • analyze_videoAI 분석을 위해 비디오 제출 (포괄적, 장면, 객체 또는 텍스트)
  • generate_embeddings시맨틱 검색을 위한 분석 및 전사 데이터에서 벡터 임베딩 생성
  • update_video비디오의 제목, 설명, 공개 설정 또는 조직 업데이트
  • delete_video비디오와 모든 관련 데이터를 영구 삭제
  • get_permissions비디오에 부여된 모든 접근 권한 목록 조회
  • grant_permission사용자, 그룹 또는 조직에 비디오 접근 권한 부여
  • revoke_permission이전에 부여된 비디오 접근 권한 취소
  • list_organizations속한 조직 목록 반환
  • get_organization특정 조직의 세부 정보 반환
  • list_org_members조직의 모든 멤버 반환
  • invite_org_member조직에 멤버 초대
  • remove_org_member조직에서 멤버 제거
  • list_org_groups조직 내 모든 그룹 나열
  • list_group_members조직 내 특정 그룹의 모든 멤버 나열

8개 리소스

MCP 리소스는 AI 어시스턴트에게 구조화된 컨텍스트로 비디오 데이터에 직접 접근을 제공합니다:

  • coniviso://videos메타데이터가 포함된 접근 가능한 모든 비디오의 전체 목록
  • coniviso://video/:id분석 및 전사를 포함한 전체 비디오 세부 정보
  • coniviso://video/:id/transcription특정 비디오의 전체 전사 데이터
  • coniviso://video/:id/analysisAI 분석 결과: 요약, 챕터, 장면, 엔티티
  • coniviso://video/:id/permissions부여된 권한을 보여주는 접근 제어 목록
  • coniviso://organizations속한 모든 조직의 목록
  • coniviso://organization/:id조직 세부 정보 및 소속 멤버 목록
  • coniviso://organization/:id/groups조직 내 모든 그룹의 목록

30초 만에 연결

단일 구성 블록으로 모든 MCP 클라이언트에 Coniviso를 추가하세요. 인증에는 기존 API 키를 사용합니다.

엔드포인트https://www.coniviso.com/mcp
인증Bearer vi_live_...
전송Streamable HTTP (HTTP 기반 JSON-RPC)

각 세션은 자체 격리된 서버 인스턴스를 받습니다. 세션은 mcp-session-id 헤더로 식별됩니다.

mcp config
{
  "mcpServers": {
    "coniviso": {
      "url": "https://www.coniviso.com/mcp",
      "headers": {
        "Authorization": "Bearer vi_live_..."
      }
    }
  }
}
시작하기

몇 분 만에 시작

1. API 키 생성

Coniviso 대시보드의 설정 → API 키로 이동하세요. API 키는 vi_live_* 형식을 따르며 세분화된 권한을 설정할 수 있습니다.

2. 요청 인증

Authorization 헤더에 API 키를 Bearer 토큰으로 포함하세요. REST API 호출과 MCP 연결 모두에서 작동합니다.

3. 개발 시작

모든 언어에서 REST API를 사용하거나 MCP 서버를 AI 어시스턴트에 연결하세요. 둘 다 같은 API 키와 권한을 공유합니다.

사용 가능한 권한

  • videos:read비디오 메타데이터 조회 및 읽기
  • videos:write비디오 업로드, 업데이트, 삭제
  • analysisAI 분석 결과 제출 및 읽기
  • search비디오 콘텐츠 검색
  • chatAI 채팅 기능 사용 (비디오별 및 라이브러리 전체)
  • embeddings벡터 임베딩 생성 및 관리

통합할 준비가 되셨나요?

Coniviso API와 MCP 서버로 개발을 시작하세요. 무료 플랜에는 60분의 AI 처리가 포함됩니다.