Dokumentasi Server Audio MCP

Hubungkan kotak alat audio VocalRemover ke asisten AI Anda dan mulailah mengedit audio menggunakan bahasa alami.

Gambaran Umum

Server ini menggunakan Model Context Protocol (MCP) melalui Streamable HTTP. Arahkan klien MCP mana pun ke titik akhir di bawah ini dan lakukan otentikasi menggunakan token API VocalRemover. File dikirimkan sebagai URL HTTP(S) publik (maksimal 100 MB) dan hasilnya dikembalikan sebagai URL yang dapat diunduh.

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

Panduan Cepat

  1. Dapatkan token API gratis di Halaman API.
  2. Tambahkan server ke klien Anda menggunakan potongan kode di bawah ini.
  3. Tanyakan: "Hapus vokal dari ."

Otentikasi

  1. Buat akun gratis dan buka Halaman API.
  2. Buat token API.
  3. Tambahkan sebagai token Bearer dalam konfigurasi klien MCP Anda (lihat di bawah).

Baik alat audio gratis maupun alat AI berbayar sama-sama menggunakan token ini; perbedaannya hanya terletak pada apakah kredit menit konversi dikenakan biaya atau tidak.

Pengaturan klien

Tambahkan server ke klien AI Anda. Claude Desktop menggunakan jembatan mcp-remote; Cursor, Windsurf, Cline, Zed, dan Claude Code mendukung MCP jarak jauh secara native dengan token Bearer; ChatGPT dan aplikasi web Claude.ai menambahkannya sebagai konektor khusus dan masuk melalui OAuth (lihat di bawah).

Claude Desktop

Tambahkan ke claude_desktop_config.json, lalu mulai ulang Claude.

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

Cursor · Windsurf · Cline · Zed

MCP jarak jauh bawaan — tambahkan ke berkas mcp.json klien.

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

Kode Claude (CLI)

Satu perintah — MCP jarak jauh asli, tanpa jembatan.

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

API Pesan Anthropic (bangun agen Anda sendiri)

Hubungkan server ke panggilan API Claude dengan header konektor MCP beta:

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 (konektor khusus)

Di pengaturan ChatGPT, aktifkan Mode Pengembang, buka Aplikasi & Konektor → Buat, lalu tambahkan konektor khusus yang mengarah ke URL server di bawah ini. ChatGPT akan menjalankan alur OAuth — Anda masuk ke VocalRemover dan menyetujui akses; tidak perlu menempelkan token. (Membutuhkan paket berlangganan yang mendukung konektor kustom, misalnya Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Tidak ada akses ke konektor khusus di paket Anda? Buatlah Custom GPT sebagai gantinya dan tambahkan Action yang mengimpor skema OpenAPI kami dengan otentikasi API-key (Bearer).

Claude (aplikasi web, Cowork & Claude Code)

Tambahkan server tersebut sekali sebagai konektor khusus, lalu izinkan akses jaringan agar Claude dapat mengunggah dan mengambil file audio Anda.

1. Tambahkan konektor
  1. Buka Sesuaikan → Konektor.
  2. Klik "Tambahkan konektor" (tombol +), lalu pilih "Tambahkan konektor khusus".
  3. Atur Nama menjadi "VocalRemover", tempelkan URL server MCP di bawah ini, lalu klik Tambah.
  4. Masuk ke VocalRemover dan setujui akses saat diminta — tidak perlu menempelkan token.
https://vocalremover.com/mcp/audio
2. Izinkan akses jaringan (agar dapat mengunggah berkas)
  1. Buka Pengaturan → Kemampuan.
  2. Aktifkan "Izinkan lalu lintas keluar jaringan".
  3. Tambahkan dua domain berikut ini: vocalremover.com dan s3.vocalremover.com

Itu saja. Mulai sesi Chat, Cowork, atau Claude Code baru, lampirkan berkas audio, dan ucapkan "remove the vocals" — Claude akan mengunggahnya dan mengembalikan hasilnya.

Konektor khusus tersedia di Claude Pro, Max, Team, dan Enterprise.

Alat

Alat Tingkat Parameter Fungsinya
probe_audio Gratis url Mengembalikan durasi, bitrate, format, dan perkiraan biaya kredit suatu file.
convert_audio Gratis url, format Mengonversi audio ke format mp3, wav, flac, ogg, m4a, aac, atau opus, lalu mengembalikan URL unduhan.
trim_audio Gratis url, start_seconds, duration_seconds Memotong bagian tertentu dari file audio dan mengembalikan URL unduhan.
extract_audio Gratis url Ekstrak trek audio dari file video ke format MP3.
list_voices Gratis Mencantumkan suara target yang diterima clone_voice — id, name, category, dan apakah sampel pratinjau tersedia.
separate_audio Kredit url, task Mulai pemisahan AI (vocals, instrumental, lead_vocals, stems, denoise, dereverb). Mengembalikan job_id.
clone_voice Kredit url, voice | voice_file_url, mode?, pitch? Mengubah suara dalam file audio ke voice id dari list_voices, atau ke klip referensi Anda sendiri yang dikirim sebagai voice_file_url. Parameter mode opsional (singing atau speech) dan pergeseran nada dalam semitone. Mengembalikan job_id — lakukan polling check_audio_job untuk audio yang dikonversi.
check_audio_job Gratis job_id Periksa status pekerjaan pemisahan atau konversi suara, dan dapatkan URL unduhan hasilnya setelah selesai.
check_balance Gratis Menampilkan jumlah kredit menit konversi yang tersisa di akun.

Mengunggah berkas lokal

Alat-alat ini memerlukan URL publik. Jika berkas berada di komputer pengguna, panggil alat create_upload gratis untuk mendapatkan URL unggah sekali pakai, kirim berkas tersebut melalui metode POST ke URL tersebut (tidak memerlukan token), lalu berikan file_url yang dikembalikan ke alat audio mana pun. Tautan unggah dan berkas akan kedaluwarsa setelah 1 jam. Jangan pernah mengonversi file audio asli ke base64 — ukurannya terlalu besar untuk dijadikan argumen alat.

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" }

Tidak ada cara untuk melakukan permintaan web (misalnya, asisten dalam lingkungan sandbox)? Kirimkan tautan `upload_page` kepada pengguna agar mereka dapat mengunggah berkas melalui browser, lalu lanjutkan dengan `file_url`.

Di Claude, pengunggahan berkas memerlukan akses keluar jaringan ke vocalremover.com dan s3.vocalremover.com — aktifkan fitur ini di Pengaturan → Kemampuan (lihat pengaturan Claude di atas).

Contoh: menghapus vokal

Cukup tanyakan kepada asisten Anda dengan bahasa yang sederhana:

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://..." }
                ] }

Alat gratis ini bekerja dengan cara yang sama — misalnya, perintah "convert this file to wav" akan memanggil fungsi convert_audio dan langsung mengembalikan URL unduhan, tanpa menggunakan kredit apa pun.

Hal-hal yang dapat dicoba

  • Hapus vokal dari lagu "https://example.com/song.mp3" dan berikan saya trek karaoke-nya.
  • Pisahkan trek ini menjadi beberapa bagian — vokal, drum, bass, gitar, dan piano.
  • Konversi berkas "https://example.com/interview.m4a" ke format MP3 dengan bitrate 128 kbps.
  • Ekstrak hanya audio dari video ini: https://example.com/clip.mp4
  • Hilangkan noise dari podcast ini dan hilangkan gema ruangan: https://example.com/episode.wav
  • Suara apa saja yang bisa Anda klon?
  • Ubah suara penyanyi dalam trek ini menjadi ID suara "tenor-male" dengan nada +2 semitone: https://example.com/song.mp3
  • Buat https://example.com/song.mp3 terdengar seperti suara di https://example.com/my-voice.m4a
  • Buat versi 8D dan potong durasinya menjadi 30 detik.
  • Berapa durasi dan bitrate dari "https://example.com/track.flac"?
  • Periksa saldo kredit saya.

Batasan & catatan

  • File masukan harus berupa URL http(s) publik, dengan ukuran masing-masing maksimal 100 MB.
  • Pemisahan AI berjalan secara asinkron — selalu periksa check_audio_job untuk hasilnya.
  • Biaya dihitung per menit audio, hanya untuk pemisahan AI.
  • Alat audio gratis ini tidak pernah menggunakan kredit.

Privasi & keamanan

  • Audio Anda diambil dari URL yang Anda berikan, diproses, dan dihapus — kami tidak menyimpan file Anda.
  • Token API Anda terbatas pada akun Anda; Anda dapat mencabutnya kapan saja dari halaman API.
  • Titik akhir hanya mendukung HTTPS; kami memblokir URL yang mengarah ke alamat pribadi/internal.

Pemecahan Masalah

"Diperlukan otentikasi": Token tidak ditemukan atau header salah — harus persis seperti ini: Authorization: Bearer YOUR_API_TOKEN.

"Tidak dapat mengunduh berkas": URL tersebut harus bersifat publik — tidak boleh memerlukan login, dan tidak boleh dialihkan ke alamat pribadi.

Tugas pemisahan tampaknya macet: Tugas AI bersifat asinkron — periksa `check_audio_job` setelah 10–30 detik hingga `done` bernilai `true`.

Claude Desktop tidak dapat terhubung: Pastikan Node/npx sudah terinstal dan ada di PATH Anda, gunakan mcp-remote@latest, dan restart Claude sepenuhnya setelah mengedit konfigurasi.

Kembali ke ikhtisar server MCP