Quien hoy plantea una pregunta sobre su proyecto a una IA exporta el plan y sube el archivo; la semana siguiente el plan ha cambiado y todo vuelve a empezar. Por eso Merlin Project incorpora un servidor MCP, un pequeño programa en su Mac con el que un cliente de IA lee directamente el plan abierto en lugar de trabajar con una copia. Claude Desktop es el camino más cómodo, porque basta con un bloque en un archivo de configuración. Este artículo recorre los tres pasos en orden, desde la instalación del servidor hasta la primera pregunta a su plan.
El vídeo de este artículo
El vídeo (en alemán) está insertado en la versión alemana de este artículo. Recorre la configuración con el proyecto de ejemplo «Produktlaunch Phoenix», un pequeño lanzamiento de producto con cinco fases, una veintena de tareas y ocho recursos. Al final, Claude consulta al plan los hitos alcanzados y las próximas fechas, y la respuesta procede del proyecto tal y como está abierto en Merlin. Los pasos siguientes son completos por sí solos.
Lo que necesita
- Merlin Project en su versión actual
- Claude Desktop para Mac; basta con una cuenta gratuita de Claude
- un proyecto abierto que Claude pueda leer
Nada más. Ni terminal ni paquetes de Node, y ninguna media hora de documentación. MCP son las siglas de Model Context Protocol, un estándar abierto que hoy admiten todos los grandes proveedores de IA. Describe cómo un cliente de IA invoca las herramientas de un programa, en nuestro caso las consultas de lectura del servidor de Merlin.
Pasos 1 y 2: preparar Merlin Project
- Instale el servidor. En Merlin Project abra el menú Merlin Project y elija Install MCP Server. Merlin deja un pequeño programa en su Mac, el puente entre el cliente de IA y el plan. El instalador muestra la ruta; es
/usr/local/bin/merlinproject-mcp. - Comparta el proyecto. Abra el proyecto y haga clic en AI Tools en la barra de herramientas. Marque Permitir que las herramientas de IA interactúen con el documento; el símbolo se muestra relleno. El uso compartido vale solo para ese proyecto, todos los demás siguen invisibles para el servidor. En cuanto un cliente se conecta, el símbolo se vuelve azul.
local · solo lectura · inaccesible desde fuera. El servidor solo lee los proyectos que usted comparte, no modifica nada de sus datos, y nadie llega hasta él desde fuera. Lo que un cliente en la nube ve de los datos leídos lo explica el artículo sobre protección de datos.
Estos dos pasos son idénticos en todos los clientes. Si más adelante conecta Claude Code, Codex o Antigravity, ya los tendrá hechos.
Paso 3: dar a conocer el servidor a Claude Desktop
Merlin está preparado, pero Claude todavía no sabe que ese servidor existe. Es el único paso en el que toca brevemente un archivo.
- En Claude Desktop abra Settings y vaya a Developer.
- Haga clic en Edit Config. Claude resalta el archivo
claude_desktop_config.jsonen el Finder. - Abra el archivo con un editor de texto, por ejemplo TextEdit.
- Pegue el siguiente bloque y guarde.
Bloque de configuración para merlin-project claude_desktop_config.json
{
"mcpServers": {
"merlin-project": {
"command": "/usr/local/bin/merlinproject-mcp"
}
}
}Limítese a añadir. Si el archivo ya contiene algo, no borre nada, o Claude perderá otras herramientas que ya tenga configuradas. Si ya existe una entrada mcpServers, añada solo el bloque interior merlin-project.
- Cierre Claude Desktop por completo (Cmd+Q) y vuelva a iniciarlo. Claude lee el archivo de configuración solo al arrancar.
Tras el reinicio, merlin-project aparece en la lista de herramientas. La conexión está en pie, y el símbolo de AI Tools en Merlin Project se vuelve azul en cuanto Claude lee el plan por primera vez.
La primera pregunta a su plan
Pregunte a Claude en qué punto está su proyecto. El prompt del vídeo está en nuestra biblioteca de prompts y puede copiarse aquí mismo:
Prompt: ¿En qué punto está mi proyecto ahora mismo?
Resume el estado actual del proyecto activo. Hazlo en tres pasos: primero indica el avance total y la fecha de fin prevista, luego los últimos hitos alcanzados y, por último, las próximas fechas. Destaca qué ha cambiado respecto al plan y limítate a los diez puntos más importantes.Ver este prompt en la biblioteca ›
Claude lee tareas, hitos y fechas del proyecto compartido y los resume. Sin exportar, sin copias, y si mañana desplaza una fecha, mañana Claude le dará la respuesta nueva. Más preguntas, desde la carga de recursos hasta el informe para interesados, en la biblioteca de prompts.
Si Claude no ve el servidor
El error más frecuente es también el más sencillo: no se cerró Claude Desktop por completo después de guardar. Cerrar la ventana no basta. Salga de la aplicación con Cmd+Q y vuelva a abrirla. Tres comprobaciones más:
- Compruebe la ruta. El instalador de Merlin Project muestra la ruta del servidor. Debe coincidir exactamente con el valor del bloque de configuración.
- Compruebe el JSON. Basta una coma o una llave que falte para que Claude ignore el archivo entero. Copie el bloque de esta página en lugar de teclearlo.
- Compruebe el uso compartido. ¿Está el proyecto compartido mediante «AI Tools»? El servidor solo lee proyectos con el acceso activado. Un servidor instalado sin proyecto compartido responde con una lista vacía.
La lista de comprobación
Para practicar: el proyecto de ejemplo
Si primero quiere practicar sin un proyecto propio, descargue Produktlaunch Phoenix, el proyecto de ejemplo del vídeo. Ya está en marcha, las primeras fases están cerradas, y Claude encuentra en él hitos y fechas, igual que en el vídeo.
Los demás clientes
Claude Desktop es la entrada más cómoda. Quien trabaje en un editor o en el terminal, o maneje datos que no pueden salir del Mac, encontrará aquí la guía adecuada:
- Claude Desktop (este artículo): Un bloque en un archivo, reiniciar
- LM Studio: Descargar un modelo, un bloque en un archivo
- Claude Code: Un comando
- Codex: Un comando
- Antigravity: Un bloque en un archivo, reinicio completo
- ChatGPT: Puente de copia o Asistente Inteligente
- ¿Qué cliente de IA le conviene?
La referencia completa de todos los clientes está en la documentación de MCP.
Si tiene alguna pregunta sobre este artículo del blog o desea debatirlo, esperamos su contribución en nuestro foro.
