Configuración MCP: conectar Merlin Project con Claude Code

Claude Desktop responde a las preguntas sobre el plan en una ventana de chat. En cuanto una respuesta tiene que seguir su camino, por ejemplo como informe de estado listo en un archivo cada viernes, necesita un cliente que funcione desde la línea de comandos. Claude Code es ese cliente. Habla con el mismo servidor MCP que Claude Desktop, pero entrega su respuesta como texto en el terminal, y el texto se puede redirigir, encadenar y generar a una hora fija. Aquí encontrará el comando de conexión, la comprobación y la llamada con la que el informe surge sin ventana de chat.

El vídeo de este artículo

El vídeo (en alemán) está insertado en la versión alemana de este artículo.

Lo que necesita

  • Merlin Project en su versión actual, servidor MCP instalado, proyecto compartido (guía en el artículo sobre Claude Desktop, pasos 1 y 2)
  • Claude Code, instalado, iniciado una vez y con sesión abierta

Compartir en Merlin es el mismo clic único que con cualquier otro cliente:

Un clic comparte ese proyecto concreto: AI Tools en la barra de herramientas y después activar Permitir que las herramientas de IA interactúen con el documento. Todos los demás proyectos siguen invisibles para el servidor.

El segundo punto es el error más frecuente: quien instala Claude Code pero nunca lo ha iniciado verá que el comando de conexión cae en el vacío. Inicie Claude Code una vez, identifíquese y vuelva a cerrarlo.

Paso 1: dar a conocer el servidor a Claude Code

Abra el terminal e introduzca este comando:

Conectar Terminal

claude mcp add --transport stdio merlin-project -- /usr/local/bin/merlinproject-mcp

El comando dice tres cosas: Claude Code debe registrar un servidor llamado merlin-project, dirigirse a él por stdio y arrancar para ello el programa que va tras el doble guion. El -- del medio separa las opciones de Claude Code del comando de arranque del servidor de Merlin; todo lo que va detrás pertenece al servidor. Claude Code confirma con «Added stdio MCP server merlin-project».

Paso 2: comprobar el registro

Si la entrada llegó limpia lo muestra un segundo comando:

Comprobar Terminal

claude mcp get merlin-project

La salida indica nombre, transporte (stdio) y ruta. Si las tres coinciden, el servidor está registrado. Que la conexión además funcione solo lo verá con una pregunta real.

La primera pregunta: ¿qué tareas amenazan con torcerse?

Inicie Claude Code con claude y plantee la pregunta del vídeo:

Prompt: ¿Qué tareas están a punto de retrasarse?

Identifica todas las tareas del proyecto activo que, según el plan actual, corren el riesgo de retrasarse. Comprueba el avance, la duración restante y las dependencias. Para cada tarea, indica cuántos días de retraso se avecinan, qué sucesoras se verían afectadas y si la fecha de fin del proyecto está en peligro.

Ver este prompt en la biblioteca ›

Claude Code llama al servidor de Merlin y devuelve una tabla con datos reales del proyecto compartido. En la primera llamada, Claude Code pregunta si puede usar la herramienta; confírmelo.

¿Por qué el terminal? La respuesta a un archivo

Hasta aquí, una ventana de chat habría podido hacer lo mismo. La diferencia: la respuesta es texto, y el texto en el terminal se puede seguir procesando, escribir en un archivo o entregar a un script. El mismo encargo sin ventana de chat, directamente desde la línea de comandos, con la respuesta redirigida a un archivo:

Sin ventana de chat, respuesta a un archivo Terminal

claude -p "List all tasks of the active project that are at risk of slipping, as a table with task, planned finish and responsible resource." > at-risk.md

El modificador -p significa modo print: Claude Code ejecuta el encargo, imprime la respuesta y termina. El > redirige la salida al archivo at-risk.md. Ábralo y ahí estará la tabla.

Para el informe del viernes solo falta un paso: lo que funciona desde la línea de comandos, su Mac puede arrancarlo solo a una hora fija, por ejemplo mediante un launch agent o una automatización de calendario. Viernes, 16:00, y el informe está ahí sin que nadie teclee. Cómo es ese informe y qué más debería contener lo tratamos en un vídeo propio sobre el informe semanal automatizado.

Retirar el servidor

Por si alguna vez quiere deshacerse de la entrada:

Eliminar Terminal

claude mcp remove merlin-project

Si la conexión no funciona

  • ¿«Claude Code not found»? Claude Code no está instalado o el terminal no conoce la ruta. Revise la instalación y abra un terminal nuevo.
  • ¿El comando funciona pero no llega respuesta del plan? Claude Code nunca se inició ni se identificó, o el proyecto no está compartido en Merlin.
  • ¿Ruta incorrecta? El instalador de Merlin Project muestra la ruta. Compárela con claude mcp get merlin-project; si difiere, elimine y registre de nuevo.

Chuleta

Para practicar va bien el proyecto de ejemplo Produktlaunch Phoenix. Quien prefiera leer los informes en una ventana de chat que use Claude Desktop; el equivalente de OpenAI en el terminal es Codex. Todas las guías:

Si tiene alguna pregunta sobre este artículo del blog o desea debatirlo, esperamos su contribución en nuestro foro.

Planifica proyectos que realmente funcionan.

Una app para tu plan de proyecto, nativa en todos los dispositivos Apple.