> 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-ja/aitsru/ace-studio-mcp-server.md). # ACE Studio MCP Server ## ACE Studio MCPサーバー {% hint style="warning" %} #### 実験的ステータス ACE Studio MCPサーバーは現在 **実験段階です**. **ご注意：** * 一部の機能および設定は、まだ完全に実装されていない場合があります * 機能および機能性は変更される場合があります * 使用中にバグやパフォーマンス上の問題が発生する場合があります * 利用ガイドラインおよびレート制限は、安定版のリリース時に公開されます この機能は現在積極的に改善しています。フィードバックや問題がございましたら、こちらまでご連絡ください： [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} ACE Studio MCPサーバーは、AIエージェントが自律的に操作し、クリエイティブな編集を実行できる豊富なツールキットを提供します。AIエージェントにプロジェクトのあらゆる詳細への包括的なアクセスを与えることで、より迅速かつ自由な創作で楽曲の制作・編集を支援します。 [モデルコンテキストプロトコル](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) は、AIアシスタントが外部アプリケーションやデータソースとシームレスに接続できるようにするオープンスタンダードです。ACE Studio MCPサーバーはこのプロトコルを実装し、AIエージェントにクリエイティブワークスペースへの直接アクセスを提供します。 ### クイックスタート #### ACE Studio MCPサーバーを起動する 1. 開く **ACE Studio**. 2. 移動先 **設定 → 一般 → MCPサーバー**. 3. トランスポートモードを選択： **HTTP** または **STDIO**. > ここで選択するトランスポートモードにより、AIクライアントがACE Studioに接続する方法が決まります。詳細およびクライアント固有の設定については、以下のセクションを参照してください。 選択したトランスポートモードとAIクライアントに応じて、適切な設定を選択してください。 #### ストリーミング対応HTTPモード HTTPモードでは、ACE Studioが固定アドレスでローカルMCPサーバーを実行します。AIクライアントはネットワーク経由で接続します。 **サーバーアドレス：** `http://localhost:21572/mcp` > **技術メモ**：ACE Studio MCPサーバーは、 **ストリーミング対応HTTPトランスポートプロトコル**を使用します。次の設定手順のために、このアドレスを控えておいてください。 **Claude Desktop** > ⚠ Claude DesktopでACE Studio MCPサーバーを設定するには、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. 次の項目を見つけます **ツールとMCP** セクション。 3. クリック **新しいMCPサーバー**. 4. 以下のJSONを入力します： ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. クリック **保存**. 6. Cursorを再起動します。 **接続を確認：**\ Cursor Chatで入力： ``` @acestudio 現在のプロジェクトにはどのようなトラックがありますか？ ``` **ネイティブMCPサポート経由のVS Code** クリックするだけで、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. 作成または編集する `.vscode/mcp.json` ワークスペース内で。 2. 以下の設定を追加します： ```json { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp" } } } ``` **Cline経由のVS Code** 1. Cline拡張機能をインストールします。 2. 拡張機能の設定を開きます。 3. MCPサーバー設定セクションを見つけます。 4. 新しいサーバーを追加します： ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **その他のクライアント** ほとんどのクライアントでは、以下の設定を使用します： * **トランスポートタイプ：** ストリーミング対応HTTP。一部のクライアントではこれを `リモート`. * **サーバーURL：** `http://localhost:21572/mcp` または、以下のJSONでMCPサーバーをインポートします： ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` #### STDIOモード STDIOモードでは、AIクライアントが標準入力・出力を介してACE Studio MCPサーバーを直接起動し、通信します。こちらの方が設定は簡単です。サーバーを手動で起動したり、ネットワークアドレスを使用したりする必要はありません。 **コマンドの取得：** 1. ACE Studioで、次へ移動します **設定 → 一般 → MCPサーバー**. 2. モードを次に設定します **STDIO**. 3. クリック **コマンドをコピー** をクリックして、サーバーコマンドをクリップボードにコピーします。 コピーされたコマンドは次のようになります： ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` 以下の設定手順でこのコマンドを使用します。 {% hint style="info" %} コマンドパスはOSによって異なります。以下の各クライアント設定では、ACE Studioからコピーしたコマンドをそのまま使用してください。 {% endhint %} **Claude Desktop** STDIOはClaude Desktopのネイティブトランスポートです。次のような追加ツールは不要です `mcp-remote`. 1. Claude Desktopの設定ファイルを見つけます。 * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 2. 設定ファイルを編集し、以下を追加します： ```json { "mcpServers": { "acestudio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 3. ファイルを保存し、Claude Desktopを再起動します。 **接続を確認：**\ Claudeで入力： ``` 現在のACE Studioプロジェクト情報を確認してください ``` Claudeがプロジェクトの詳細を返した場合、接続は成功です。 **Cursor** 1. Cursorの設定を開きます。 2. 次の項目を見つけます **ツールとMCP** セクション。 3. クリック **新しいMCPサーバー**. 4. 以下のJSONを入力します： ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. クリック **保存**. 6. Cursorを再起動します。 **接続を確認：**\ Cursor Chatで入力： ``` @acestudio 現在のプロジェクトにはどのようなトラックがありますか？ ``` **ネイティブMCPサポート経由のVS Code** 1. 作成または編集する `.vscode/mcp.json` ワークスペース内で。 2. 以下の設定を追加します： ```json { "servers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **Cline経由のVS Code** 1. Cline拡張機能をインストールします。 2. 拡張機能の設定を開きます。 3. MCPサーバー設定セクションを見つけます。 4. 新しいサーバーを追加します： ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **その他のクライアント** ほとんどのクライアントでは、以下の設定を使用します： * **トランスポートタイプ：** STDIO * **コマンド：** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server` * **引数：** `--stdio` または、以下のJSONでMCPサーバーをインポートします： ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` ### 使用例 接続後は、以下のプロンプトを試してAIアシスタントと共同作業できます： #### 新規プロジェクトを作成 ``` ACE StudioでBPM 120の新しいポップスタイルのプロジェクトを作成してください、 ハ長調で、リードボーカルトラックとバイオリン伴奏トラックを追加してください ``` #### 歌詞とメロディを生成 ``` 「海辺の夏の思い出」というテーマに基づいて、 ACE Studioで8小節のコーラスセクションを書いてください。 メロディはペンタトニック音階を使用し、軽快で生き生きとしたものにしてください ``` #### MIDIを編集 ``` ACE Studioで、小節9〜16にピアノのコード進行を追加してください： C - Am - F - G、各コードは2小節ずつ ``` --- # 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-ja/aitsru/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.