# ACE Studio MCPサーバー ## 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. 移動 **設定 → General → MCP Server**. 3. トランスポートモードを選択してください： **HTTP** または **STDIO**. > ここで選択したトランスポートモードによって、AIクライアントがACE Studioに接続する方法が決まります。詳細とクライアント固有の設定については、以下のセクションを参照してください。 選択したトランスポートモードとAIクライアントに基づいて、適切な設定を選んでください。 #### Streamable HTTPモード HTTPモードでは、ACE Studioは固定アドレスでローカルMCPサーバーを実行します。AIクライアントはネットワーク経由でそれに接続します。 **サーバーアドレス：** `http://localhost:21572/mcp` > **技術メモ**：ACE Studio MCPサーバーは **Streamable 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. 次を探します **Tools & MCP** セクション。 3. クリック **New MCP Server**. 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 Servers設定セクションを探します。 4. 新しいサーバーを追加します： ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **その他のクライアント** ほとんどのクライアントでは、以下の設定を使用してください： * **トランスポートタイプ：** Streamable HTTP。一部のクライアントでは、これを `Remote`. * **サーバー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で、次に移動します **設定 → General → MCP Server**. 2. モードを次に設定します **STDIO**. 3. クリック **Copy Command** をクリックして、サーバーコマンドをクリップボードにコピーします。 コピーされたコマンドは次のようになります： ``` "/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. 次を探します **Tools & MCP** セクション。 3. クリック **New MCP Server**. 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 Servers設定セクションを探します。 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: 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-ja/aitsru/ace-studio-mcpsb.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.