Accès des agents externes

Connectez ACE Studio à des assistants et agents IA via MCP et CLI.

Statut expérimental

L’accès des agents externes dans ACE Studio est actuellement expérimental et en cours de développement actif.

Veuillez noter :

• Changements incompatibles : Les commandes d’outils, les formats et les conventions peuvent évoluer d’une mise à jour à l’autre.

• En cours de développement : Toutes les fonctionnalités de ACE Studio ne sont pas encore entièrement accessibles aux agents.

• Finitions encore imparfaites : Vous pouvez rencontrer des bugs, des cas limites inattendus ou un comportement peu naturel à mesure que nous affinons les interactions avec les agents.

Si vous rencontrez des problèmes ou avez des suggestions, faites-le-nous savoir à [e-mail].

Connectez des assistants et agents IA (comme Claude, ChatGPT, OpenClaw ou Hermes Agent) directement à ACE Studio pour comprendre et modifier vos projets musicaux en temps réel.

Ce que votre agent peut faire

Une fois connecté, un agent peut inspecter et modifier votre projet dans la plupart des fonctions d’ACE Studio :

• Arrangement et composition — Gérer les pistes, les clips, les notes, les paroles, les accords et la tête de lecture.

• Voix et Instruments — Ajuster les Modèles vocaux, les sources sonores, les couches de chœur multi-chanteurs et les Paramètres vocaux (hauteur, souffle, tension).

• Synchronisation et structure — Définir le BPM, les signatures rythmiques, les repères de boucle et le Transport.

• Production & Outils d'IA — Déclencher Ajouter un calque, Vocal vers MIDI, Séparateur de stems, Améliorateur musical, et charger des chaînes FX ou des préréglages.

• Contrôle et livraison de session — Créez et enregistrez des projets, importez Audio et MIDI, puis exportez des mixages complets, des Pistes individuelles, des vidéos, et bien plus encore.

Décrivez simplement ce que vous voulez en langage clair, et votre assistant examinera le Projet et effectuera les modifications.

---

Connexion de votre assistant

Choisissez la méthode de configuration qui correspond à votre flux de travail :

Option A : laissez votre agent IA le configurer pour vous

Si vous utilisez un agent avec un environnement local ou un accès à l’ordinateur (par exemple Claude Code, Codex, OpenClaw, ou Hermes Agent), il peut se configurer automatiquement.

Cette méthode nécessite un agent exécuté sur le même ordinateur qu'ACE Studio, avec les autorisations nécessaires pour exécuter des commandes et modifier ses fichiers de configuration.

Copiez et collez cette invite dans votre agent, puis cliquez sur Envoyer :

Connectez-vous à ACE Studio pour moi en utilisant acestudio-cli ou MCP.

Emplacements par défaut :
- macOS MCP : "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
- macOS CLI : "/Applications/ACE Studio.app/Contents/Helpers/acestudio-cli"
- MCP Windows : "C:\Program Files\ACE Studio\ace-mcp-server.exe"
- CLI Windows : "C:\Program Files\ACE Studio\acestudio-cli.exe"

Essayez d’abord d’utiliser la CLI et gardez le chemin de l’outil dans vos instructions/mémoire. Si l’accès à la CLI est restreint par le sandboxing ou par des autorisations, enregistrez le serveur MCP (sous le nom « ace-studio » avec une portée utilisateur/globale). Si vous ne le trouvez pas à l’emplacement par défaut, demandez-moi le chemin dans les Préférences d’ACE Studio → Général → Accès aux agents externes.

Si vous avez besoin de plus de contexte sur ACE Studio et son intégration d’agent, consultez la documentation à l’adresse https://docs.acestudio.ai/llms.txt. Si votre harness ne peut pas se configurer ou exécuter des commandes locales, veuillez me guider à travers les étapes de configuration manuelle pour votre plateforme.

---

Voie B : configuration manuelle dans votre harness

Si votre harness d’agent ne peut pas se configurer automatiquement, vous devrez ajouter manuellement le serveur MCP d’ACE Studio à sa configuration.

Le protocole Modèle Context Protocol (MCP) est une norme ouverte qui connecte les assistants IA à des applications externes. ACE Studio s’exécute comme un serveur STDIO local, permettant à tout client compatible MCP de se connecter directement à l’aide de la commande de lancement.

Configurer via le terminal

Si vous utilisez Claude ou Codex et préférez configurer directement depuis votre terminal :

Claude

Exécutez dans votre terminal :

macOS :

claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows :

claude mcp add --scope user ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

Codex

Exécutez dans votre terminal :

macOS :

codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows :

codex mcp add ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

Applications de chat de bureau

Pour des guides détaillés pas à pas avec un tutoriel de configuration :

• Claude Desktop et Cowork — Configuration pas à pas pour Claude Desktop avec des explications sur le fichier de configuration.

• ChatGPT pour ordinateur — Configuration pas à pas pour les modes ChatGPT Work et Codex.

Autres environnements et IDE (VS Code, Cursor, clients personnalisés)

La plupart des clients MCP et des IDE demandent les mêmes Paramètres de configuration :

• Type de Transport : STDIO (parfois étiqueté « Local » ou « Commande »)

• Commande : La commande de lancement copiée depuis ACE Studio

• Arguments / Environnement : Aucun

Pour les environnements configurés via des fichiers JSON :

Configuration MCP standard (Cursor, etc.)

Utilisé par Cursor (~/.cursor/mcp.json ou .cursor/mcp.json) et la plupart des environnements MCP standard :

{
  "mcpServers": {
    "ace-studio": {
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

VS Code (GitHub Copilot)

Ajouter à .vscode/mcp.json dans l'espace de travail de votre projet :

{
  "servers": {
    "ace-studio": {
      "type": "stdio",
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

Échappement des chemins Windows dans le JSON : Si vous écrivez manuellement des chemins Windows avec des antislashs dans des fichiers JSON, échappez chaque antislash avec un double antislash (\\), ou utilisez des barres obliques (/).

Assistants IA basés sur le navigateur : Le serveur MCP d'ACE Studio s'exécute localement sur votre machine via STDIO. Les interfaces Web uniquement (comme ChatGPT ou Claude dans un navigateur web) ne peuvent pas se connecter directement à des serveurs STDIO locaux. Utilisez plutôt leurs applications de bureau ou leurs clients de terminal respectifs.

Chemins d'installation personnalisés : Si vous avez installé ACE Studio dans un répertoire personnalisé, ouvrez Préférences → Général → External Agent Access dans ACE Studio :

• Cliquez Copier la commande à côté de Serveur MCP (stdio) pour le chemin du serveur MCP.

• Cliquez Copier à côté de chemin du binaire acestudio-cli pour le chemin de la CLI.

---

Vérification de la connexion

Assurez-vous qu’ACE Studio est ouvert et en cours d’exécution, puis demandez à votre assistant :

Veuillez vérifier les informations actuelles du Projet ACE Studio

Si votre assistant répond avec le Tempo, l’armure et la liste des Pistes de votre Projet, votre configuration est terminée et prête à l’emploi.

---

Exemples de requêtes créatives

Voici quelques exemples concrets de collaboration avec votre assistant IA dans ACE Studio :

1. Production Vocal et harmonies multi-chanteurs

Activez le Mode chœur sur la Piste vocale principale (Piste 1), ajoutez deux choristes
Voix, élargissez l’Étalement stéréo et baissez leur niveau de -3 dB pour obtenir une harmonie d’arrière-plan luxuriante.

2. Mélange de voix personnalisé

Créez une Voix Mélangée personnalisée sur la Piste 2 : mélangez 70 % d’une voix de base pop acoustique chaleureuse
avec 30 % d’une voix de base aérienne et Soufflé, puis nommez le mélange « Velvet Air ».

3. Accords et ébauche de morceau

Dans les Mesures 1 à 8 de la Piste d'accords, insérez une progression Neo-Soul :
Ebmaj9 — G7#9 — Cm9 — F13 (2 Mesures chacune).
Ajoutez ensuite une Piste de Piano Rhodes et une ligne de Basse groovy suivant les notes fondamentales.

4. Accompagnement IA et extraction Audio

Séparer le Clip audio importé sur la Piste 1 en Pistes Vocal, batterie, Basse et autres Pistes.
Exécutez ensuite Vocal vers MIDI sur le Stem Vocal extrait afin de créer une Piste Sing modifiable.

5. Idées de chansons génératives et calques

Écoutez l’arrangement de la Mesure 9 à la Mesure 25 et utilisez Ajouter un calque pour générer
un calque d’accompagnement assorti de nappe de cordes cinématique au Tempo actuel du Projet.

6. Réglage Vocal expressif et dynamique

Examinez les notes Vocal du refrain sur la Piste 1 : lissez les transitions de hauteur,
augmentez le caractère Soufflé sur les notes d’attaque et ajoutez une courbe de Vibrato subtile sur les notes tenues.

7. Chaînes FX et livraison de Stem

Chargez un compresseur Vocal vintage et une réverbération à plaque chaleureuse sur la chaîne FX vocale principale,
puis exportez toutes les Pistes individuelles en tant que Pistes WAV 24 bits/48 kHz dans un dossier « Pistes » sur mon Bureau.