> 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サーバー ## 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 Server**. 3. トランスポートモードを選択してください： **HTTP** または **STDIO**. > ここで選択したトランスポートモードによって、AI クライアントが ACE Studio にどのように接続するかが決まります。詳細とクライアント固有の設定については、以下の各セクションを参照してください。 選択したトランスポートモードと AI クライアントに応じて、適切な設定を選択してください。 #### ストリーミング可能な 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** 次をクリックすると、Cursor に MCP サーバーを直接追加できます [こちら](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). または、手動で設定します： 1. Cursor の設定を開きます。 2. 次を見つけてください： **Tools & MCP** セクション。 3. クリック **新しい MCP サーバー**. 4. 次の JSON を入力します： ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. クリック **保存**. 6. Cursor を再起動します。 **接続を確認：**\ Cursor Chat で次を入力してください： ``` @acestudio 現在のプロジェクトにはどのトラックがありますか？ ``` **ネイティブ MCP サポートを使った VS Code** 次をクリックすると、VS Code に MCP サーバーを直接追加できます [こちら](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。一部のクライアントではこれを `リモート`. * **サーバー 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 Server**. 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. 次を見つけてください： **Tools & 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 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 の新規ポップスタイルプロジェクトを作成するのを手伝ってください、 Cメジャーで、リードボーカルトラックとバイオリン伴奏トラックを追加してください ``` #### 歌詞とメロディを生成 ``` テーマ「海辺で過ごした夏の思い出」をもとに、 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.