Laravel Boost: qué es y cómo usarlo con tu agente de IA

Laravel Boost es el paquete oficial de Laravel que le da a tu agente de IA (Claude Code, Cursor, Codex) contexto de tu aplicación: un servidor MCP que lee el esquema, los logs y los errores, más unas guías y skills que le enseñan a escribir el Laravel de tu versión. Se instala con composer require laravel/boost --dev y php artisan boost:install, y al escribir esto suma más de 36 millones de descargas en Packagist.

Las cifras de esta guía salen de instalar la versión 2.10.0 en un proyecto Laravel 13 recién creado: cuántas herramientas expone, cuánto pesa cada archivo que escribe y qué pasa si lo arrancas en producción. También verás en qué archivo guarda Boost las guías de Claude Code y qué comando evita que envejezcan.

• Qué es Laravel Boost
• Instalar Laravel Boost
• Las herramientas MCP
• Guías y skills
• Search Docs
• Conectar Boost con tu agente
• Mantener Boost al día
• Cuándo instalarlo

Qué es Laravel Boost: un servidor MCP, guías y skills

Laravel Boost es un paquete de desarrollo que conecta tu agente de IA con tu aplicación Laravel por tres vías. La primera es un servidor MCP con herramientas que leen tu app. La segunda son guías que el agente carga al empezar cada sesión, y la tercera, skills que solo carga cuando la tarea las pide.

Lo publica el equipo de Laravel en laravel/boost, con licencia MIT. El repositorio se creó el 15 de julio de 2025 y la versión 1.0.0 salió el 13 de agosto de 2025.

La 2.10.0 se publicó el 23 de septiembre de 2026 y pide PHP 8.2 o superior y Laravel 11.45.3, 12.41.1 o 13. Por debajo se apoya en Laravel MCP, el paquete oficial para construir servidores MCP.

Instalar Laravel Boost: dos comandos y lo que dejan en tu repo

Instalar Laravel Boost son dos comandos de Composer y Artisan, y el segundo escribe la configuración de cada agente que detecta:

composer require laravel/boost --dev
php artisan boost:install

boost:install busca los agentes instalados en tu máquina y en el proyecto. En el proyecto de prueba encontró Claude Code y Codex, y dejó esto en el repositorio:

Las cinco skills fueron infer-conventions, laravel-best-practices, testing-best-practices, tailwindcss-development y deploying-to-cloud. La tabla de skills de la documentación oficial todavía no lista laravel-best-practices, testing-best-practices ni deploying-to-cloud, y el código de la 2.10.0 las instala igual.

El CLAUDE.md que trae el esqueleto de Laravel

Desde la versión 13.10.1 del esqueleto laravel/laravel, publicada el 25 de agosto de 2026, un proyecto nuevo trae un AGENTS.md y un CLAUDE.md idénticos de 1.446 bytes. Son instrucciones de arranque: le piden al agente que instale Boost y que después vuelva a leer AGENTS.md.

Tras boost:install, AGENTS.md crece a 10.166 bytes con las guías reales y CLAUDE.md queda intacto. Encaja con el código: en la 2.10.0, la ruta de guías de Claude Code es AGENTS.md por defecto, configurable con boost.agents.claude_code.guidelines_path.

Ese salto depende del agente. La documentación de Claude Code avisa que, con un CLAUDE.md que pide en palabras leer AGENTS.md, Claude solo lo ve si decide abrirlo, y como hay un CLAUDE.md, tampoco lo lee por su cuenta. Cambia esa frase por una línea @AGENTS.md y deja debajo lo propio de tu proyecto; el porqué está en qué archivo lee cada agente.

Las herramientas MCP de Boost leen tu app en local

El servidor MCP de Boost expone diez herramientas, y todas trabajan sobre tu entorno local. Es la lista que devuelve tools/list al hablar con php artisan boost:mcp por stdio:

Existe una undécima, tinker, que ejecuta PHP dentro de tu app. Viene apagada y solo se registra si pones tinker_tool_enabled en true dentro de config/boost.php.

Boost corre por stdio, como proceso hijo de tu agente, así que no hay endpoint HTTP que exponer ni conexión que se quede abierta. Esa parte la aprendí por las malas con un servidor propio.

Mi endpoint MCP en Vercel, stateless, dejaba abiertos los GET como streams SSE: tres 504 por "Task timed out after 300 seconds" en veinticuatro horas, cinco minutos de función facturada cada uno, con todos los tests en verde. Lo encontré en los logs de runtime buscando otro bug (clientes OAuth que perdían la autorización tras cada deploy). El caso completo está en un GET colgaba mi servidor MCP cinco minutos.

Boost se apaga solo fuera de local

Boost solo arranca si APP_ENV es local o si APP_DEBUG es true. Con APP_ENV=production y APP_DEBUG=false, Artisan responde que no hay comandos en el namespace boost.

La condición es un "o": con APP_DEBUG=true, Boost arranca aunque el entorno sea production. Como además es una dependencia --dev, un composer install --no-dev lo deja fuera del servidor.

Las guías pesan en cada sesión y las skills solo cuando se usan

Las guías de Boost se cargan enteras al arrancar cada sesión del agente. En el proyecto de prueba ocupan los 10.166 bytes de AGENTS.md.

Las skills funcionan al revés: suman unos 148 KB por agente, pero el agente solo abre la que la tarea necesita. Es la misma idea que las skills de Claude Code, con el contenido escrito por el equipo de Laravel.

Antes de sumar guías propias conviene saber qué te cuesta el contexto. Cuando medí 30 días de mis transcripts de Claude Code para evaluar shunt, las lecturas grandes de archivos eran el 0,366% de mi contexto, así que el ahorro que prometía se quedaba en un 0,33% del mes. Cómo hacer esa cuenta con tus propios datos está en el artículo de shunt.

Boost te deja recortar las dos cosas. En config/boost.php, guidelines.exclude y skills.exclude sacan las que no usas, y tus guías y skills propias van en .ai/guidelines/ y .ai/skills/{nombre}/SKILL.md.

Search Docs consulta la documentación de las versiones que tienes

Search Docs busca en la documentación de Laravel filtrando por los paquetes y versiones de tu composer.json. Según la documentación oficial, la base tiene más de 17.000 fragmentos con búsqueda semántica por embeddings.

Cubre Laravel 10 a 13, Livewire 1 a 4, Filament 2 a 5, Inertia 1 y 2, Nova 4 y 5, Pest 3 y 4, Tailwind CSS 3 y 4 y Flux UI 2. Es lo que evita que el agente te escriba la API de una versión que no tienes.

Search Docs solo sabe lo que dice la documentación. Actualizando mi paquete cache-ui-laravel a Laravel 13 descubrí que Cache::flexible() guarda una clave interna extra junto a la tuya, que ensuciaba el listado de cache:list sin que fallara ningún test; tuve que leer el código de Laravel para entenderlo y filtrarla.

Para ese tipo de comportamiento interno, el código del framework sigue siendo la fuente. Lo cuento en la clave interna de Cache::flexible().

Conectar Laravel Boost con Claude Code, Cursor o Codex

Claude Code y Codex suelen quedar conectados solos, porque boost:install escribe su configuración. Si tu agente no ve el servidor, la documentación da un comando para cada uno:

# Claude Code
claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
 
# Codex
codex mcp add laravel-boost -- php "artisan" "boost:mcp"

En Cursor se activa desde la paleta de comandos: abre "/open MCP Settings" y enciende laravel-boost. Para cualquier otro cliente, el registro manual es el mismo:

{
  "mcpServers": {
    "laravel-boost": {
      "command": "php",
      "args": ["artisan", "boost:mcp"]
    }
  }
}

La 2.10.0 trae instaladores para doce agentes: Amp, Antigravity, Claude Code, Codex, Copilot, Cursor, Grok Build, Junie, Kiro, OpenCode, Pi y Zed. El flujo completo con Claude Code, de plan mode a tests con Pest, está en Claude Code en un proyecto Laravel real.

Mantener Boost al día con boost:update

Las guías y skills que genera Boost reflejan tus paquetes el día que lo instalaste y envejecen cuando actualizas dependencias. php artisan boost:update las regenera, y la documentación sugiere engancharlo a Composer:

{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}

Aquí documentación y código discrepan. La documentación dice que boost:update solo actualiza lo ya publicado salvo que pases --discover, y en el código de la 2.10.0 --discover es el comportamiento por defecto, con --no-discover para desactivarlo.

Sobre git, la documentación permite ignorar .mcp.json, CLAUDE.md, AGENTS.md y boost.json, porque se regeneran. Las reglas de .ai/rules, las que guarda record-rule, conviene commitearlas para que las herede todo el equipo.

Construí driftwatch para detectar cuándo un CLAUDE.md, un AGENTS.md o una skill dejan de coincidir con el código: lleva 341 documentos auditados en 66 repositorios públicos, con 37 hallazgos de los que 27 eran problemas reales. El detalle está en cómo uso Jev en driftwatch.

Cuándo instalar Laravel Boost y cuándo esperar

Instala Laravel Boost en cualquier proyecto Laravel 11.45.3 o superior donde trabajes con un agente de IA. Es una dependencia de desarrollo que se apaga fuera de local, así que el riesgo se reduce a no dejar APP_DEBUG=true en producción.

Espera si tu proyecto sigue en Laravel 10 o en PHP 8.1, porque la 2.10.0 no los admite. También si no usas ningún agente: sin cliente MCP, Boost solo te deja archivos en el repo.

Una vez instalado, pídele a tu agente "Use the infer-conventions skill". Recorre tu código, te propone las convenciones que encuentra con su evidencia y las guarda como reglas en .ai/rules cuando las apruebas. Si además quieres que la IA use tu aplicación como herramienta, el paso siguiente es Laravel MCP, y el mapa completo está en IA para desarrolladores Laravel.

Preguntas frecuentes

Fuentes

• Documentación oficial de Laravel Boost
• Repositorio laravel/boost en GitHub, código de la versión 2.10.0
• laravel/boost en Packagist
• Esqueleto laravel/laravel v13.10.1