Configuración MCP: conectar Merlin Project con Antigravity

Antigravity es el editor agéntico de Google y usa para los servidores MCP el mismo tipo de configuración que Claude Desktop: un bloque en un archivo JSON que le dice al editor qué programa debe arrancar. Una particularidad distingue a Antigravity de los demás clientes. Lee ese archivo solo al arrancar, así que quien no ve conexión después de guardar suele buscar el fallo en un archivo que hace tiempo está correcto. Aquí puede consultar la ruta de clics hasta la configuración, el bloque para copiar y el reinicio sin el cual no pasa nada.

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
• Antigravity para Mac

El lado de Merlin es igual en todos los clientes:

1. 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.
2. 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.

Paso 1: añadir la configuración

El camino hasta el archivo de configuración pasa por la sesión de agente:

1. En Antigravity abra una sesión de agente.
2. En el panel lateral, haga clic en el menú … y elija MCP Servers.
3. Arriba, en la tienda MCP, haga clic en Manage MCP Servers y después en View raw config. Se abre el archivo mcp_config.json.
4. Añada el siguiente bloque y guarde.

Bloque de configuración para merlin-project mcp_config.json

{
  "mcpServers": {
    "merlin-project": {
      "command": "/usr/local/bin/merlinproject-mcp"
    }
  }
}

Importante: limítese a añadir. Si el archivo ya contiene algo, no borre nada, o Antigravity perderá otros servidores que ya tuviera configurados.

Paso 2: reiniciar Antigravity

Guarde y mire la lista MCP: Merlin no está. La configuración está puesta y Antigravity no muestra conexión. El motivo: Antigravity lee ese archivo solo al arrancar. Mientras la aplicación siga en marcha no sabe nada de su entrada, por mucho que guarde.

Por eso el segundo paso es un reinicio completo. Cerrar la ventana no basta; salga de Antigravity con Cmd+Q y vuelva a abrirlo. Después, merlin-project figura en la lista de servidores conectados. Quien se salta este paso no ve conexión y busca el fallo en un archivo que hace tiempo está correcto.

La primera pregunta: una fase como lista de comprobación

Tras el reinicio ya puede preguntar. En el vídeo se emite un grupo de tareas como lista de comprobación, de modo que pueda ir directa al equipo:

Prompt: ¿Cómo convierto una fase en una lista de comprobación?

Exporta todas las tareas del grupo {PHASE} del proyecto activo como lista de comprobación en Markdown: una línea por tarea con casilla, recurso asignado y fecha. Marca como hechas las tareas ya terminadas. La lista debe poder pegarse directamente en notas o en una wiki.

Ver este prompt en la biblioteca ›

Sustituya el marcador por el nombre de la fase, por ejemplo «4 Go-to-Market». Antigravity lee tareas, asignaciones y progreso del plan y entrega lista y tabla, ambas listas para reutilizar.

Si pese al reinicio no aparece nada

• Compruebe el JSON. Basta una coma que falte para que Antigravity descarte el archivo. Copie el bloque de esta página.
• Compruebe la ruta. El instalador de Merlin Project muestra la ruta; debe coincidir exactamente con el valor del archivo.
• Compruebe el uso compartido. ¿Está el proyecto compartido en Merlin mediante «AI Tools»?
• ¿Realmente cerrado? El botón rojo de cerrar no termina la aplicación. Mire en el Dock si Antigravity sigue en marcha y entonces pulse Cmd+Q.

Lista de comprobación

Para practicar va bien el proyecto de ejemplo Produktlaunch Phoenix. Más formatos de exportación están en la biblioteca de prompts. Todas las guías de instalación:

• Claude Desktop: Un bloque en un archivo, reiniciar
• LM Studio: Descargar un modelo, un bloque en un archivo
• Claude Code: Un comando
• Codex: Un comando
• Antigravity (este artículo): Un bloque en un archivo, reinicio completo
• ChatGPT: Puente de copia o Asistente Inteligente
• ¿Qué cliente de IA le conviene?

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