오디오 MCP 서버 문서

개요

서버는 스트림 가능한 HTTP를 통해 모델 컨텍스트 프로토콜(MCP)을 전송합니다. MCP 클라이언트를 아래 엔드포인트로 연결하고 VocalRemover API 토큰으로 인증하십시오. 파일은 공개 HTTP(S) URL(최대 100MB)로 전달되며, 결과는 다운로드 가능한 URL로 반환됩니다.

Endpoint:  https://vocalremover.com/mcp/audio
Transport: Streamable HTTP (POST)
Auth:      Authorization: Bearer YOUR_API_TOKEN

빠른 시작

1. 에서 무료 API 토큰을 발급받으세요. API 페이지.
2. 아래 스니펫을 사용하여 클라이언트에 서버를 추가하세요.
3. "<파일 URL>에서 보컬을 제거해 주세요."라고 요청하세요.

인증

1. 무료 계정을 생성하고 다음을 열어주세요. API 페이지.
2. API 토큰을 생성합니다.
3. MCP 클라이언트 구성에 이를 Bearer 토큰으로 추가하십시오(아래 참조).

무료 오디오 도구와 유료 AI 도구 모두 이 토큰을 사용하며, 유일한 차이점은 변환 분당 크레딧이 차감되는지 여부뿐입니다.

클라이언트 설정

AI 클라이언트에 서버를 추가하세요. Claude Desktop은 mcp-remote 브리지를 사용하며, Cursor, Windsurf, Cline, Zed 및 Claude Code는 Bearer 토큰을 통해 원격 MCP를 기본적으로 지원합니다. ChatGPT와 Claude.ai 웹 앱은 이를 사용자 지정 커넥터로 추가하고 OAuth를 통해 로그인합니다(아래 참조).

{
  "mcpServers": {
    "vocalremover": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vocalremover.com/mcp/audio",
        "--header", "Authorization:${AUTH}"
      ],
      "env": { "AUTH": "Bearer YOUR_API_TOKEN" }
    }
  }
}

{
  "mcpServers": {
    "vocalremover": {
      "url": "https://vocalremover.com/mcp/audio",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

claude mcp add --transport http \
  vocalremover https://vocalremover.com/mcp/audio \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Anthropic 메시지 API (나만의 에이전트 구축하기)

MCP 커넥터 베타 헤더를 사용하여 서버를 Claude API 호출에 연결합니다:

client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Remove vocals from https://example.com/song.mp3"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://vocalremover.com/mcp/audio",
        "name": "vocalremover",
        "authorization_token": "YOUR_API_TOKEN",
    }],
    betas=["mcp-client-2025-11-20"],
)

ChatGPT (사용자 정의 커넥터)

ChatGPT 설정에서 개발자 모드를 활성화하고, '앱 및 커넥터' → '만들기'를 열어 아래 서버 URL을 지정하는 사용자 지정 커넥터를 추가하세요. ChatGPT가 OAuth 절차를 진행합니다. VocalRemover에 로그인하여 액세스를 승인하면 되며, 토큰을 붙여넣을 필요는 없습니다. (사용자 지정 커넥터가 포함된 요금제, 예: Plus/Pro/Business/Enterprise가 필요합니다.)

https://vocalremover.com/mcp/audio

현재 요금제에서 커스텀 커넥터에 액세스할 수 없나요? 대신 커스텀 GPT를 생성하고, API 키(Bearer) 인증을 통해 당사의 OpenAPI 스키마를 가져오는 액션을 추가하세요.

Claude (웹 앱, Cowork 및 Claude Code)

서버를 사용자 지정 커넥터로 한 번 추가한 다음, Claude가 오디오를 업로드하고 가져올 수 있도록 네트워크 액세스를 허용하세요.

1. '사용자 지정' → '커넥터'를 엽니다.
2. '커넥터 추가'(+ 버튼)를 클릭한 다음, '사용자 지정 커넥터 추가'를 선택합니다.
3. 이름을 "VocalRemover"로 설정하고, 아래에 MCP 서버 URL을 붙여넣은 다음, 추가를 클릭합니다.
4. VocalRemover에 로그인하고, 메시지가 표시되면 액세스 권한을 승인하세요. 토큰을 붙여넣을 필요는 없습니다.

https://vocalremover.com/mcp/audio

1. 설정 → 기능으로 이동합니다.
2. '네트워크 출력 허용'을 켭니다.
3. 다음 두 도메인을 추가하십시오: vocalremover.com 그리고 s3.vocalremover.com

이게 전부입니다. 새로운 채팅, Cowork 또는 Claude Code 세션을 시작하고, 오디오 파일을 첨부한 뒤 "보컬 제거해 줘"라고 말하세요. 그러면 Claude가 파일을 업로드한 후 결과를 돌려줍니다.

Claude Pro, Max, Team 및 Enterprise 에디션에서 사용자 정의 커넥터를 사용할 수 있습니다.

도구

로컬 파일 업로드

도구는 공개 URL을 입력으로 받습니다. 파일이 사용자 컴퓨터에 있는 경우, 무료 create_upload 도구를 호출하여 일회용 업로드 URL을 얻은 다음, 해당 URL로 파일을 POST로 전송하고(토큰 불필요), 반환된 file_url을 오디오 도구 중 하나에 전달하십시오. 업로드 링크와 파일은 1시간 후에 만료됩니다. 실제 오디오 파일을 절대로 base64로 인코딩하지 마십시오. 파일 크기가 너무 커서 도구 인수로 전달할 수 없습니다.

Assistant calls:  create_upload { "filename": "song.mp3" }
            ->  { "upload_url": "https://vocalremover.com/api/uploads/01h...",
                  "file_url":   "https://vocalremover.com/storage/mcp-uploads/01h....mp3",
                  "upload_page":"https://vocalremover.com/upload/01h..." }

# Upload the bytes (model's sandbox, a terminal, or the user's browser):
curl -F "file=@song.mp3" "https://vocalremover.com/api/uploads/01h..."
            ->  { "file_url": "https://vocalremover.com/storage/mcp-uploads/01h....mp3" }

Assistant calls:  separate_audio { "url": "", "task": "vocals" }

웹 요청을 수행할 방법이 없는 경우(예: 샌드박스화된 어시스턴트)? 사용자에게 upload_page 링크를 보내 브라우저에 파일을 드래그 앤 드롭하게 한 다음, file_url을 사용하여 진행하십시오.

Claude에서 파일을 업로드하려면 vocalremover.com 및 s3.vocalremover.com으로의 네트워크 송출이 필요합니다. 설정 → 기능에서 이 기능을 활성화하세요(위의 Claude 설정 참조).

예시: 보컬 제거

보조자에게 평이한 언어로 요청하기만 하면 됩니다:

You: Remove the vocals from https://example.com/song.mp3

Assistant calls:  separate_audio { "url": "...", "task": "vocals" }
            ->  { "job_id": "01H...", "status": "in_process_queue" }

Assistant calls:  check_audio_job { "job_id": "01H..." }
            ->  { "done": true, "outputs": [
                    { "track": "vocals",        "download_url": "https://..." },
                    { "track": "instrumentals", "download_url": "https://..." }
                ] }

무료 도구도 동일한 방식으로 작동합니다. 예를 들어, "이 파일을 wav로 변환"을 호출하면 convert_audio가 실행되어 크레딧을 소모하지 않고 즉시 다운로드 URL을 반환합니다.

시도해 볼 만한 사항

• ›https://example.com/song.mp3에서 보컬을 제거하고, 가라오케 트랙을 제공해 주세요.
• ›이 트랙을 보컬, 드럼, 베이스, 기타, 피아노 등 개별 트랙으로 분리하세요.
• ›https://example.com/interview.m4a 파일을 128 kbps의 MP3 파일로 변환하십시오.
• ›이 동영상에서 오디오만 추출하세요: https://example.com/clip.mp4
• ›이 팟캐스트의 잡음을 제거하고 실내 에코를 제거해 주세요: https://example.com/episode.wav
• ›이 트랙에 있는 가수의 목소리를 음역 ID "tenor-male"로 변환하고, 음높이를 +2 반음 올리십시오: https://example.com/song.mp3
• ›8D 버전을 제작하고 길이를 30초로 편집하십시오.
• ›https://example.com/track.flac의 재생 시간과 비트레이트는 얼마입니까?
• ›내 크레딧 잔액을 확인해 주세요.

제한 사항 및 참고 사항

• 입력 파일은 공개된 http(s) URL이어야 하며, 각 파일의 크기는 최대 100 MB입니다.
• AI 분리 작업은 비동기적으로 실행되므로, 결과를 확인하려면 항상 check_audio_job을 폴링해야 합니다.
• 크레딧은 오디오 1분당 청구되며, AI 분리 작업에만 적용됩니다.
• 무료 오디오 도구는 크레딧을 절대 사용하지 않습니다.

개인정보 보호 및 보안

• 사용자가 지정한 URL에서 오디오를 가져와 처리한 후 삭제하며, 당사는 파일을 저장하지 않습니다.
• API 토큰은 귀하의 계정에 한정되어 있으며, API 페이지에서 언제든지 권한을 취소할 수 있습니다.
• 엔드포인트는 HTTPS 전용이며, 사내/내부 주소로 연결되는 URL은 차단합니다.

문제 해결

MCP 서버 개요로 돌아가기