# ACE Studio MCP Server

{% hint style="warning" %}

### 実験的ステータス

ACE Studio MCP Serverは現在、 **実験段階です**.

**ご注意：**

* 一部の機能や設定はまだ完全に実装されていない可能性があります
* 機能や挙動は変更される場合があります
* 利用中にバグやパフォーマンスの問題が発生する可能性があります
* 使用ガイドラインやレート制限は安定版リリース時に公表されます

この機能は積極的に改善中です。フィードバックや問題がある場合は、以下までご連絡ください： [**support@acestudio.ai**](mailto:support@acestudio.ai).
{% endhint %}

ACE Studio MCPサーバーは、AIエージェントが自律的にクリエイティブな編集を実行できる豊富なツールキットを提供します。AIエージェントにプロジェクトのあらゆる詳細への包括的なインサイトを与えることで、楽曲の作成や編集をより迅速かつ創造的に支援できるようになります。

[Model Context Protocol ](https://modelcontextprotocol.io/docs/getting-started/intro)(MCP)は、AIアシスタントが外部アプリケーションやデータソースとシームレスに接続できるようにするオープン標準です。ACE Studio MCPサーバーはこのプロトコルを実装し、AIエージェントにあなたのクリエイティブワークスペースへの直接アクセスを提供します。

## クイックスタート

### ACE Studio MCP Serverを起動する

1. を開いてください **ACE Studio 2.0**
2. 設定（Preferences）から、次を確認してください： **General → MCP Server**

**サーバーアドレス：** `http://localhost:21572/mcp`

> **技術的注意事項**：ACE Studio MCP Serverは **Streamable HTTP transport protocol**を使用します。次の設定ステップのためにこのアドレスを控えてください。

### MCP ServerをAIクライアントに接続する

お使いのAIクライアントに応じて適切な設定方法を選んでください：

#### **Claude Desktop**

> ⚠ Claude DesktopでACE Studio MCP Serverを設定するにはJSON設定ファイルの編集が必要です。技術的な設定に不慣れな場合は、よりユーザーフレンドリーなクライアントの利用を推奨します。

**設定手順：**

1. Node.jsをインストールする（未インストールの場合）
   * 次のサイトにアクセスしてください： [nodejs.org](https://nodejs.org) LTS版をダウンロードしてください
2. Claude Desktopの設定ファイルを見つける
   * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
3. 設定ファイルを編集し、以下を追加します：

```json
{
    "mcpServers": {
        "acestudio": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://localhost:21572/mcp"
            ]
        }
    }
}
```

4. ファイルを保存してClaude Desktopを再起動してください

**接続を確認する：**\
Claudeで次を入力してください：

```
現在のACE Studioプロジェクト情報を確認してください
```

Claudeがプロジェクト情報を返せば、接続は成功です！

***

#### **Cursor**

ここをクリックしてMCPサーバーをCursorに直接追加できます [ここ](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9).

または手動で設定：

1. Cursorの設定を開く
2. "Tools & MCP"セクションを探す
3. "New MCP Server"をクリック
4. 次のJSONを入力してください：

   ```json
   {
     "mcpServers": {
       "ACE-Studio": {
         "url": "http://localhost:21572/mcp",
         "headers": {}
       }
     }
   }
   ```
5. "Save"をクリック
6. Cursorを再起動してください

**接続を確認する：**\
Cursor Chatで入力：

```
@acestudio 現在のプロジェクトにはどのトラックが含まれていますか？
```

***

#### **VS Code（ネイティブMCPサポート経由）**

ここをクリックしてMCPサーバーをVS Codeに直接追加できます [ここ](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).

または手動で設定：

1. ClineまたはRoo Cline拡張をインストールする
2. 拡張機能の設定を開く
3. MCP Serversの設定セクションを探す
4. 新しいサーバーを追加：

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

***

#### **VS Code（Cline / Roo Code経由）**

1. ClineまたはRoo Code拡張をインストールする
2. 拡張機能の設定を開く
3. MCP Serversの設定セクションを探す
4. 新しいサーバーを追加：

{% 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 %}

***

#### **その他のクライアント / AIチャットボット**

ほとんどのクライアントでは、**,** 次の設定を使用してください：

* **トランスポートタイプ：** Streamable HTTP（クライアントによっては"Remote"と呼ぶ場合があります）
* **サーバーURL：** `http://localhost:21572/mcp`

または次のJSONをインポートしてMCPサーバーを追加してください：

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

{% hint style="info" %}
注：ACE Studioはstreamable HTTPトランスポートを要求し、従来のHTTP + SSEプロトコルやMCPバージョン2024-11-05はサポートしていません。
{% endhint %}

## 使用例

接続後、以下のプロンプトを試してAIアシスタントと共同作業できます：

#### 新規プロジェクトを作成する

```
ACE StudioでBPM120のポップ系の新規プロジェクトを作成してください、 
ハ長調で、リードボーカルトラックとバイオリンの伴奏トラックを追加してください
```

#### 歌詞とメロディを生成する

```
テーマ「海辺の夏の思い出」に基づき、 
ACE Studioで8小節のサビセクションを書いてください。 
メロディは軽やかで活発なものとし、ペンタトニックスケールを使用してください
```

#### MIDIを編集する

<pre><code><strong>ACE Studioで、9〜16小節にピアノのコード進行を追加してください：
</strong>C - Am - F - G、各コードは2小節ずつ持続します
</code></pre>