> 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/outils-dia/ace-studio-mcp-server.md). # Serveur MCP d’ACE Studio ## Serveur MCP ACE Studio {% hint style="warning" %} #### Statut expérimental Le serveur MCP ACE Studio est actuellement en **phase expérimentale**. **Remarque :** * Certaines fonctionnalités et certains Paramètres peuvent ne pas encore être entièrement implémentés * Les fonctionnalités peuvent évoluer * Vous pouvez rencontrer des bugs ou des problèmes de performances pendant 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 à l’adresse [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Le serveur MCP ACE Studio propose une riche boîte à outils permettant aux agents d’IA de naviguer et d’exécuter des modifications créatives de manière autonome. En donnant aux agents d’IA une vision complète de chaque détail de votre projet, il leur permet de vous aider à créer et modifier des chansons avec plus de rapidité et de liberté créative. [Le protocole de contexte de Modèle](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) est une norme ouverte qui permet aux assistants d’IA de se connecter de manière transparente à des applications et sources de données externes. Le serveur MCP ACE Studio implémente ce protocole afin de donner aux agents d’IA un accès direct à votre espace de travail créatif. ### Démarrage rapide #### Lancer le serveur MCP ACE Studio 1. Ouvrir **ACE Studio**. 2. Accédez à **Préférences → Général → Serveur MCP**. 3. Choisissez un mode de Transport : **HTTP** ou **STDIO**. > Le mode de Transport sélectionné ici détermine comment votre client d’IA se connecte à ACE Studio. Consultez les sections ci-dessous pour obtenir des détails et une configuration spécifique au client. Choisissez la configuration appropriée selon le mode de Transport sélectionné et votre client d’IA. #### Mode HTTP diffusible En mode HTTP, ACE Studio exécute un serveur MCP local à une adresse fixe. Votre client d’IA s’y connecte via le réseau. **Adresse du serveur :** `http://localhost:21572/mcp` > **Note technique** : le serveur MCP ACE Studio utilise le **protocole de Transport HTTP diffusible**. Conservez cette adresse pour l’étape de configuration suivante. **Claude Desktop** > ⚠ La configuration du serveur MCP ACE Studio 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 conviviaux. **Étapes de configuration :** 1. Installez Node.js si nécessaire. * Accédez à [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 établie avec succès. **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 configurez-le manuellement : 1. Ouvrez les Paramètres de Cursor. 2. Recherchez la section **Outils et MCP** . 3. Cliquez **Nouveau serveur MCP**. 4. Renseignez le JSON suivant : ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Cliquez **Enregistrer**. 6. Redémarrez Cursor. **Vérifier la connexion :**\ Saisissez dans le chat Cursor : ``` @acestudio Quelles Pistes se trouvent dans le Projet actuel ? ``` **VS Code via la prise en charge MCP native** 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 configurez-le manuellement : 1. Créez ou modifiez `.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. Recherchez la section de configuration des serveurs MCP. 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 diffusible. Certains clients peuvent l’appeler `Distant`. * **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 d’IA lance le serveur MCP ACE Studio et communique directement avec lui via l’entrée et la sortie standard. Ce mode est plus simple à configurer. Vous n’avez pas besoin de démarrer manuellement un serveur ni d’utiliser une adresse réseau. **Obtention de la commande :** 1. Dans ACE Studio, accédez à **Préférences → Général → Serveur MCP**. 2. Réglez le mode sur **STDIO**. 3. Cliquez **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 tels que `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 établie avec succès. **Cursor** 1. Ouvrez les Paramètres de Cursor. 2. Recherchez la section **Outils et MCP** . 3. Cliquez **Nouveau serveur MCP**. 4. Renseignez le JSON suivant : ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Cliquez **Enregistrer**. 6. Redémarrez Cursor. **Vérifier la connexion :**\ Saisissez dans le chat Cursor : ``` @acestudio Quelles Pistes se trouvent dans le Projet actuel ? ``` **VS Code via la prise en charge MCP native** 1. Créez ou modifiez `.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. Recherchez la section de configuration des serveurs MCP. 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 d’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 de violon ``` #### Générer des Paroles et une mélodie ``` En vous basant 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 vive, en utilisant une Gamme pentatonique ``` #### Modifier le MIDI ``` Dans ACE Studio, ajoutez une progression d’Accord au Piano aux Mesures 9 à 16 : C - Am - F - G, chaque Accord durant 2 Mesures ``` --- # 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/outils-dia/ace-studio-mcp-server.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.