Acceso a agentes externos

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 herramienta, los formatos y las convenciones pueden cambiar entre actualizaciones.

• En desarrollo: Aún no todos los elementos de ACE Studio son totalmente accesibles para los agentes.

• Detalles por pulir: Puedes encontrarte con errores, casos límite inesperados o comportamientos poco naturales mientras refinamos las interacciones con los agentes.

Si encuentras algún problema o tienes sugerencias, avísanos en [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 gran parte de 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 las voces de síntesis vocal, las fuentes de sonido, las capas de coro con varios cantantes y los parámetros vocales (tono, respiración, tensión).

• Tiempo y estructura — Configura BPM, compases, marcadores de bucle y transporte.

• Producción y Herramientas de IA — Activa Agregar una capa, Vocal a MIDI, Separador de pistas, Music Enhancer y carga cadenas de FX o preajustes.

• Control de sesión y entrega — Inicia y guarda proyectos, importa audio y MIDI, y exporta mezclas finales completas, pistas individuales, vídeo y más.

Solo describe lo que quieres en lenguaje natural, y tu asistente inspeccionará el proyecto y aplicará 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.

Esta ruta requiere un agente ejecutándose en el mismo ordenador que ACE Studio, con permisos para ejecutar comandos y editar sus archivos de configuración.

Copia y pega este mensaje 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"
- Windows MCP: "C:\Program Files\ACE Studio\ace-mcp-server.exe"
- Windows CLI: "C:\Program Files\ACE Studio\acestudio-cli.exe"

Primero, prueba a usar la CLI y recuerda la ruta de la herramienta en tus instrucciones o memoria. Si el acceso a la CLI está restringido por el aislamiento o por permisos, registra el servidor MCP (con el nombre "ace-studio" y ámbito de usuario o global). Si no lo encuentras en la ubicación predeterminada, pídeme la ruta desde Preferencias de ACE Studio → General → Acceso de agentes externos.

Si necesitas más contexto sobre ACE Studio y su integración con agentes, consulta la documentación en https://docs.acestudio.ai/llms.txt. Si tu entorno no puede configurarse automáticamente 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 el servidor MCP de ACE Studio a su configuración manualmente.

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 STDIO local, lo que permite que cualquier cliente compatible con MCP se conecte directamente mediante el comando de inicio.

Configurar mediante Terminal

Si usas Claude o Codex y prefieres configurar directamente desde tu 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 recorrido de configuración:

• Claude Desktop y Cowork — Configuración paso a paso de Claude Desktop con recorrido por archivos 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 IDE solicitan los mismos parámetros de configuración:

• Tipo de Transporte: STDIO (a veces etiquetado como "Local" o "Command")

• Comando: El comando de inicio copiado de ACE Studio

• Argumentos / Entorno: Ninguno

Para entornos configurados mediante archivos JSON:

Configuración MCP estándar (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"
    }
  }
}

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

Asistentes de IA basados en navegador: El servidor MCP de ACE Studio se ejecuta localmente en tu máquina mediante STDIO. Las interfaces solo web (como ChatGPT o Claude en un navegador web) no pueden conectarse directamente a servidores STDIO locales. En su lugar, usa sus aplicaciones de escritorio o clientes de terminal correspondientes.

Rutas de instalación personalizadas: Si instalaste ACE Studio en un directorio personalizado, abre Preferencias → General → Acceso de agente externo 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 binaria de acestudio-cli para la ruta de la CLI.

---

Verificando la conexión

Asegúrate de que ACE Studio esté abierto y en ejecución, luego pídele 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 tonalidad y la lista de Pistas, tu configuración estará 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. Vocal Production y armonías de varios cantantes

Activa el Modo Coro en la pista vocal principal (Pista 1), añade dos cantantes de apoyo
Voces, ensancha la Dispersión estéreo y reduce 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 el 70 % de una semilla pop acústica cálida
con un 30 % de una semilla de Voz aireada y Resp., y luego nombra la mezcla "Velvet Aire".

3. Acordes y borrador de 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

Dividir 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 del Compás 9 al 25 y usa Agregar una capa para generar
una capa de acompañamiento de pad de cuerdas cinematográfico que coincida con el Tempo actual del Proyecto.

6. Afinación Vocal expresiva y dinámica

Inspecciona las notas de Vocal 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 de Vibrato sutil en las notas sostenidas.

7. Cadenas de FX y entrega de Stem

Carga un compresor Vocal vintage y una reverb de placa cálida en la cadena FX de la Vocal principal,
luego exporta todas las Pistas individuales como Pistas WAV de 24 bits a 48 kHz a una carpeta "Pistas" en mi escritorio.