> 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**. **Tenga en cuenta:** * Es posible que algunas funciones y ajustes todavía no estén completamente implementados * Las funciones y la funcionalidad pueden cambiar * Es posible que encuentre errores o problemas de rendimiento durante el uso * Las pautas de uso y los límites de velocidad se publicarán cuando se lance la versión estable Estamos mejorando activamente esta función. Si tiene comentarios o encuentra algún problema, contáctenos en [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} El servidor MCP de ACE Studio ofrece un amplio 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 su Proyecto, les permite ayudarle a crear y editar canciones con mayor rapidez y libertad creativa. [El Protocolo de Contexto del 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 su espacio de trabajo creativo. ### Inicio rápido #### Inicie el servidor MCP de ACE Studio 1. Abra **ACE Studio**. 2. Vaya a **Preferencias → General → Servidor MCP**. 3. Elija un modo de Transporte: **HTTP** o **STDIO**. > El modo de Transporte que seleccione aquí determina cómo se conecta su cliente de IA a ACE Studio. Consulte las secciones siguientes para obtener detalles y la configuración específica del cliente. Elija la configuración adecuada según el modo de Transporte que haya seleccionado y su cliente de IA. #### Modo HTTP transmisible En modo HTTP, ACE Studio ejecuta un servidor MCP local en una dirección fija. Su 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 usa el **protocolo de Transporte HTTP transmisible**. Guarde 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 se siente cómodo con la configuración técnica, le recomendamos probar clientes más fáciles de usar. **Pasos de configuración:** 1. Instale Node.js, si es necesario. * Visite [nodejs.org](https://nodejs.org) y descargue la versión LTS. 2. Localice 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. Edite el archivo de configuración y añada lo siguiente: ```json { "mcpServers": { "acestudio": { "command": "npx", "args": [ "mcp-remote", "http://localhost:21572/mcp" ] } } } ``` 4. Guarde el archivo y reinicie Claude Desktop. **Verificar conexión:**\ Escriba en Claude: ``` Por favor, compruebe la información del Proyecto actual de ACE Studio ``` Si Claude devuelve detalles del Proyecto, la conexión se ha realizado correctamente. **Cursor** Puede agregar 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. Abra la configuración de Cursor. 2. Encuentre la **Herramientas y MCP** sección. 3. Haga clic **Nuevo servidor MCP**. 4. Rellene el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Haga clic **Guardar**. 6. Reinicie Cursor. **Verificar conexión:**\ Escriba en Cursor Chat: ``` @acestudio ¿Qué pistas hay en el Proyecto actual? ``` **VS Code mediante compatibilidad nativa con MCP** Puede agregar 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. Cree o edite `.vscode/mcp.json` en su espacio de trabajo. 2. Añada la siguiente configuración: ```json { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp" } } } ``` **VS Code mediante Cline** 1. Instale la extensión Cline. 2. Abra la configuración de la extensión. 3. Busque la sección de configuración de servidores MCP. 4. Añada un nuevo servidor: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **Otros clientes** Para la mayoría de los clientes, use estos ajustes de configuración: * **Tipo de Transporte:** HTTP transmisible. Algunos clientes pueden llamarlo `Remote`. * **URL del servidor:** `http://localhost:21572/mcp` O importe el servidor MCP con el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` #### Modo STDIO En modo STDIO, su cliente de IA inicia y se comunica con el servidor MCP de ACE Studio directamente a través de la entrada y salida estándar. Su configuración es más sencilla. No necesita iniciar un servidor manualmente ni usar una dirección de red. **Obtención del comando:** 1. En ACE Studio, vaya a **Preferencias → General → Servidor MCP**. 2. Establezca el modo en **STDIO**. 3. Haga clic **Copiar comando** para copiar el comando del servidor al portapapeles. El comando copiado se verá así: ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` Use este comando en los pasos de configuración a continuación. {% hint style="info" %} La ruta del comando varía según el sistema operativo. Use el comando exacto copiado desde ACE Studio en cada configuración de cliente a continuación. {% endhint %} **Claude Desktop** STDIO es el Transporte nativo para Claude Desktop. No necesita herramientas adicionales como `mcp-remote`. 1. Localice 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. Edite el archivo de configuración y añada lo siguiente: ```json { "mcpServers": { "acestudio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 3. Guarde el archivo y reinicie Claude Desktop. **Verificar conexión:**\ Escriba en Claude: ``` Por favor, compruebe la información del Proyecto actual de ACE Studio ``` Si Claude devuelve detalles del Proyecto, la conexión se ha realizado correctamente. **Cursor** 1. Abra la configuración de Cursor. 2. Encuentre la **Herramientas y MCP** sección. 3. Haga clic **Nuevo servidor MCP**. 4. Rellene el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Haga clic **Guardar**. 6. Reinicie Cursor. **Verificar conexión:**\ Escriba en Cursor Chat: ``` @acestudio ¿Qué pistas hay en el Proyecto actual? ``` **VS Code mediante compatibilidad nativa con MCP** 1. Cree o edite `.vscode/mcp.json` en su espacio de trabajo. 2. Añada 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. Instale la extensión Cline. 2. Abra la configuración de la extensión. 3. Busque la sección de configuración de servidores MCP. 4. Añada 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, use estos ajustes de configuración: * **Tipo de Transporte:** STDIO * **Comando:** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server` * **Argumentos:** `--stdio` O importe 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, puede probar los siguientes prompts para colaborar con su 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 estribillo de 8 Compases en ACE Studio. La melodía debe ser ligera y animada, usando una Escala pentatónica ``` #### Editar MIDI ``` En ACE Studio, añada una progresión de Acordes de Piano en los Compases 9-16: C - Am - F - G, cada Acorde 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.