# ACE Studio MCP Server ## ACE Studio MCP Server {% hint style="warning" %} #### Statut expérimental Le ACE Studio MCP Server est actuellement en **phase expérimentale**. **Veuillez noter :** * Certaines fonctionnalités et paramètres ne sont peut-être pas encore entièrement implémentés * Les fonctionnalités peuvent évoluer * Vous pouvez rencontrer des bugs ou des problèmes de performances lors de l'utilisation * Les consignes d'utilisation et les limites de débit seront publiées lors de la sortie de la version stable Nous améliorons activement cette fonctionnalité. Si vous avez des commentaires ou rencontrez des problèmes, veuillez nous contacter à [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Le serveur ACE Studio MCP offre une boîte à outils riche qui permet aux agents IA de naviguer de manière autonome et d'exécuter des modifications créatives. En donnant aux agents IA une vision complète de chaque détail de votre Projet, il leur permet de vous aider à créer et à éditer des chansons avec plus de rapidité et de liberté créative. [Le Modèle Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) est une norme ouverte qui permet aux assistants IA de se connecter de manière fluide à des applications externes et à des sources de données. Le serveur ACE Studio MCP implémente ce protocole afin de donner aux agents IA un accès direct à votre espace de création. ### Démarrage rapide #### Lancez le ACE Studio MCP Server 1. Ouvrez **ACE Studio**. 2. Accédez à **Préférences → Général → MCP Server**. 3. Choisissez un mode de transport : **HTTP** ou **STDIO**. > Le mode de transport que vous sélectionnez ici détermine la manière dont votre client IA se connecte à ACE Studio. Consultez les sections ci-dessous pour plus de détails et la configuration spécifique au client. Choisissez la configuration appropriée en fonction du mode de transport sélectionné et de votre client IA. #### Mode HTTP diffusable En mode HTTP, ACE Studio exécute un serveur MCP local à une adresse fixe. Votre client IA s'y connecte via le réseau. **Adresse du serveur :** `http://localhost:21572/mcp` > **Note technique**: Le serveur ACE Studio MCP utilise le **protocole de transport HTTP diffusable**. Conservez cette adresse pour l'étape de configuration suivante. **Claude Desktop** > ⚠ La configuration du serveur ACE Studio MCP dans Claude Desktop nécessite la modification d'un fichier de configuration JSON. Si vous n'êtes pas à l'aise avec la configuration technique, nous vous recommandons d'essayer des clients plus simples à utiliser. **Étapes de configuration :** 1. Installez Node.js si nécessaire. * Rendez-vous sur [nodejs.org](https://nodejs.org) et téléchargez la version LTS. 2. Localisez le fichier de configuration de Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 3. Modifiez le fichier de configuration et ajoutez ce qui suit : ```json { "mcpServers": { "acestudio": { "command": "npx", "args": [ "mcp-remote", "http://localhost:21572/mcp" ] } } } ``` 4. Enregistrez le fichier et redémarrez Claude Desktop. **Vérifier la connexion :**\ Saisissez dans Claude : ``` Veuillez vérifier les informations du projet ACE Studio actuel ``` Si Claude renvoie les détails du projet, la connexion est réussie. **Cursor** Vous pouvez ajouter directement le serveur MCP à Cursor en cliquant [ici](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). Ou le configurer manuellement : 1. Ouvrez les paramètres de Cursor. 2. Trouvez la section **Tools & MCP** . 3. Cliquez sur **New MCP Server**. 4. Renseignez le JSON suivant : ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Cliquez sur **Enregistrer**. 6. Redémarrez Cursor. **Vérifier la connexion :**\ Saisissez dans Cursor Chat : ``` @acestudio Quelles pistes sont dans le projet actuel ? ``` **VS Code via la prise en charge native de MCP** Vous pouvez ajouter directement le serveur MCP à VS Code en cliquant [ici](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22acestudio%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22http%3A%2F%2Flocalhost%3A21572%2Fmcp%22%7D). Ou le configurer manuellement : 1. Créer ou modifier `.vscode/mcp.json` dans votre espace de travail. 2. Ajoutez la configuration suivante : ```json { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp" } } } ``` **VS Code via Cline** 1. Installez l’extension Cline. 2. Ouvrez les paramètres de l’extension. 3. Trouvez la section de configuration MCP Servers. 4. Ajoutez un nouveau serveur : ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **Autres clients** Pour la plupart des clients, utilisez ces paramètres de configuration : * **Type de Transport :** HTTP diffusable. Certains clients peuvent l’appeler `Remote`. * **URL du serveur :** `http://localhost:21572/mcp` Ou importez le serveur MCP avec le JSON suivant : ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` #### Mode STDIO En mode STDIO, votre client IA lance et communique directement avec le serveur MCP d’ACE Studio via l’entrée et la sortie standard. La configuration est plus simple. Vous n’avez pas besoin de démarrer un serveur manuellement ni d’utiliser une adresse réseau. **Obtention de la commande :** 1. Dans ACE Studio, allez à **Préférences → Général → MCP Server**. 2. Réglez le mode sur **STDIO**. 3. Cliquez sur **Copier la commande** pour copier la commande du serveur dans votre presse-papiers. La commande copiée ressemblera à ceci : ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` Utilisez cette commande dans les étapes de configuration ci-dessous. {% hint style="info" %} Le chemin de la commande varie selon le système d’exploitation. Utilisez la commande exacte copiée depuis ACE Studio dans chaque configuration client ci-dessous. {% endhint %} **Claude Desktop** STDIO est le Transport natif de Claude Desktop. Vous n’avez pas besoin d’outils supplémentaires comme `mcp-remote`. 1. Localisez le fichier de configuration de Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 2. Modifiez le fichier de configuration et ajoutez ce qui suit : ```json { "mcpServers": { "acestudio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 3. Enregistrez le fichier et redémarrez Claude Desktop. **Vérifier la connexion :**\ Saisissez dans Claude : ``` Veuillez vérifier les informations du projet ACE Studio actuel ``` Si Claude renvoie les détails du projet, la connexion est réussie. **Cursor** 1. Ouvrez les paramètres de Cursor. 2. Trouvez la section **Tools & MCP** . 3. Cliquez sur **New MCP Server**. 4. Renseignez le JSON suivant : ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Cliquez sur **Enregistrer**. 6. Redémarrez Cursor. **Vérifier la connexion :**\ Saisissez dans Cursor Chat : ``` @acestudio Quelles pistes sont dans le projet actuel ? ``` **VS Code via la prise en charge native de MCP** 1. Créer ou modifier `.vscode/mcp.json` dans votre espace de travail. 2. Ajoutez la configuration suivante : ```json { "servers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **VS Code via Cline** 1. Installez l’extension Cline. 2. Ouvrez les paramètres de l’extension. 3. Trouvez la section de configuration MCP Servers. 4. Ajoutez un nouveau serveur : ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **Autres clients** Pour la plupart des clients, utilisez ces paramètres de configuration : * **Type de Transport :** STDIO * **Commande :** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server` * **Arguments :** `--stdio` Ou importez le serveur MCP avec le JSON suivant : ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` ### Exemples d’utilisation Une fois connecté, vous pouvez essayer les invites suivantes pour collaborer avec votre assistant IA : #### Créer un Nouveau Projet ``` Aidez-moi à créer un Nouveau Projet de style pop avec un BPM de 120 dans ACE Studio, en do majeur, ajoutez une piste Vocal principale et une piste d’accompagnement au violon ``` #### Générer des Paroles et une mélodie ``` Sur le thème « Souvenirs d’été au bord de la mer », écrivez une section de refrain de 8 Mesures dans ACE Studio. La mélodie doit être légère et entraînante, en utilisant une Gamme pentatonique ``` #### Modifier le MIDI ``` Dans ACE Studio, ajoutez une progression d’Accords au Piano aux mesures 9-16 : C - Am - F - G, chaque accord durant 2 mesures ``` --- # Agent Instructions: 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: ``` GET https://docs.acestudio.ai/docs/product-wiki-fr/outils-dia/ace-studio-mcp-server.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.