Документація щодо сервера Audio MCP

Огляд

Сервер передає дані за протоколом Model Context Protocol через 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 Messages (створіть власного агента)

Підключіть сервер до виклику API Claude за допомогою заголовка бета-версії коннектора MCP:

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 (токен не потрібен), а потім передайте отриману 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://..." }
                ] }

Безкоштовні інструменти працюють так само — наприклад, команда «convert this file to 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 МБ.
• Розділення за допомогою штучного інтелекту виконується асинхронно — завжди перевіряйте результат за допомогою check_audio_job.
• Кредити нараховуються за кожну хвилину аудіозапису, виключно за розділення за допомогою штучного інтелекту.
• Безкоштовні аудіоінструменти ніколи не використовують кредити.

Конфіденційність та безпека

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

Усунення несправностей

Назад до огляду сервера MCP