Документация по серверу Audio MCP

Обзор

Сервер использует протокол Model Context Protocol (MCP) через Streamable HTTP. Направьте любой MCP-клиент на указанный ниже конечный пункт и пройдите аутентификацию с помощью токена API VocalRemover. Файлы передаются в виде общедоступных URL-адресов http(s) (размером до 100 МБ), а результаты возвращаются в виде 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-клиент. 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 сообщений Anthropic (создайте собственного агента)

Подключите сервер к вызову API Claude с помощью заголовка 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

Вот и всё. Начните новый чат, сессию Cowork или Claude Code, прикрепите аудиофайл и скажите «удалить вокал» — Claude загрузит его и вернёт результат.

Пользовательские коннекторы доступны в версиях Claude Pro, Max, Team и Enterprise.

Инструменты

Загрузка локальных файлов

Инструменты принимают общедоступный URL. Если файл находится на компьютере пользователя, вызовите бесплатный инструмент create_upload, чтобы получить одноразовый URL для загрузки, отправьте файл по методу POST на этот URL (токен не требуется), а затем передайте возвращённый 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 кбит/с.
• ›Извлеките только аудио из этого видео: https://example.com/clip.mp4
• ›Удалите шумы из этого подкаста и устраните эхо в помещении: https://example.com/episode.wav
• ›Преобразуйте голос певца в этом треке в голос с идентификатором «tenor-male» с повышением высоты тона на +2 полутона: https://example.com/song.mp3
• ›Создайте версию в формате 8D и сократите её до 30 секунд.
• ›Какова продолжительность и битрейт файла «https://example.com/track.flac»?
• ›Проверить баланс моего счета.

Ограничения и примечания

• Входные файлы должны представлять собой общедоступные URL-адреса по протоколу http(s), размер каждого из которых не должен превышать 100 МБ.
• Разделение AI выполняется асинхронно — для получения результата всегда запрашивайте check_audio_job.
• Кредиты начисляются за каждую минуту аудиозаписи, только за разделение с помощью ИИ.
• Бесплатные аудиоинструменты никогда не используют кредиты.

Конфиденциальность и безопасность

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

Устранение неполадок

Вернуться к обзору сервера MCP