> 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-es/agente-de-ia/external-agent-access.md). # Acceso de agentes externos Conecta ACE Studio con asistentes y agentes de IA a través de MCP y CLI. {% hint style="warning" %} #### Estado experimental El acceso de agentes externos en ACE Studio es actualmente experimental y está en desarrollo activo. **Ten en cuenta:** * **Cambios incompatibles:** Los comandos de herramientas, formatos y convenciones pueden cambiar entre actualizaciones. * **En desarrollo:** Todavía no todas las funciones de ACE Studio son totalmente accesibles para los agentes. * **Aspectos por pulir:** Es posible que encuentres errores, casos límite inesperados o comportamientos poco naturales mientras refinamos las interacciones de los agentes. Si encuentras problemas o tienes sugerencias, escríbenos a [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Conecta asistentes y agentes de IA (como Claude, ChatGPT, OpenClaw o Hermes Agent) directamente a ACE Studio para comprender y editar tus proyectos musicales en tiempo real. ### Lo que puede hacer tu agente Una vez conectado, un agente puede inspeccionar y editar tu proyecto en casi todo lo que hace ACE Studio: * **Arreglo y composición** — Gestiona pistas, clips, notas, letras, acordes y el cabezal de reproducción. * **Voces e Instrumentos** — Ajusta Voces de síntesis vocal, fuentes de sonido, capas de coro con varios cantantes y Parámetros vocales (pitch, Respiración, Tensión), y carga complementos de Instrumento de terceros. * **Tiempo y estructura** — Establece BPM, compases, marcadores de bucle y Transporte. * **Producción y Herramientas de IA** — Activa Agregar una capa, Vocal a MIDI, Separador de pistas, Mejorador de música y carga cadenas de FX o preajustes. * **Control de sesión y entrega** — Inicia y guarda proyectos, importa audio y MIDI, y exporta mezclas completas, Pistas individuales, video y más. Solo describe lo que quieres en lenguaje natural, y tu asistente inspeccionará el proyecto y hará los cambios. *** ### Conectar tu asistente Elige el método de configuración que mejor se adapte a tu flujo de trabajo: #### Ruta A: deja que tu agente de IA lo configure por ti Si usas un agente con acceso al entorno local o al ordenador (como **Claude Code**, **Codex**, **OpenClaw**o **Hermes Agent**), puede configurarse automáticamente. {% hint style="info" %} Esta ruta requiere un agente que se ejecute en el mismo ordenador que ACE Studio, con permisos para ejecutar comandos y editar sus archivos de configuración. {% endhint %} La forma más rápida es desde dentro de ACE Studio. Haz clic en el **icono del agente** en la esquina inferior derecha de la ventana, elige **ChatGPT**, **Claude**o **Otros agentes**y sigue los tres pasos que se muestran: abre tu agente, copia el mensaje de conexión con el botón **Copiar** y envíalo; después, empieza a crear con uno de los mensajes de ejemplo. El mismo mensaje de conexión se reproduce aquí. Cópialo y pégalo en tu agente y pulsa Enviar: ``` Conéctate a ACE Studio por mí usando acestudio-cli o MCP. Ubicaciones predeterminadas: - macOS MCP: "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" - macOS CLI: "/Applications/ACE Studio.app/Contents/Helpers/acestudio-cli" - MCP de Windows: "C:\Program Files\ACE Studio\ace-mcp-server.exe" - CLI de Windows: "C:\Program Files\ACE Studio\acestudio-cli.exe" Prueba primero usando la CLI y recuerda la ruta de la herramienta en tus instrucciones/memoria. Si el acceso a la CLI está restringido por el sandbox o los permisos, registra el servidor MCP (con el nombre "ace-studio" en el ámbito de usuario/global). Si no se encuentra en la ubicación predeterminada, pídeme la ruta desde Preferencias → General → Acceso de agente externo de ACE Studio. Después, instala el plugin de habilidades/agente desde el repositorio oficial de ACE Studio en https://github.com/BeatMagic/acestudio_agent_plugin. Es importante tenerlo instalado y disponible, ya que proporciona el conocimiento que necesitarás al interactuar con ACE Studio. Si necesitas más contexto sobre ACE Studio y su integración de agente, consulta la documentación en https://docs.acestudio.ai/llms.txt. Si tu entorno no puede configurarse por sí mismo ni ejecutar comandos locales, guíame por los pasos de configuración manual para tu plataforma. ``` *** #### Ruta B: Configúralo manualmente en tu entorno Si tu entorno de agente no puede configurarse automáticamente, tendrás que añadir manualmente el servidor MCP de ACE Studio a su configuración. [El Protocolo de Contexto de Modelo (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) es un estándar abierto que conecta asistentes de IA con aplicaciones externas. ACE Studio se ejecuta como un servidor local STDIO, lo que permite que cualquier cliente compatible con MCP se conecte directamente usando el comando de lanzamiento. **Configurar desde la terminal** Si usas Claude o Codex y prefieres configurar directamente desde la terminal: {% tabs %} {% tab title="Claude" %} Ejecuta en tu terminal: **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" %} Ejecuta en tu terminal: **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 %} **Aplicaciones de chat de escritorio** Para guías completas paso a paso con recorridos de configuración: * [**Claude Desktop y Cowork**](/docs/product-wiki-es/agente-de-ia/external-agent-access/claude-desktop-and-cowork.md) — Configuración paso a paso para Claude Desktop con recorrido por el archivo de configuración. * [**ChatGPT para escritorio**](/docs/product-wiki-es/agente-de-ia/external-agent-access/chatgpt-for-desktop.md) — Configuración paso a paso para los modos Work y Codex de ChatGPT. **Otros entornos e IDEs (VS Code, Cursor, clientes personalizados)** La mayoría de los clientes MCP y los IDEs solicitan los mismos Parámetros de configuración: * **Tipo de Transporte:** STDIO (a veces etiquetado como "Local" o "Comando") * **Comando:** El comando de inicio copiado desde ACE Studio * **Argumentos / Entorno:** Ninguno Para entornos configurados mediante archivos JSON: {% tabs %} {% tab title="Configuración estándar de MCP (Cursor, etc.)" %} Usado por Cursor (`~/.cursor/mcp.json` o `.cursor/mcp.json`) y la mayoría de los entornos MCP estándar: ```json { "mcpServers": { "ace-studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% tab title="VS Code (GitHub Copilot)" %} Añádelo a `.vscode/mcp.json` en el espacio de trabajo de tu Proyecto: ```json { "servers": { "ace-studio": { "type": "stdio", "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% endtabs %} {% hint style="info" %} **Escapado de rutas de Windows en JSON:** Si escribes manualmente rutas de Windows usando barras invertidas en archivos JSON, escapa cada barra invertida como una doble barra invertida (`\\`), o usa barras inclinadas hacia adelante (`/`). {% endhint %} {% hint style="warning" %} **Asistentes de IA basados en navegador:**\ El servidor MCP de ACE Studio se ejecuta localmente en tu equipo a través de STDIO. Las interfaces solo web (como ChatGPT o Claude en un navegador web) no pueden conectarse directamente a servidores STDIO locales. Usa en su lugar sus respectivas aplicaciones de escritorio o clientes de terminal. {% endhint %} {% hint style="info" %} **Rutas de instalación personalizadas:** Si instalaste ACE Studio en un directorio personalizado, abre **Preferencias → General → External Agent Access** en ACE Studio: * Haz clic en **Copiar comando** junto a **Servidor MCP (stdio)** para la ruta del servidor MCP. * Haz clic en **Copiar** junto a **ruta del binario acestudio-cli** para la ruta de la CLI. {% endhint %} *** ### Verificación de la conexión Asegúrate de que ACE Studio esté abierto y en ejecución, luego pregúntale a tu asistente: ``` Por favor, comprueba la información actual del Proyecto de ACE Studio ``` Si tu asistente responde con el Tempo de tu Proyecto, la armadura de tonalidad y la lista de pistas, la configuración está completa y lista. *** ### Ejemplos de prompts creativos Aquí tienes algunos ejemplos reales de cómo puedes colaborar con tu asistente de IA en ACE Studio: #### 1. Producción vocal y armonías de varios cantantes ``` Activa el Modo Coro en la pista vocal principal (Pista 1), añade dos Voces de acompañamiento amplía la Dispersión estéreo y baja su nivel en -3 dB para lograr una armonía de fondo exuberante. ``` #### 2. Mezcla de voces personalizada ``` Crea una Voz Combinada personalizada en la Pista 2: mezcla un 70% de una semilla de pop acústico cálido con un 30% de una semilla de voz con Aire y Resp., y luego nombra la mezcla "Aire de terciopelo". ``` #### 3. Acordes y boceto de la canción ``` En los Compases 1–8 de la Pista de acordes, inserta una progresión Neo-Soul: Ebmaj9 — G7#9 — Cm9 — F13 (2 compases cada uno). Luego añade una pista de piano Rhodes y una línea de bajo con groove siguiendo las notas raíz. ``` #### 4. Acompañamiento con IA y extracción de Audio ``` Divide el Clip de audio importado en la Pista 1 en vocal, batería, bajo y otras Pistas. Luego ejecuta Vocal a MIDI sobre el Stem vocal extraído para crear una Pista Sing editable. ``` #### 5. Ideas generativas de canciones y capas ``` Escucha el arreglo desde el Compás 9 hasta el 25 y usa Agregar una capa para generar una capa de acompañamiento de pad de cuerdas cinematográficas que coincida con el Tempo actual del Proyecto. ``` #### 6. Afinación Vocal expresiva y dinámica ``` Revisa las notas vocales del coro en la Pista 1: suaviza las transiciones de tono, aumenta la aspiración en las notas de entrada y añade una curva sutil de Vibrato en las notas sostenidas. ``` #### 7. Cadenas FX y entrega de Stem ``` Carga un compresor Vocal vintage y una reverberación de placa cálida en la cadena FX de la Vocal principal, luego exporta todas las Pistas individuales como Pistas WAV de 24 bits y 48 kHz a la carpeta "Pistas" de mi Escritorio. ``` --- # 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-es/agente-de-ia/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.