Ssemble MCP 서버

Ssemble AI Clipping을 위한 MCP 서버 — 모든 AI 어시스턴트에서 바이럴 숏폼 비디오를 제작하세요.

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf 및 모든 MCP 호환 클라이언트와 함께 작동합니다.

기능

이 MCP 서버를 사용하면 AI 어시스턴트가 Ssemble의 AI 클리핑 엔진을 사용하여 YouTube 영상에서 숏폼 비디오 클립을 제작할 수 있습니다. AI는 다음을 수행할 수 있습니다:

• 숏폼 제작: YouTube URL 또는 업로드된 파일에서 제작

• 웹훅 콜백: 처리 완료 시 알림 수신 (n8n, Zapier, Make와 호환)

• 에셋 탐색: 자막 템플릿, 배경 음악, 게임 플레이 오버레이, 밈 훅 탐색

• 처리 추적: 진행 상황 확인 및 완료된 클립 검색

• 요청 관리: 기록 나열, 결과 가져오기, 이전 요청 삭제

Related MCP server: clipwise-mcp

사전 요구 사항

• 활성 구독이 있는 Ssemble 계정

• API 키 (Ssemble 대시보드의 설정 → API 키에서 확인)

• Node.js >= 18

빠른 시작

Claude Desktop

설정 파일을 편집하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

저장 후 Claude Desktop을 재시작하세요.

Claude Code

claude mcp add ssemble -- npx @ssemble/mcp-server

그런 다음 환경 변수를 설정하세요:

export SSEMBLE_API_KEY="sk_ssemble_your_key_here"

Cursor / VS Code / Windsurf

MCP 설정에 추가하세요:

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

사용 가능한 도구

처리 방식

비디오 처리는 5-30분 정도 소요됩니다. 두 가지 워크플로우를 사용할 수 있습니다:

옵션 A: 폴링 (수동 확인)

1. create_short — 작업을 제출하고 요청 ID를 즉시 반환받습니다.

2. get_status — 언제든지 진행 상황을 확인합니다 (대기 중 → 처리 중 → 완료).

3. get_shorts — 완료되면 생성된 클립을 검색합니다.

옵션 B: 웹훅 (자동화)

1. webhookUrl과 함께 create_short 사용 — 콜백 URL과 함께 작업을 제출합니다.

2. 처리가 완료되거나 실패하면 API가 결과와 함께 귀하의 URL로 HTTP POST를 보냅니다.

3. 폴링이 필요 없으며 n8n, Zapier, Make 및 사용자 지정 백엔드 통합에 이상적입니다.

웹훅 페이로드 예시:

{
  "event": "shorts.completed",
  "requestId": "507f1f77bcf86cd799439011",
  "status": "completed",
  "timestamp": "2026-03-30T12:00:00.000Z",
  "data": {
    "shorts": [
      {
        "id": "...",
        "title": "AI-Generated Title",
        "video_url": "https://...",
        "duration": 45,
        "viral_score": 8.5
      }
    ]
  }
}

사용 예시

YouTube 영상에서 숏폼 제작:

"https://youtube.com/watch?v=abc123 에서 숏폼을 만들어줘. 처음 10분을 사용하고 잔잔한 배경 음악을 넣어줘."

사용 가능한 에셋 탐색:

"자막 템플릿을 모두 보여줘" / "사용 가능한 배경 음악이 뭐야?"

진행 상황 확인:

"내 비디오 요청 상태가 어때?"

결과 가져오기:

"요청 507f1f77bcf86cd799439011에 대한 클립을 바이럴 점수순으로 보여줘"

환경 변수

개발

git clone https://gitlab.com/vlogr/ssemble-mcp-server.git
cd ssemble-mcp-server
npm install
SSEMBLE_API_KEY=sk_ssemble_your_key npm start

라이선스

MIT