Ses MCP Sunucu Belgeleri

Genel Bakış

Sunucu, Model Context Protocol'ü Streamable HTTP üzerinden iletir. Herhangi bir MCP istemcisini aşağıdaki uç noktaya yönlendirin ve VocalRemover API jetonu ile kimlik doğrulaması yapın. Dosyalar, herkese açık http(s) URL'leri olarak iletilir (en fazla 100 MB) ve sonuçlar indirilebilir URL'ler olarak geri gönderilir.

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

Hızlı Başlangıç

1. Şu adresten ücretsiz bir API jetonu alın: API sayfası.
2. Aşağıdaki kod parçasını kullanarak sunucuyu istemcinize ekleyin.
3. Şöyle sorun: "'den vokalleri kaldır."

Kimlik Doğrulama

1. Ücretsiz bir hesap oluşturun ve API sayfası.
2. Bir API jetonu oluşturun.
3. Bunu MCP istemci yapılandırmanıza Bearer tokeni olarak ekleyin (aşağıya bakın).

Hem ücretsiz ses araçları hem de ücretli AI araçları bu jetonu kullanır; aradaki tek fark, dönüştürme dakikası kredilerinin ücretlendirilip ücretlendirilmediğidir.

İstemci kurulumu

Sunucuyu AI istemcinize ekleyin. Claude Desktop, mcp-remote köprüsünü kullanır; Cursor, Windsurf, Cline, Zed ve Claude Code, Bearer jetonu ile uzaktan MCP'yi yerel olarak destekler; ChatGPT ve Claude.ai web uygulaması ise bunu özel bir bağlayıcı olarak ekler ve OAuth aracılığıyla oturum açar (aşağıya bakın).

{
  "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 Mesaj API'si (kendi ajanınızı oluşturun)

Sunucuyu, MCP konektörü beta başlığıyla bir Claude API çağrısına bağlayın:

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 (özel bağlayıcı)

ChatGPT ayarlarında Geliştirici modunu etkinleştirin, Uygulamalar ve Bağlayıcılar → Oluştur'u açın ve aşağıdaki sunucu URL'sini gösteren özel bir bağlayıcı ekleyin. ChatGPT, OAuth akışını çalıştırır — VocalRemover'da oturum açıp erişimi onaylarsınız; yapıştırmanız gereken bir token yoktur. (Özel bağlayıcıların bulunduğu bir plan gerektirir, ör. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Planınızda özel konektör erişimi yok mu? Bunun yerine bir Özel GPT oluşturun ve API anahtarı (Bearer) kimlik doğrulamasıyla OpenAPI şemamızı içe aktaran bir Eylem ekleyin.

Claude (web uygulaması, Cowork & Claude Code)

Sunucuyu bir kez özel bağlayıcı olarak ekleyin, ardından Claude'un ses dosyalarınızı yükleyip alabilmesi için ağ erişimine izin verin.

1. Özelleştir → Bağlayıcılar'ı açın.
2. "Bağlayıcı Ekle" (artı işareti) düğmesine tıklayın, ardından "Özel bağlayıcı ekle" seçeneğini seçin.
3. Adı "VocalRemover" olarak ayarlayın, aşağıya MCP sunucu URL'sini yapıştırın ve Ekle'ye tıklayın.
4. VocalRemover'da oturum açın ve istendiğinde erişimi onaylayın — yapıştırılacak bir jeton yoktur.

https://vocalremover.com/mcp/audio

1. Ayarlar → Özellikler'i açın.
2. "Ağ çıkışına izin ver" seçeneğini etkinleştirin.
3. Bu iki etki alanını ekleyin: vocalremover.com ve s3.vocalremover.com

Hepsi bu kadar. Yeni bir Sohbet, Cowork veya Claude Code oturumu başlatın, bir ses dosyası ekleyin ve "vokalleri kaldır" deyin — Claude dosyayı yükler ve sonucu size geri gönderir.

Özel konektörler Claude Pro, Max, Team ve Enterprise sürümlerinde kullanılabilir.

Araçlar

Yerel dosyaların yüklenmesi

Araçlar, herkese açık bir URL alır. Dosya kullanıcının bilgisayarındaysa, ücretsiz create_upload aracını çağırarak tek kullanımlık bir yükleme URL'si alın, dosyayı bu URL'ye POST edin (token gerekmez), ardından döndürülen file_url değerini herhangi bir ses aracına aktarın. Yükleme bağlantısı ve dosya 1 saat sonra geçerliliğini yitirir. Asla gerçek bir ses dosyasını base64'e dönüştürmeyin — bu, bir araç argümanı için çok büyüktür.

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

Web istekleri göndermenin bir yolu yok mu (ör. sanal ortamda çalışan bir asistan)? Kullanıcıya upload_page bağlantısını gönderin, böylece dosyayı tarayıcıya sürükleyip bırakabilir, ardından file_url ile devam edebilirsiniz.

Claude'da dosya yükleme işlemi için vocalremover.com ve s3.vocalremover.com adreslerine ağ çıkışı gerekir — bunu Ayarlar → Yetenekler altından etkinleştirin (yukarıdaki Claude kurulumuna bakın).

Örnek: vokalleri kaldırma

Asistanınıza basit bir dille şunu söyleyin:

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

Ücretsiz araçlar da aynı şekilde çalışır — örneğin, "bu dosyayı wav formatına dönüştür" komutu convert_audio işlevini çağırır ve kredi harcamadan anında bir indirme URL'si döndürür.

Denemeniz gerekenler

• ›https://example.com/song.mp3'daki vokalleri kaldırın ve bana karaoke parçasını verin.
• ›Bu parçayı vokal, davul, bas, gitar ve piyano olmak üzere ayrı parçalara bölün.
• ›https://example.com/interview.m4a'yi 128 kbps'de MP3'e dönüştürün.
• ›Bu videodan sadece sesi ayıklayın: https://example.com/clip.mp4
• ›Bu podcast'teki gürültüyü giderin ve oda yankısını ortadan kaldırın: https://example.com/episode.wav
• ›Bu parçadaki şarkıcının sesini, +2 yarım ton yüksekliğe sahip "tenor-erkek" ses kimliğine dönüştürün: https://example.com/song.mp3
• ›8D versiyonunu hazırlayın ve 30 saniyeye kısaltın.
• ›https://example.com/track.flac'in süresi ve bit hızı nedir?
• ›Kredi bakiyemi kontrol et.

Sınırlar ve notlar

• Giriş dosyaları, her biri en fazla 100 MB büyüklüğünde, herkese açık http(s) URL'leri olmalıdır.
• AI ayırma işlemi eşzamansız olarak çalışır — sonuç için her zaman check_audio_job'u sorgulayın.
• Kredi, yalnızca AI ayırma işlemi için sesin dakikası başına tahsil edilir.
• Ücretsiz ses araçları hiçbir zaman kredi kullanmaz.

Gizlilik ve güvenlik

• Ses dosyanız, belirttiğiniz URL'den alınır, işlenir ve silinir — dosyalarınızı saklamıyoruz.
• API jetonunuz hesabınızla sınırlıdır; API sayfasından istediğiniz zaman iptal edebilirsiniz.
• Uç nokta yalnızca HTTPS'dir; özel/dahili adreslere yönlendiren URL'leri engelliyoruz.

Sorun Giderme

MCP sunucusu genel bakışına geri dön