Acceso a agente externo

Conecta ACE Studio con asistentes y agentes de IA a través de MCP y CLI.

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 [e-mail].

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, OpenClawo Hermes Agent), puede configurarse automáticamente.

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.

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, Claudeo Otros agentesy 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) 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:

Claude

Ejecuta en tu terminal:

macOS:

claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows:

claude mcp add --scope user ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

Codex

Ejecuta en tu terminal:

macOS:

codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows:

codex mcp add ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

Aplicaciones de chat de escritorio

Para guías completas paso a paso con recorridos de configuración:

• Claude Desktop y Cowork — Configuración paso a paso para Claude Desktop con recorrido por el archivo de configuración.

• ChatGPT para escritorio — 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:

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:

{
  "mcpServers": {
    "ace-studio": {
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

VS Code (GitHub Copilot)

Añádelo a .vscode/mcp.json en el espacio de trabajo de tu Proyecto:

{
  "servers": {
    "ace-studio": {
      "type": "stdio",
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

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 (/).

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.

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.

---

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.