> 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/aijento/external-agent-access.md). # 外部エージェントアクセス MCPおよびCLIを通じてACE StudioをAIアシスタントやエージェントに接続します。 {% hint style="warning" %} #### 実験的ステータス ACE Studio における外部エージェントアクセスは現在実験段階であり、継続的に開発中です。 **ご注意ください：** * **破壊的変更：** ツールコマンド、フォーマット、および規約は、アップデート間で変更される場合があります。 * **開発途中：** ACE Studio のすべての機能が、まだエージェントから完全に利用できるわけではありません。 * **仕上げが粗い部分：** エージェントとの連携を調整する過程で、バグ、想定外のエッジケース、または不自然な挙動に遭遇する場合があります。 問題が発生した場合やご提案がありましたら、以下までお知らせください： [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Claude、ChatGPT、OpenClaw、Hermes Agent などの AI アシスタントやエージェントを ACE Studio に直接接続し、音楽プロジェクトをリアルタイムで把握・編集できます。 ### エージェントでできること 接続すると、エージェントは ACE Studio のほとんどの操作範囲にわたってプロジェクトを確認・編集できます： * **アレンジメントと作曲** — トラック、クリップ、ノート、歌詞、コード、再生ヘッドを管理できます。 * **ボーカルと楽器** — 音声モデル、音源、マルチシンガーの合唱レイヤー、ボーカルパラメータ（ピッチ、呼吸音、テンション）を調整し、サードパーティ製の楽器プラグインを読み込めます。 * **タイミングと構成** — BPM、拍子記号、ループマーカー、トランスポートを設定できます。 * **制作と AIツール** — レイヤーを追加、ボーカルをMIDIに変換、ステムスプリッター、ミュージックエンハンサーを実行し、FXチェーンやプリセットを読み込めます。 * **セッション管理と出力** — プロジェクトを新規作成して保存し、オーディオと MIDI をインポートし、フルミックスダウン、個別のステム、動画などを書き出せます。 やりたいことを自然な言葉で伝えるだけで、アシスタントがプロジェクトを確認し、変更を加えます。 *** ### アシスタントの接続 ワークフローに合ったセットアップ方法を選んでください： #### 方法 A：AI エージェントに設定させる ローカル環境やコンピュータへのアクセス権を持つエージェント（たとえば **Claude Code**, **Codex**, **OpenClaw**、または **Hermes Agent**）を使用している場合、自動で設定できます。 {% hint style="info" %} この方法では、ACE Studio と同じコンピュータ上で動作し、コマンドの実行と設定ファイルの編集権限を持つエージェントが必要です。 {% endhint %} 最も簡単なのは ACE Studio 内から行う方法です。ウィンドウ右下の **エージェントアイコン** をクリックし、 **ChatGPT**, **Claude**、または **その他のエージェント**を選び、表示される 3 つの手順に従ってください。エージェントを開き、接続プロンプトを **コピー** ボタンでコピーして送信し、続いて例示プロンプトのいずれかで作成を始めます。 同じ接続プロンプトを下に示します。コピーしてエージェントに貼り付け、Send を押してください： ``` acestudio-cli または MCP を使って、私のために ACE Studio に接続してください。 既定の場所： - macOS MCP: "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" - macOS CLI: "/Applications/ACE Studio.app/Contents/Helpers/acestudio-cli" - Windows MCP: "C:\Program Files\ACE Studio\ace-mcp-server.exe" - Windows CLI: "C:\Program Files\ACE Studio\acestudio-cli.exe" まず CLI を試し、ツールのパスを指示/メモリに記憶してください。CLI アクセスがサンドボックスや権限で制限されている場合は、MCP サーバーを（ユーザー/グローバル スコープで "ace-studio" という名前で）登録してください。既定の場所に見つからない場合は、ACE Studio の設定 → 一般 → 外部エージェントアクセスにあるパスを私に尋ねてください。 次に、ACE Studio の公式リポジトリ https://github.com/BeatMagic/acestudio_agent_plugin から skills/agent プラグインをインストールしてください。これは、ACE Studio とやり取りする際に必要なノウハウを提供するため、インストールして利用可能にしておくことが重要です。 ACE Studio とそのエージェント統合についてさらに詳しい情報が必要な場合は、https://docs.acestudio.ai/llms.txt のドキュメントを参照してください。ハーネスが自動設定できない、またはローカル コマンドを実行できない場合は、あなたのプラットフォーム向けの手動セットアップ手順を案内してください。 ``` *** #### パス B: ハーネスで手動設定する エージェント ハーネスが自動で設定できない場合は、ACE Studio の MCP サーバーを構成に手動で追加する必要があります。 [モデル・コンテキスト・プロトコル (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) は、AI アシスタントを外部アプリケーションに接続するためのオープン標準です。ACE Studio はローカル STDIO サーバーとして動作し、起動コマンドを使用して任意の MCP 対応クライアントが直接接続できます。 **ターミナルから設定** Claude または Codex を使っていて、ターミナルから直接設定したい場合は: {% tabs %} {% tab title="Claude" %} ターミナルで実行: **macOS:** ```bash claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows:** ```cmd claude mcp add --scope user ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe" ``` {% endtab %} {% tab title="Codex" %} ターミナルで実行: **macOS:** ```bash codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows:** ```cmd codex mcp add ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe" ``` {% endtab %} {% endtabs %} **デスクトップチャットアプリ** 設定手順を順を追って確認できる完全ガイドについては: * [**Claude Desktop & Cowork**](/docs/product-wiki-ja/aijento/external-agent-access/claude-desktop-and-cowork.md) — 設定ファイルの手順を含む、Claude Desktop のステップごとの設定。 * [**デスクトップ版 ChatGPT**](/docs/product-wiki-ja/aijento/external-agent-access/chatgpt-for-desktop.md) — ChatGPT Work と Codex モードのステップごとのセットアップ。 **その他のハーネスと IDE（VS Code、Cursor、カスタム クライアント）** ほとんどの MCP クライアントと IDE は、同じ構成パラメータを求めます: * **トランスポートの種類:** STDIO（場合によっては「Local」または「Command」と表示されます） * **コマンド:** ACE Studio からコピーした起動コマンド * **引数 / 環境:** なし JSON ファイルで構成するハーネスの場合: {% tabs %} {% tab title="標準 MCP 構成（Cursor など）" %} Cursor で使用（`~/.cursor/mcp.json` または `.cursor/mcp.json`）およびほとんどの標準 MCP ハーネスで使用されます: ```json { "mcpServers": { "ace-studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% tab title="VS Code（GitHub Copilot）" %} 追加先 `.vscode/mcp.json` プロジェクト ワークスペースに: ```json { "servers": { "ace-studio": { "type": "stdio", "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% endtabs %} {% hint style="info" %} **JSON における Windows パスのエスケープ:** JSON ファイルに Windows パスをバックスラッシュで手動記述する場合は、各バックスラッシュをダブルバックスラッシュ（`\\`）、またはフォワードスラッシュ（`/`). {% endhint %} {% hint style="warning" %} **ブラウザー上のAIアシスタント:**\ ACE Studio の MCP サーバーは、STDIO 経由でお使いのマシン上でローカルに動作します。Web専用のインターフェース（ChatGPT や Web ブラウザー上の Claude など）は、ローカルの STDIO サーバーに直接接続できません。代わりに、それぞれのデスクトップアプリまたはターミナルクライアントを使用してください。 {% endhint %} {% hint style="info" %} **カスタムインストールパス:** ACE Studio をカスタムディレクトリにインストールした場合は、 **設定 → 一般 → 外部エージェントアクセス** ACE Studio で: * クリック **コマンドをコピー** 横に **MCP サーバー (stdio)** MCP サーバーのパス用。 * クリック **コピー** 横に **acestudio-cli バイナリのパス** CLI パス用。 {% endhint %} *** ### 接続の確認 ACE Studio が開いて実行中であることを確認し、次にアシスタントに次のように依頼してください: ``` 現在の ACE Studio プロジェクト情報を確認してください ``` アシスタントがプロジェクトのテンポ、調号、トラック一覧を返せば、セットアップは完了し、使用準備が整っています。 *** ### クリエイティブなプロンプト例 ACE StudioでAIアシスタントと連携する実践的な例をいくつかご紹介します： #### 1. ボーカル制作と複数シンガーによるハーモニー ``` リードボーカルトラック（トラック1）で合唱モードをオンにし、バックシンガーを2人追加 ボイスのステレオスプレッドを広げ、豊かなバックグラウンドハーモニーになるようレベルを-3 dB下げます。 ``` #### 2. カスタムボイスブレンディング ``` トラック2にカスタムブレンドボイスを作成します：温かみのあるアコースティックポップのシードを70%ミックスし エアリーでブレシーなシンガーシードを30%加え、ブレンドに「ベルベット ブレシネス」と名前を付けます。 ``` #### 3. コードとソングの下書き作成 ``` コードトラックの小節1～8に、ネオソウルの進行を挿入します： Ebmaj9 — G7#9 — Cm9 — F13（各2小節）。 次に、ルート音に沿ったグルーヴィーなベースラインを持つRhodesピアノトラックを追加します。 ``` #### 4. AI伴奏＆オーディオ抽出 ``` トラックを選択一で分割し、トラック 1上の読み込んだオーディオクリップをボーカル、ドラム、ベース、その他のステムに分離します。 次に、抽出したボーカルステムにボーカル to MIDIを実行して、編集可能なSingトラックを作成します。 ``` #### 5. 生成ソングアイデア＆レイヤー ``` 小節9から25までのアレンジを聴き、レイヤーを追加を使用して生成します 現在のプロジェクトテンポに合った、シネマティックなストリングパッドの伴奏レイヤーを。 ``` #### 6. 表現力豊かなボーカルチューニング＆ダイナミクス ``` トラック 1のコーラスボーカル音符を確認します。ピッチ遷移を滑らかにし、 出だしの音符のブレッシネスを上げ、持続音符に控えめなビブラートカーブを追加します。 ``` #### 7. FXチェーンとステム納品 ``` リードボーカルのFXチェーンにヴィンテージのボーカルコンプレッサーと温かみのあるプレートリバーブを読み込み、 その後、すべての個別トラックを24-bit 48kHz WAVステムとして、デスクトップ上の「ステム」フォルダに書き出します。 ``` --- # 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/aijento/external-agent-access.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.