Документация за аудио MCP сървъра

Общ преглед

Сървърът използва протокола Model Context Protocol (MCP) през Streamable HTTP. Насочете всеки MCP клиент към крайната точка по-долу и се идентифицирайте с токен за API на VocalRemover. Файловете се предават като публични URL адреси по HTTP(S) (до 100 MB), а резултатите се връщат като URL адреси за изтегляне.

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

Бързо начало

1. Получете безплатен API токен на Страница за API.
2. Добавете сървъра към клиента си, като използвате фрагмента по-долу.
3. Попитайте: „Премахни вокалите от .“

Удостоверяване

1. Създайте безплатен акаунт и отворете Страница за API.
2. Генерирайте API токен.
3. Добавете го като Bearer токен в конфигурацията на вашия MCP клиент (вижте по-долу).

Както безплатните аудио инструменти, така и платените AI инструменти използват този токен; разликата е само в това дали се начисляват кредити за минути преобразуване.

Настройка на клиента

Добавете сървъра към вашия AI клиент. Claude Desktop използва моста mcp-remote; Cursor, Windsurf, Cline, Zed и Claude Code поддържат отдалечен MCP по подразбиране с Bearer токен; 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"

API за антропни съобщения (създайте свой собствен агент)

Свържете сървъра към извикване на Claude API с заглавката на MCP connector 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 (персонализиран конектор)

В настройките на ChatGPT активирайте режим „Разработчик“, отворете „Приложения и конектори“ → „Създаване“ и добавете персонализиран конектор, сочещ към URL адреса на сървъра по-долу. ChatGPT изпълнява OAuth процеса — влизате в VocalRemover и одобрявате достъпа; не е необходимо да поставяте токен. (Изисква план с персонализирани конектори, например Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Нямате достъп до персонализиран конектор в плана си? Създайте вместо това персонализиран GPT и добавете действие, което импортира нашата OpenAPI схема с удостоверяване чрез API ключ (Bearer).

Claude (уеб приложение, Cowork & Claude Code)

Добавете сървъра веднъж като персонализиран конектор, след което разрешете мрежов достъп, за да може Claude да качва и изтегля вашите аудио файлове.

1. Отворете „Персонализиране“ → „Съединители“.
2. Кликнете върху „Добави конектор“ (бутонът „+“), след което изберете „Добави персонализиран конектор“.
3. Задайте името „VocalRemover“, поставете URL адреса на MCP сървъра по-долу и кликнете върху „Добави“.
4. Влезте в VocalRemover и потвърдете достъпа, когато бъдете подканени — не е необходимо да поставяте токен.

https://vocalremover.com/mcp/audio

1. Отворете „Настройки“ → „Възможности“.
2. Активирайте опцията „Разреши изходящ трафик към мрежата“.
3. Добавете тези два домейна: vocalremover.com и s3.vocalremover.com

Това е всичко. Започнете нова сесия в Chat, Cowork или Claude Code, прикачете аудио файл и кажете „премахни вокалите“ — Claude ще го качи и ще ви върне резултата.

Персонализираните конектори са достъпни в версиите Claude Pro, Max, Team и Enterprise.

Инструменти

Качване на локални файлове

Инструментите приемат публичен URL адрес. Ако файлът се намира на компютъра на потребителя, извикайте безплатния инструмент create_upload, за да получите еднократен 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“ в MP3 при 128 kbps.
• ›Извлечете само аудиото от това видео: https://example.com/clip.mp4
• ›Премахнете шума от този подкаст и елиминирайте ехото в стаята: https://example.com/episode.wav
• ›Преобразувайте гласа на певеца в този запис към гласов идентификатор „тенор-мъж“ с височина на тона +2 полутона: https://example.com/song.mp3
• ›Направете 8D версия и я съкратете до 30 секунди.
• ›Каква е продължителността и битрейтът на „https://example.com/track.flac“?
• ›Провери баланса ми.

Ограничения и бележки

• Входните файлове трябва да бъдат публични URL адреси по протокол http(s), с размер до 100 MB всеки.
• Разделянето чрез AI се изпълнява асинхронно — винаги проверявайте check_audio_job за резултата.
• Кредитите се начисляват на минута аудио, само за AI разделяне.
• Безплатните аудио инструменти никога не използват кредити.

Поверителност и сигурност

• Вашите аудиофайлове се извличат от предоставения от вас URL адрес, обработват се и след това се изтриват — ние не съхраняваме вашите файлове.
• Вашият API токен е свързан с вашия акаунт; можете да го отмените по всяко време от страницата на API.
• Крайната точка е само HTTPS; блокираме URL адреси, които водят до частни/вътрешни адреси.

Отстраняване на проблеми

Назад към обзор на MCP сървъра