MCP 서버

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

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

가장 빠른 설정 (원클릭)

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

클라이언트	버튼	동작
Cursor	Cursor에 추가	Cursor가 열리고 VocalLab 서버가 바로 설치됩니다.
VS Code	VS Code에 추가	VS Code가 열리고 서버가 바로 설치됩니다.
Claude Code	설치 명령 복사	`claude mcp add …` 명령을 복사합니다 — 터미널이나 Claude Code 채팅에 붙여넣으세요.
Claude Desktop	설정 파일 다운로드	바로 사용할 수 있는 `claude_desktop_config.json`을 저장합니다. Claude 설정 폴더에 넣으세요.

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

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

VocalLab Studio 사용하기

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

도구

get_balance — 포인트 잔액
list_voices — 사용할 수 있는 음성
list_models — 음성 모델 (VocalLab Studio / Pro / Lite)
generate_speech — 텍스트 → 음성, 오디오 URL 반환. 선택적 model(v-studio, v-pro, 또는 v-lite)을 허용

연결 후에는 어시스턴트에게 "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을 재시작하세요.

MCP 서버

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

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

가장 빠른 설정 (원클릭)

클라이언트	버튼	동작
Cursor	Cursor에 추가	Cursor가 열리고 VocalLab 서버가 바로 설치됩니다.
VS Code	VS Code에 추가	VS Code가 열리고 서버가 바로 설치됩니다.
Claude Code	설치 명령 복사	`claude mcp add …` 명령을 복사합니다 — 터미널이나 Claude Code 채팅에 붙여넣으세요.
Claude Desktop	설정 파일 다운로드	바로 사용할 수 있는 `claude_desktop_config.json`을 저장합니다. Claude 설정 폴더에 넣으세요.

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

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

도구

get_balance — 포인트 잔액

list_voices — 사용할 수 있는 음성

list_models — 음성 모델 (VocalLab Studio / Pro / Lite)

generate_speech — 텍스트 → 음성, 오디오 URL 반환. 선택적 model(v-studio, v-pro, 또는 v-lite)을 허용

수동 설정 (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을 재시작하세요.