Documentation du serveur Audio MCP

Connectez la boîte à outils audio VocalRemover à votre assistant IA et commencez à éditer des fichiers audio à l'aide du langage naturel.

Présentation

Le serveur utilise le protocole MCP (Model Context Protocol) via HTTP Streamable. Dirigez n'importe quel client MCP vers le point de terminaison ci-dessous et authentifiez-vous à l'aide d'un jeton API VocalRemover. Les fichiers sont transmis sous forme d'URL http(s) publiques (jusqu'à 100 Mo) et les résultats sont renvoyés sous forme d'URL téléchargeables.

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

Guide de démarrage rapide

  1. Obtenez un jeton API gratuit sur le Page de l'API.
  2. Ajoutez le serveur Ă  votre client Ă  l'aide de l'extrait de code ci-dessous.
  3. Demandez : « Supprimez les voix de ».

Authentification

  1. Créez un compte gratuit et ouvrez le Page de l'API.
  2. Générer un jeton API.
  3. Ajoutez-le en tant que jeton Bearer dans la configuration de votre client MCP (voir ci-dessous).

Les outils audio gratuits et les outils IA payants utilisent tous deux ce jeton ; la seule différence réside dans le fait que des crédits de conversion par minute sont facturés ou non.

Configuration du client

Ajoutez le serveur à votre client IA. Claude Desktop utilise le pont mcp-remote ; Cursor, Windsurf, Cline, Zed et Claude Code prennent en charge nativement le MCP à distance avec un jeton Bearer ; ChatGPT et l'application web Claude.ai l'ajoutent en tant que connecteur personnalisé et se connectent via OAuth (voir ci-dessous).

Claude Desktop

Ajoutez-la au fichier claude_desktop_config.json, puis redémarrez 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 distant natif — à ajouter au fichier mcp.json du client.

{
  "mcpServers": {
    "vocalremover": {
      "url": "https://vocalremover.com/mcp/audio",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Code Claude (CLI)

Une seule commande : MCP distant natif, sans passerelle.

claude mcp add --transport http \
  vocalremover https://vocalremover.com/mcp/audio \
  -H "Authorization: Bearer YOUR_API_TOKEN"

API Anthropic Messages (créez votre propre agent)

Associez le serveur Ă  un appel API Claude Ă  l'aide de l'en-tĂŞte du connecteur MCP bĂŞta :

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 (connecteur personnalisé)

Dans les paramètres de ChatGPT, activez le mode Développeur, ouvrez Applications et connecteurs → Créer, puis ajoutez un connecteur personnalisé pointant vers l'URL du serveur ci-dessous. ChatGPT exécute le flux OAuth : vous vous connectez à VocalRemover et approuvez l'accès ; aucun jeton à coller. (Nécessite un forfait incluant les connecteurs personnalisés, par exemple Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Votre forfait ne donne pas accès à un connecteur personnalisé ? Créez plutôt un GPT personnalisé et ajoutez une action qui importe notre schéma OpenAPI avec une authentification par clé API (Bearer).

Claude (application web, Cowork & Claude Code)

Ajoutez le serveur une seule fois en tant que connecteur personnalisé, puis autorisez l'accès au réseau afin que Claude puisse télécharger et récupérer vos fichiers audio.

1. Ajouter le connecteur
  1. Ouvrez Personnaliser → Connecteurs.
  2. Cliquez sur « Ajouter un connecteur » (le bouton +), puis sélectionnez « Ajouter un connecteur personnalisé ».
  3. Entrez « VocalRemover » dans le champ Nom, collez l'URL du serveur MCP ci-dessous, puis cliquez sur Ajouter.
  4. Connectez-vous à VocalRemover et validez l'accès lorsque vous y êtes invité — aucun jeton à coller.
https://vocalremover.com/mcp/audio
2. Autoriser l'accès au réseau (pour qu'il puisse télécharger des fichiers)
  1. Ouvrez Paramètres → Capacités.
  2. Activez l'option « Autoriser les sorties réseau ».
  3. Ajoutez ces deux domaines : vocalremover.com et s3.vocalremover.com

Et voilà. Lancez une nouvelle session Chat, Cowork ou Claude Code, joignez un fichier audio et dites « supprimer les voix » : Claude le télécharge et vous renvoie le résultat.

Les connecteurs personnalisés sont disponibles sur les versions Claude Pro, Max, Team et Enterprise.

Outils

Outil Niveau Paramètres Fonctionnalité
probe_audio Gratuit url Renvoie la durée, le débit binaire, le format et le coût estimé d'un fichier.
convert_audio Gratuit url, format Réencode l'audio au format mp3, wav, flac, ogg, m4a, aac ou opus et renvoie une URL de téléchargement.
trim_audio Gratuit url, start_seconds, duration_seconds Découpe une section d'un fichier audio et renvoie une URL de téléchargement.
extract_audio Gratuit url Extraire la piste audio d'un fichier vidéo au format MP3.
separate_audio Crédits url, task Lance la séparation par IA (voix, instrumental, voix principale, pistes, débruitage, suppression de la réverbération). Renvoie un job_id.
clone_voice Crédits url, voice, pitch? Modifie la voix d'un fichier audio pour lui attribuer un identifiant de voix cible. Modification facultative de la hauteur tonale par demi-tons. Renvoie un job_id — interrogez check_audio_job pour obtenir le fichier audio converti.
check_audio_job Gratuit job_id Interrogez une tâche de séparation ou de conversion vocale et obtenez les URL de téléchargement des fichiers de sortie une fois celle-ci terminée.
check_balance Gratuit — Affiche le nombre de crédits de minutes de conversion restants sur le compte.

Téléchargement de fichiers locaux

Les outils acceptent une URL publique. Si le fichier se trouve sur l'ordinateur de l'utilisateur, appelez l'outil gratuit create_upload pour obtenir une URL de téléchargement à usage unique, envoyez le fichier via une requête POST à cette URL (aucun jeton n'est nécessaire), puis transmettez la valeur file_url renvoyée à n'importe quel outil audio. Le lien de téléchargement et le fichier expirent au bout d'une heure. Ne convertissez jamais un fichier audio réel au format base64 : il est bien trop volumineux pour être passé en argument à un outil.

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

Impossible d'effectuer des requêtes Web (par exemple, avec un assistant en mode sandbox) ? Envoyez à l'utilisateur le lien upload_page pour qu'il dépose le fichier dans un navigateur, puis poursuivez avec l'URL du fichier (file_url).

Dans Claude, le téléchargement de fichiers nécessite un accès sortant vers vocalremover.com et s3.vocalremover.com — activez cette option dans Paramètres → Capacités (voir la configuration de Claude ci-dessus).

Exemple : suppression des voix

Il suffit de demander Ă  votre assistant en langage simple :

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

Les outils gratuits fonctionnent de la même manière : par exemple, la commande « convertir ce fichier au format wav » appelle la fonction convert_audio et renvoie instantanément une URL de téléchargement, sans utiliser de crédits.

Ă€ essayer

  • ›Retirez les voix de https://example.com/song.mp3 et donnez-moi la piste karaokĂ©.
  • ›Divisez cette piste en pistes sĂ©parĂ©es : chant, batterie, basse, guitare et piano.
  • ›Convertissez le fichier « https://example.com/interview.m4a » au format MP3 Ă  128 kbps.
  • ›Extrayez uniquement la piste audio de cette vidĂ©o : https://example.com/clip.mp4
  • ›RĂ©duire le bruit de ce podcast et supprimer l'Ă©cho de la pièce : https://example.com/episode.wav
  • ›Convertissez la voix du chanteur de ce morceau en voix de type « tĂ©nor masculin » avec une hauteur de +2 demi-tons : https://example.com/song.mp3
  • ›CrĂ©ez une version 8D et raccourcissez-la Ă  30 secondes.
  • ›Quelle est la durĂ©e et le dĂ©bit binaire d'https://example.com/track.flac ?
  • ›VĂ©rifier le solde de mon crĂ©dit.

Limites et remarques

  • Les fichiers d'entrĂ©e doivent ĂŞtre des URL http(s) publiques, d'une taille maximale de 100 Mo chacun.
  • La sĂ©paration IA s'exĂ©cute de manière asynchrone — interrogez toujours check_audio_job pour obtenir le rĂ©sultat.
  • Les crĂ©dits sont facturĂ©s Ă  la minute d'audio, uniquement pour la sĂ©paration par IA.
  • Les outils audio gratuits n'utilisent jamais de crĂ©dits.

Confidentialité et sécurité

  • Vos fichiers audio sont rĂ©cupĂ©rĂ©s Ă  partir de l'URL que vous fournissez, traitĂ©s, puis supprimĂ©s — nous ne conservons pas vos fichiers.
  • Votre jeton API est liĂ© Ă  votre compte ; vous pouvez le rĂ©voquer Ă  tout moment depuis la page API.
  • Le point de terminaison fonctionne uniquement en HTTPS ; nous bloquons les URL qui renvoient vers des adresses privĂ©es ou internes.

Dépannage

« Authentification requise »: Le jeton est manquant ou l'en-tête est incorrect — il doit être exactement « Authorization: Bearer VOTRE_JETON_API ».

« Impossible de télécharger le fichier »: L'URL doit être publique — elle ne doit pas nécessiter de connexion ni rediriger vers une adresse privée.

Une tâche de séparation semble bloquée: Les tâches d'IA sont asynchrones — interrogez check_audio_job toutes les 10 à 30 secondes jusqu'à ce que la valeur « done » soit vraie.

Claude Desktop ne se connecte pas: Assurez-vous que Node/npx est installé et ajouté à votre PATH, utilisez mcp-remote@latest, et redémarrez complètement Claude après avoir modifié la configuration.

Retour à la présentation du serveur MCP