MCP 서버

VocalLab MCP 서버를 사용하면 Claude Desktop, Claude Code, Cursor, VS Code 등의 AI 도구가 Model Context Protocol을 통해 내 계정으로 음성을 생성할 수 있습니다.

전체 과정 영상으로 보기 · 영어

Pro 이상 플랜이 필요합니다. API 키를 미리 준비할 필요는 없습니다 — 설정 과정에서 자동으로 만들어줍니다.

가장 빠른 설정 (원클릭)

개발자 페이지에서 **AI 도구에서 사용 (MCP)**을 여세요. 클라이언트를 선택하고 버튼 하나만 누르면 — API 키가 자동으로 생성되고 한 번에 연결됩니다. 복사·붙여넣기가 필요 없습니다.

새 키는 섹션 상단 배너에 한 번만 표시됩니다. 페이지를 떠나기 전에 안전한 곳에 복사하세요 — 보안상 다시 표시할 수 없습니다.

직접 설정하고 싶으신가요? 모든 클라이언트에는 설정 미리보기에 복사와 다운로드 버튼도 있어서 원하는 곳에 붙여넣을 수 있습니다.

VocalLab Studio 사용하기

VocalLab Studio에서 사이드바의 API 및 MCP를 열고 MCP 탭으로 전환하세요 — 방식은 동일합니다: 키 생성, 클라이언트 선택, 연결. Windsurf와 그 밖의 모든 MCP 호환 클라이언트도 범용 설정으로 지원합니다.

도구

• get_balance — 포인트 잔액
• list_voices — 사용할 수 있는 음성
• list_models — 음성 모델 (VocalLab Studio / Studio Flash / Pro / Lite)
• generate_speech — 텍스트 → 음성, 오디오 URL 반환. 선택적 model(v-studio, v-flash, v-pro, 또는 v-lite)을 허용
• get_speech — id로 생성 조회: 상태 + 다운로드/스트림 링크
• get_captions — 생성의 SRT 자막(phrase 줄 단위 또는 word 단어 단위)
• delete_speech — 본인이 소유한 생성을 영구적으로 삭제
• design_voice — 목소리를 말로 설명하고 들어볼 수 있는 후보 미리듣기를 최대 3개 받기
• save_designed_voice — 미리듣기를 생성에 쓸 수 있는 영구 보이스로 저장
• clone_voice — 짧은 녹음(base64)으로 보이스 복제
• list_voice_languages — 복제·디자인 지원 언어와 녹음 제한
• delete_voice — 복제하거나 디자인한 보이스를 영구 삭제

연결 후에는 어시스턴트에게 "VocalLab 음성 목록을 보여줘", "VocalLab으로 음성을 생성해줘" 또는 "VocalLab Studio 모델로 생성해줘"라고 요청하세요. 각 모델의 기능은 음성 모델을 참조하세요.

호스팅 서버

모든 원클릭 옵션은 호스팅 서버를 가리킵니다 — 설치하거나 실행할 것이 없습니다:

• URL: https://mcp.vocallab.ai/mcp
• 헤더: Authorization: Bearer vl_live_...

수동 설정 (Claude Desktop 등)

설정 파일 다운로드 버튼이 만들어주는 것과 정확히 같습니다. 클라이언트의 MCP 설정에 추가하세요:

{
  "mcpServers": {
    "vocallab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vocallab.ai/mcp", "--header", "Authorization: Bearer vl_live_..."]
    }
  }
}

Claude Desktop의 설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

파일이 이미 있다면 교체하지 말고 mcpServers 아래에 vocallab 항목을 병합한 뒤 Claude Desktop을 재시작하세요.