> 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/herramientas-de-ia/ace-studio-mcp-server.md). # Servidor MCP de ACE Studio ## Servidor MCP de ACE Studio {% hint style="warning" %} #### Estado experimental El servidor MCP de ACE Studio se encuentra actualmente en **Fase experimental**. **Ten en cuenta:** * Es posible que algunas funciones y ajustes aún no estén completamente implementados * Las funciones y la funcionalidad pueden cambiar * Durante el uso, podrías encontrarte con errores o problemas de rendimiento * Las directrices de uso y los límites de frecuencia se publicarán cuando se lance la versión estable Estamos mejorando activamente esta función. Si tienes comentarios o encuentras algún problema, contáctanos en [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} El servidor MCP de ACE Studio ofrece un completo conjunto de herramientas que permite a los agentes de IA navegar de forma autónoma y ejecutar ediciones creativas. Al proporcionar a los agentes de IA una visión integral de cada detalle de tu Proyecto, les permite ayudarte a crear y editar canciones con mayor rapidez y libertad creativa. [El Protocolo de Contexto de Modelo](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) es un estándar abierto que permite a los asistentes de IA conectarse sin problemas con aplicaciones externas y fuentes de datos. El servidor MCP de ACE Studio implementa este protocolo para dar a los agentes de IA acceso directo a tu espacio de trabajo creativo. ### Inicio rápido #### Inicia el servidor MCP de ACE Studio 1. Abrir **ACE Studio**. 2. Ir a **Preferencias → General → Servidor MCP**. 3. Elige un modo de Transporte: **HTTP** o **STDIO**. > El modo de Transporte que selecciones aquí determina cómo se conecta tu cliente de IA a ACE Studio. Consulta las secciones siguientes para obtener más detalles y la configuración específica de cada cliente. Elige la configuración adecuada según el modo de Transporte que hayas seleccionado y tu cliente de IA. #### Modo HTTP transmisible En modo HTTP, ACE Studio ejecuta un servidor MCP local en una dirección fija. Tu cliente de IA se conecta a él a través de la red. **Dirección del servidor:** `http://localhost:21572/mcp` > **Nota técnica**: El servidor MCP de ACE Studio utiliza el **protocolo de transporte HTTP transmisible**. Conserva esta dirección para el siguiente paso de configuración. **Claude Desktop** > ⚠ Configurar el servidor MCP de ACE Studio en Claude Desktop requiere editar un archivo de configuración JSON. Si no te sientes cómodo con la configuración técnica, te recomendamos probar clientes más fáciles de usar. **Pasos de configuración:** 1. Instala Node.js, si es necesario. * Visita [nodejs.org](https://nodejs.org) y descarga la versión LTS. 2. Localiza el archivo de configuración de Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 3. Edita el archivo de configuración y añade lo siguiente: ```json { "mcpServers": { "acestudio": { "command": "npx", "args": [ "mcp-remote", "http://localhost:21572/mcp" ] } } } ``` 4. Guarda el archivo y reinicia Claude Desktop. **Verificar la conexión:**\ Escribe en Claude: ``` Por favor, comprueba la información actual del Proyecto de ACE Studio ``` Si Claude devuelve los detalles del proyecto, la conexión es correcta. **Cursor** Puedes añadir directamente el servidor MCP a Cursor haciendo clic [aquí](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). O configurarlo manualmente: 1. Abre la configuración de Cursor. 2. Busca la sección **Tools & MCP** . 3. Haz clic **Nuevo servidor MCP**. 4. Rellena el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Haz clic **Guardar**. 6. Reinicia Cursor. **Verificar la conexión:**\ Escribe en Cursor Chat: ``` @acestudio ¿Qué pistas hay en el proyecto actual? ``` **VS Code mediante compatibilidad nativa con MCP** Puedes añadir directamente el servidor MCP a VS Code haciendo clic [aquí](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). O configurarlo manualmente: 1. Crea o edita `.vscode/mcp.json` en tu espacio de trabajo. 2. Añade la siguiente configuración: ```json { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp" } } } ``` **VS Code mediante Cline** 1. Instala la extensión Cline. 2. Abre la configuración de la extensión. 3. Busca la sección de configuración de MCP Servers. 4. Añade un nuevo servidor: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **Otros clientes** Para la mayoría de los clientes, usa estos ajustes de configuración: * **Tipo de Transporte:** HTTP transmisible. Algunos clientes pueden llamarlo `Remoto`. * **URL del servidor:** `http://localhost:21572/mcp` O importa el servidor MCP con el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` #### Modo STDIO En modo STDIO, tu cliente de IA inicia y se comunica directamente con el servidor MCP de ACE Studio a través de la entrada y la salida estándar. Esto es más sencillo de configurar. No necesitas iniciar un servidor manualmente ni usar una dirección de red. **Obtener el comando:** 1. En ACE Studio, ve a **Preferencias → General → Servidor MCP**. 2. Establece el modo en **STDIO**. 3. Haz clic **Copiar comando** para copiar el comando del servidor al portapapeles. El comando copiado tendrá este aspecto: ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` Usa este comando en los pasos de configuración siguientes. {% hint style="info" %} La ruta del comando varía según el sistema operativo. Usa en cada configuración de cliente el comando exacto copiado desde ACE Studio. {% endhint %} **Claude Desktop** STDIO es el Transporte nativo para Claude Desktop. No necesitas herramientas adicionales como `mcp-remote`. 1. Localiza el archivo de configuración de Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 2. Edita el archivo de configuración y añade lo siguiente: ```json { "mcpServers": { "acestudio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 3. Guarda el archivo y reinicia Claude Desktop. **Verificar la conexión:**\ Escribe en Claude: ``` Por favor, comprueba la información actual del Proyecto de ACE Studio ``` Si Claude devuelve los detalles del proyecto, la conexión es correcta. **Cursor** 1. Abre la configuración de Cursor. 2. Busca la sección **Tools & MCP** . 3. Haz clic **Nuevo servidor MCP**. 4. Rellena el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Haz clic **Guardar**. 6. Reinicia Cursor. **Verificar la conexión:**\ Escribe en Cursor Chat: ``` @acestudio ¿Qué pistas hay en el proyecto actual? ``` **VS Code mediante compatibilidad nativa con MCP** 1. Crea o edita `.vscode/mcp.json` en tu espacio de trabajo. 2. Añade la siguiente configuración: ```json { "servers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **VS Code mediante Cline** 1. Instala la extensión Cline. 2. Abre la configuración de la extensión. 3. Busca la sección de configuración de MCP Servers. 4. Añade un nuevo servidor: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **Otros clientes** Para la mayoría de los clientes, usa estos ajustes de configuración: * **Tipo de Transporte:** STDIO * **Comando:** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server` * **Argumentos:** `--stdio` O importa el servidor MCP con el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` ### Ejemplos de uso Una vez conectado, puedes probar los siguientes prompts para colaborar con tu asistente de IA: #### Crear un Nuevo proyecto ``` Ayúdame a crear un Nuevo proyecto de estilo pop con BPM 120 en ACE Studio, en Do mayor, añade una pista vocal principal y una pista de acompañamiento de violín ``` #### Generar Letras y melodía ``` Basado en el tema "Recuerdos de verano junto al mar," escribe una sección de coro de 8 Compases en ACE Studio. La melodía debe ser ligera y viva, usando una Escala pentatónica ``` #### Editar MIDI ``` En ACE Studio, añade una progresión de Acordes de Piano en los Compases 9-16: C - Am - F - G, y cada uno de los Acordes dura 2 Compases ``` --- # 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/herramientas-de-ia/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.