Laravel Boost: instalación, configuración y solución de problemas

Si usas Cursor para desarrollar con Laravel, Laravel Boost es probablemente la herramienta que más va a mejorar tu flujo de trabajo con IA. En lugar de que el agente adivine cómo está montado tu proyecto, Boost le da contexto real: rutas registradas, esquema de base de datos, versión de Laravel, logs, y acceso a más de 17.000 entradas de documentación del ecosistema Laravel.

En este artículo te cuento cómo instalarlo, cómo conectarlo a Cursor y cómo resolver el problema más común que vas a encontrar: el error de protocolo MCP.

¿Qué es Laravel Boost?

Laravel Boost es un servidor MCP (Model Context Protocol) para proyectos Laravel. Lo instalas como dependencia de desarrollo y expone más de 15 herramientas que tu agente de IA puede usar directamente: inspeccionar el esquema de base de datos, listar rutas, leer logs, ejecutar código con Tinker, buscar en la documentación...

El resultado es que Cursor deja de generar código genérico y empieza a generar código que encaja con tu proyecto real. Conoce tus modelos, tus relaciones, tus convenciones.

Instalación

Boost se instala como dependencia de desarrollo con Composer:

composer require laravel/boost --dev

Después lanzas el instalador interactivo:

php artisan boost:install

El instalador te pregunta dos cosas: qué funcionalidades quieres activar (guidelines, skills, servidor MCP) y qué agentes/IDEs usas. Selecciona Cursor y confirma. Boost generará automáticamente el fichero .mcp.json en la raíz del proyecto con la configuración necesaria.

Activar el MCP en Cursor

Una vez instalado, tienes que activar el servidor MCP dentro de Cursor. Es muy sencillo:

1. Abre la paleta de comandos con Cmd+Shift+P (o Ctrl+Shift+P en Windows/Linux)
2. Escribe Open MCP Settings y pulsa Enter
3. Busca laravel-boost en la lista y activa el toggle

Si aparece habilitado pero muestra "No tools or prompts", desactívalo y vuélvelo a activar. A veces el .mcp.json generado incluye ./artisan en lugar de artisan a secas — quitar el ./ suele resolver ese caso concreto.

El problema más común: rutas relativas y PHP no encontrado

Lo más probable es que al activar el MCP veas algo así en el log de Cursor:

Starting new stdio process with command: php artisan boost:mcp
Client closed for command
[V1] initializing -> error: Client closed

El problema es que Cursor ejecuta el comando php artisan boost:mcp pero no sabe desde qué directorio hacerlo, y además el php del PATH del sistema puede no ser el que tú usas (especialmente si usas Laravel Herd).

La solución es usar rutas absolutas en el .mcp.json. Primero localiza tu PHP:

which php

Si usas Herd te devolverá algo como:

/Users/tu-usuario/Library/Application Support/Herd/bin/php

Ahora edita el .mcp.json en la raíz del proyecto con las rutas absolutas:

{
    "mcpServers": {
        "laravel-boost": {
            "command": "/Users/tu-usuario/Library/Application Support/Herd/bin/php",
            "args": [
                "/ruta/absoluta/tu-proyecto/artisan",
                "boost:mcp"
            ]
        }
    }
}

Tras guardar, ve a MCP Settings en Cursor, desactiva laravel-boost y vuélvelo a activar para que recargue la configuración.

El segundo problema: Unsupported protocol version

Si después de corregir las rutas el log muestra este error:

MCP error -32602: Unsupported protocol version

El motivo es que tienes una versión antigua de laravel/boost o laravel/mcp que implementa el protocolo MCP legacy, incompatible con las versiones actuales de Cursor. Las versiones afectadas son Boost v1.x y laravel/mcp v0.1.x.

La solución es actualizar a Boost v2, que implementa el nuevo protocolo. Lanza la actualización permitiendo que Composer resuelva todas las dependencias necesarias:

composer update

O si prefieres ser más explícito:

composer require laravel/boost:"^2.0" laravel/mcp --dev -W

El flag -W permite que Composer actualice también las dependencias transitivas (como illuminate/console) que necesita Boost v2. Ten en cuenta que Boost v2 requiere al menos Laravel 11.45.3 o 12.41.1, así que si tienes una versión anterior del framework también se actualizará.

Tras la actualización, regenera los ficheros de configuración:

php artisan boost:update

Y vuelve a activar el toggle en Cursor. Esta vez debería aparecer con todas las tools disponibles.

Añadir los ficheros al .gitignore

Los ficheros que genera Boost se regeneran automáticamente con boost:install y boost:update, así que no tiene sentido trackerlos en Git. Añádelos al .gitignore:

.mcp.json
CLAUDE.md
AGENTS.md
boost.json

¿Y ahora qué?

Con el MCP activo puedes empezar a sacar partido real a Cursor en tu proyecto Laravel. En lugar de preguntar cosas genéricas como "cómo creo una relación en Eloquent", puedes preguntar directamente "¿qué relaciones tiene el modelo User en este proyecto?" y el agente irá a buscarlo.

Algunas preguntas útiles para empezar:

• "¿Qué rutas tiene registradas esta aplicación?"
• "¿Cuál fue el último error en el log?"
• "¿Qué columnas tiene la tabla de pedidos?"
• "Ejecuta este código con Tinker y dime el resultado"

La diferencia respecto a trabajar sin contexto es bastante notable. El agente deja de inventarse cosas y empieza a trabajar con lo que realmente tienes.