# Serveur MCP d’ACE Studio

{% hint style="warning" %}

### Statut expérimental

Le serveur MCP d'ACE Studio est actuellement en **phase expérimentale**.

**Veuillez noter :**

* Certaines fonctionnalités et options peuvent ne pas être entièrement implémentées
* Les fonctionnalités et le comportement peuvent évoluer
* Vous pouvez rencontrer des bugs ou des problèmes de performance lors de l'utilisation
* Les consignes d'utilisation et les limites de taux seront publiées lorsque la version stable sera publiée

Nous améliorons activement cette fonctionnalité. Si vous avez des retours ou rencontrez des problèmes, veuillez nous contacter à [**support@acestudio.ai**](mailto:support@acestudio.ai).
{% endhint %}

Le serveur MCP d'ACE Studio propose une boîte à outils complète permettant aux agents IA de naviguer et d'exécuter des modifications créatives de manière autonome. En donnant aux agents IA une vision détaillée de chaque élément de votre projet, il leur permet de vous assister dans la création et l'édition de chansons plus rapidement et avec davantage de liberté créative.

[Le Model Context Protocol ](https://modelcontextprotocol.io/docs/getting-started/intro)(MCP) est une norme ouverte qui permet aux assistants IA de se connecter de façon transparente à des applications et sources de données externes. Le serveur MCP d'ACE Studio implémente ce protocole pour donner aux agents IA un accès direct à votre espace de travail créatif.

## Démarrage rapide

### Lancer le serveur MCP d'ACE Studio

1. Ouvrez le **ACE Studio 2.0**
2. Dans les préférences, cochez **General → MCP Server**

**Adresse du serveur :** `http://localhost:21572/mcp`

> **Remarque technique** : Le serveur MCP d'ACE Studio utilise le **protocole de transport Streamable HTTP**. Conservez cette adresse pour l'étape de configuration suivante.

### Connecter le serveur MCP à votre client IA

Choisissez la méthode de configuration appropriée selon votre client IA :

#### **Claude Desktop**

> ⚠ La configuration du serveur MCP d'ACE Studio dans Claude Desktop nécessite la modification d'un fichier JSON de configuration. Si vous n'êtes pas à l'aise avec la configuration technique, nous recommandons d'essayer des clients plus conviviaux.

**Étapes de configuration :**

1. Installer Node.js (si non déjà installé)
   * Visitez [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. Éditez 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 :**\
Tapez 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 configurez manuellement :

1. Ouvrez les paramètres de Cursor
2. Trouvez la section "Tools & MCP"
3. Cliquez sur "New MCP Server"
4. Remplissez le JSON suivant :

   ```json
   {
     "mcpServers": {
       "ACE-Studio": {
         "url": "http://localhost:21572/mcp",
         "headers": {}
       }
     }
   }
   ```
5. Cliquez sur "Save"
6. Redémarrez Cursor

**Vérifier la connexion :**\
Tapez dans Cursor Chat :

```
@acestudio Quelles pistes sont dans le projet actuel ?
```

***

#### **VS Code (via prise en charge Native 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 configurez manuellement :

1. Installez l'extension Cline ou Roo Cline
2. Ouvrez les paramètres de l'extension
3. Trouvez la section de configuration MCP Servers
4. Ajoutez un nouveau serveur :

   ```json
   "mcp": {
       "servers": {
           "ACE-Studio": {
               "type": "http",
               "url": "http://localhost:21572/mcp",
               "headers": {}
           }
       }
   }
   ```

***

#### **VS Code (via Cline / Roo Code)**

1. Installez l'extension Cline ou Roo Code
2. Ouvrez les paramètres de l'extension
3. Trouvez la section de configuration MCP Servers
4. Ajoutez un nouveau serveur :

{% tabs %}
{% tab title="Cline" %}

```json
{
  "mcpServers": {
    "ACE-Studio": {
      "url": "http://localhost:21572/mcp",
      "type": "streamableHttp",
      "headers": {}
    }
  }
}
```

{% endtab %}

{% tab title="Roo Code" %}

```json
{
  "mcpServers": {
    "ACE-Studio": {
      "url": "http://localhost:21572/mcp",
      "type": "streamable-http",
      "headers": {}
    }
  }
}
```

{% endtab %}
{% endtabs %}

***

#### **Autres clients / chatbot IA**

Pour la plupart des client&#x73;**,** utilisez ces paramètres de configuration :

* **Type de transport :** Streamable HTTP (certains clients peuvent appeler cela "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": {}
    }
  }
}
```

{% hint style="info" %}
Remarque : ACE Studio exige le transport Streamable HTTP et ne prend pas en charge le protocole HTTP + SSE hérité ni la version MCP 2024-11-05.
{% endhint %}

## 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 pop à BPM 120 dans ACE Studio, 
en do majeur, ajoutez une piste vocale principale et une piste d'accompagnement violon
```

#### Générer paroles et 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 vive, utilisant une gamme pentatonique
```

#### Éditer le MIDI

<pre><code><strong>Dans ACE Studio, ajoutez une progression d'accords au piano dans les mesures 9-16 :
</strong>C - Am - F - G, chaque accord durant 2 mesures
</code></pre>
