> For the complete documentation index, see [llms.txt](https://docs.acestudio.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acestudio.ai/docs/product-wiki-fr/agent-ia/external-agent-access.md). # Accès aux agents externes Connectez ACE Studio à des assistants et agents IA via MCP et CLI. {% hint style="warning" %} #### 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 changer d’une mise à jour à l’autre. * **En cours de développement :** Toutes les fonctionnalités d’ACE Studio ne sont pas encore entièrement accessibles aux agents. * **Aspects imparfaits :** Vous pouvez rencontrer des bugs, des cas limites inattendus ou un comportement peu naturel pendant que nous affinons les interactions avec les agents. Si vous rencontrez des problèmes ou avez des suggestions, veuillez nous en faire part à [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Connectez des assistants IA et des agents (tels que 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érez les pistes, les clips, les notes, les Paroles, les accords et la tête de lecture. * **Voix et Instruments** — Ajustez les Modèles vocaux, les sources sonores, les couches de Chœur multi-chanteurs et les Paramètres vocaux (hauteur, Souffle, Tension), et chargez des plug-ins d'Instrument tiers. * **Timing et structure** — Définissez le BPM, les signatures temporelles, les marqueurs 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** — Lancez et enregistrez des projets, importez l'Audio et le MIDI, et exportez des mixages complets, des Pistes individuelles, la vidéo, et bien plus encore. Décrivez simplement ce que vous souhaitez en langage clair, et votre assistant examinera le Projet et effectuera les modifications. *** ### Connexion de votre assistant Choisissez la méthode de configuration qui convient à 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. {% hint style="info" %} 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. {% endhint %} Le moyen le plus rapide est depuis ACE Studio. Cliquez sur l' **icône de l'agent** dans le coin inférieur droit de la fenêtre, choisissez **ChatGPT**, **Claude**, ou **Autres agents**, et suivez les trois étapes indiquées : ouvrez votre agent, copiez l’invite de connexion avec le **Copier** bouton, envoyez-la, puis commencez à créer avec l’une des invites d’exemple. La même invite de connexion est reproduite ici. Copiez-la et collez-la 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" - Windows MCP : "C:\\Program Files\\ACE Studio\\ace-mcp-server.exe" - Windows CLI : "C:\\Program Files\\ACE Studio\\acestudio-cli.exe" Essayez d'abord d'utiliser la CLI et mémorisez le chemin de l'outil dans vos instructions/mémoire. Si l'accès à la CLI est restreint par l'isolation ou les permissions, enregistrez le serveur MCP (sous le nom "ace-studio" avec une portée utilisateur/globale). S'il n'est pas trouvé à l'emplacement par défaut, demandez-moi le chemin depuis les Préférences → Général → Accès à l'agent externe d'ACE Studio. Ensuite, installez le plugin de compétences/agent depuis le dépôt officiel d'ACE Studio à https://github.com/BeatMagic/acestudio_agent_plugin. Il est important de l'avoir installé et disponible, car il vous fournit le savoir-faire nécessaire lorsque vous interagissez avec ACE Studio. Si vous avez besoin de plus de contexte sur ACE Studio et son intégration d'agent, reportez-vous à la documentation à https://docs.acestudio.ai/llms.txt. Si votre environnement d'exécution ne peut pas se configurer lui-même ou exécuter des commandes locales, veuillez me guider à travers les étapes de configuration manuelle pour votre plateforme. ``` *** #### Option B : Configuration manuelle dans votre environnement d'exécution Si votre environnement d'agent ne peut pas se configurer automatiquement, vous devrez ajouter manuellement le serveur MCP d'ACE Studio à sa configuration. [Le protocole de contexte du Modèle (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) est une norme ouverte qui relie les assistants IA aux 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. **Configuration via le terminal** Si vous utilisez Claude ou Codex et préférez configurer directement depuis votre terminal : {% tabs %} {% tab title="Claude" %} Exécutez dans votre terminal : **macOS :** ```bash claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows :** ```cmd claude mcp add --scope user ace-studio -- "C:\\Program Files\\ACE Studio\\ace-mcp-server.exe" ``` {% endtab %} {% tab title="Codex" %} Exécutez dans votre terminal : **macOS :** ```bash codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows :** ```cmd codex mcp add ace-studio -- "C:\\Program Files\\ACE Studio\\ace-mcp-server.exe" ``` {% endtab %} {% endtabs %} **Applications de chat de bureau** Pour des guides complets étape par étape avec une présentation de la configuration : * [**Claude Desktop et Cowork**](/docs/product-wiki-fr/agent-ia/external-agent-access/claude-desktop-and-cowork.md) — Configuration étape par étape pour Claude Desktop avec un guide pas à pas du fichier de configuration. * [**ChatGPT de bureau**](/docs/product-wiki-fr/agent-ia/external-agent-access/chatgpt-for-desktop.md) — Configuration étape par étape pour les modes ChatGPT Work et Codex. **Autres environnements d'exécution 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 libellé "Local" ou "Commande") * **Commande :** La commande de lancement copiée depuis ACE Studio * **Arguments / environnement :** Aucun Pour les environnements d'exécution configurés via des fichiers JSON : {% tabs %} {% tab title="Configuration MCP standard (Cursor, etc.)" %} Utilisé par Cursor (`~/.cursor/mcp.json` ou `.cursor/mcp.json`) et par la plupart des environnements d'exécution MCP standard : ```json { "mcpServers": { "ace-studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% tab title="VS Code (GitHub Copilot)" %} Ajoutez à `.vscode/mcp.json` dans votre espace de travail de projet : ```json { "servers": { "ace-studio": { "type": "stdio", "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% endtabs %} {% hint style="info" %} **Échappement des chemins Windows dans JSON :** Si vous écrivez manuellement des chemins Windows avec des barres obliques inverses dans des fichiers JSON, échappez chaque barre oblique inverse par un double antislash (`\\`), ou utilisez des barres obliques (`/`). {% endhint %} {% hint style="warning" %} **Assistants IA basés sur le navigateur :**\ Le serveur MCP d’ACE Studio s’exécute localement sur votre machine via STDIO. Les interfaces exclusivement Web (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 respectives ou leurs clients de terminal. {% endhint %} {% hint style="info" %} **Chemins d’installation personnalisés :** Si vous avez installé ACE Studio dans un répertoire personnalisé, ouvrez **Préférences → Général → Accès des agents externes** dans ACE Studio : * Cliquez sur **Copier la commande** à côté de **Serveur MCP (stdio)** pour le chemin du serveur MCP. * Cliquez sur **Copier** à côté de **chemin du binaire acestudio-cli** pour le chemin du CLI. {% endhint %} *** ### 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, la tonalité et la liste des Pistes de votre Projet, votre configuration est terminée et prête à l’emploi. *** ### Exemples de prompts créatifs Voici quelques exemples concrets de collaboration avec votre assistant IA dans ACE Studio : #### 1. Production vocale et harmonies multi-chanteurs ``` Activez le Mode chœur sur la piste vocale principale (Piste 1), ajoutez deux voix de choristes voix, élargissez l’étalement stéréo et baissez leur niveau de -3 dB pour une harmonie d’arrière-plan riche. ``` #### 2. Mélange de voix personnalisé ``` Créez une Voix Mélangée personnalisée sur la Piste 2 : mélangez 70 % d’une base pop acoustique chaleureuse avec 30 % d’une base de voix aérienne et soufflée, puis nommez le mélange « Velvet Air ». ``` #### 3. Accords et esquisse du morceau ``` Dans les mesures 1 à 8 de la piste d'accords, insérez une progression néo-soul : Ebmaj9 — G7#9 — Cm9 — F13 (2 mesures chacun). Ajoutez ensuite une piste de piano Rhodes et une ligne de basse groovy en suivant les notes fondamentales. ``` #### 4. Accompagnement IA et extraction audio ``` Séparez le Clip audio importé sur la Piste 1 en voix, batterie, basse et autres pistes. Puis lancez Vocal vers MIDI sur la piste vocale extraite pour créer une piste Sing modifiable. ``` #### 5. Idées de morceaux génératives et calques ``` Écoutez l’arrangement des mesures 9 à 25 et utilisez Ajouter un calque pour générer un calque d’accompagnement de nappes de cordes cinématiques correspondant au Tempo actuel du Projet. ``` #### 6. Réglage vocal expressif et dynamique ``` Examinez les notes vocales 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 export des Pistes ``` Chargez un compresseur vocal vintage et une réverbération à plaque chaleureuse sur la chaîne FX de la voix principale, puis exportez toutes les pistes individuelles en WAV 24 bits/48 kHz vers un dossier « Pistes » sur mon Bureau. ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.acestudio.ai/docs/product-wiki-fr/agent-ia/external-agent-access.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.