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.
separate_audio Kredit url, task Mulai pemisahan AI (vokal, instrumental, vokal utama, stem, penghilang noise, penghilang gema). Mengembalikan job_id.
clone_voice Kredit url, voice, pitch? Ubah suara dalam berkas audio menjadi ID suara target. Pergeseran nada opsional dalam setengah nada. Mengembalikan job_id โ€” periksa check_audio_job untuk berkas audio yang telah 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
  • โ€บUbah suara penyanyi dalam trek ini menjadi ID suara "tenor-male" dengan nada +2 semitone: https://example.com/song.mp3
  • โ€บ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