# 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:** * Algunas funciones y ajustes aún pueden no estar completamente implementados * Las funciones y la funcionalidad pueden cambiar * Es posible que encuentre errores o problemas de rendimiento durante el uso * 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 tiene algún comentario 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 brindar a los agentes de IA una visión completa de cada detalle de su proyecto, les permite ayudarle 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 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 de cada 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 utiliza el **protocolo de transporte HTTP transmisible**. Conserve 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 sencillos 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. **Verifique la conexión:**\ Escriba 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** Puede 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. Abra la configuración de Cursor. 2. Busque la sección **Tools & MCP** . 3. Haga clic en **New MCP Server**. 4. y complete el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Haga clic en **Guardar**. 6. Reinicie Cursor. **Verifique la conexión:**\ Escriba en Cursor Chat: ``` @acestudio ¿Qué pistas hay en el proyecto actual? ``` **VS Code con compatibilidad MCP nativa** Puede 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. 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 MCP Servers. 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 `Remoto`. * **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 mediante la entrada y salida estándar. Esto es más sencillo de configurar. No es necesario iniciar un servidor manualmente ni usar una dirección de red. **Obtener el comando:** 1. En ACE Studio, vaya a **Preferencias → General → Servidor MCP**. 2. Establezca el modo en **STDIO**. 3. Haga clic en **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 siguientes. {% 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 que se muestra 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. **Verifique la conexión:**\ Escriba 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. Abra la configuración de Cursor. 2. Busque la sección **Tools & MCP** . 3. Haga clic en **New MCP Server**. 4. y complete el siguiente JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Haga clic en **Guardar**. 6. Reinicie Cursor. **Verifique la conexión:**\ Escriba en Cursor Chat: ``` @acestudio ¿Qué pistas hay en el proyecto actual? ``` **VS Code con compatibilidad MCP nativa** 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 MCP Servers. 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 comandos 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ñade una progresión de acordes de piano en los compases 9-16: C - Am - F - G, cada acorde con una duración de 2 compases ``` --- # Agent Instructions: 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: ``` GET https://docs.acestudio.ai/docs/product-wiki-es/herramientas-de-ia/servidor-mcp-de-ace-studio.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.