--- title: "Laravel Boost: qué es y cómo usarlo con tu agente de IA" excerpt: "Laravel Boost es el paquete oficial que le da a Claude Code, Cursor o Codex contexto de tu app Laravel. Qué instala, sus diez herramientas MCP, guías y skills, y cómo mantenerlo al día." date: "2026-09-23T19:00:00.000Z" category: "Laravel" tech_article: true author: name: "angel cruz" picture: "/images/me/angel-cruz.png" ogImage: url: "/images/open-graph/laravel-opengraph-image.png" seo_title: "Laravel Boost: qué es, cómo instalarlo y usarlo con IA" seo_description: "Aprende qué es Laravel Boost y cómo usarlo: instalación, sus diez herramientas MCP, guías y skills, y cómo conectarlo con Claude Code, Cursor o Codex." --- **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](#que-es-laravel-boost-un-servidor-mcp-guias-y-skills) - [Instalar Laravel Boost](#instalar-laravel-boost-dos-comandos-y-lo-que-dejan-en-tu-repo) - [Las herramientas MCP](#las-herramientas-mcp-de-boost-leen-tu-app-en-local) - [Guías y skills](#las-guias-pesan-en-cada-sesion-y-las-skills-solo-cuando-se-usan) - [Search Docs](#search-docs-consulta-la-documentacion-de-las-versiones-que-tienes) - [Conectar Boost con tu agente](#conectar-laravel-boost-con-claude-code-cursor-o-codex) - [Mantener Boost al día](#mantener-boost-al-dia-con-boost-update) - [Cuándo instalarlo](#cuando-instalar-laravel-boost-y-cuando-esperar) ## 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](/post/introduccion-a-mcp-model-context-protocol) 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](https://github.com/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](/post/mcp-para-laravel), 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: ```shell 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: | Archivo | Qué contiene | Tamaño | |---|---|---| | `AGENTS.md` | Siete guías: Boost, PHP, Laravel, PHPUnit, Pint, despliegue y bases del proyecto | 10.166 bytes | | `.mcp.json` | El registro del servidor `laravel-boost` | 1 servidor | | `boost.json` | Qué instaló Boost: guías, skills y MCP | 5 skills listadas | | `.claude/skills/` y `.agents/skills/` | Las skills, una copia por agente | unos 148 KB cada copia | 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](/post/agents-md-que-es-que-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: | Herramienta | Qué hace | |---|---| | `application-info` | Versiones de PHP y Laravel, motor de base de datos, paquetes instalados y modelos Eloquent | | `database-schema` | Tablas, columnas, índices y claves foráneas | | `database-query` | Consultas SQL de solo lectura | | `database-connections` | Las conexiones configuradas | | `read-log-entries` | Las últimas N entradas del log de la aplicación | | `last-error` | La última excepción del backend | | `browser-logs` | Logs y errores del navegador | | `get-absolute-url` | La URL absoluta de un path o de una ruta con nombre | | `search-docs` | Búsqueda en la documentación de tus versiones | | `record-rule` | Guarda una regla del proyecto en `.ai/rules` | 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](/post/mcp-get-sse-timeout-serverless). ### 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](/post/skills-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](/post/medir-contexto-claude-code-shunt-spotify). 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()](/post/key-fantasma-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: ```shell # 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: ```json { "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](/post/claude-code-proyecto-laravel). ## 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: ```json { "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](/post/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](/post/mcp-para-laravel), y el mapa completo está en [IA para desarrolladores Laravel](/post/ia-para-desarrolladores-laravel). ## Preguntas frecuentes ### ¿Laravel Boost es gratis? Sí. El paquete es de código abierto con licencia MIT y se instala desde Packagist con `composer require laravel/boost --dev`. ### ¿Laravel Boost funciona en producción? No debería. Boost solo arranca si `APP_ENV` es `local` o si `APP_DEBUG` es `true`, y al ser una dependencia `--dev`, `composer install --no-dev` lo deja fuera. Con `APP_ENV=production` y `APP_DEBUG=false`, Artisan no encuentra ningún comando `boost`. ### ¿Qué diferencia hay entre Laravel Boost y Laravel MCP? Boost es un servidor MCP ya hecho que ayuda a tu agente a programar tu app. [Laravel MCP](/post/mcp-para-laravel) es el paquete para construir tus propios servidores MCP y exponer tu aplicación a clientes como ChatGPT o Claude. Boost está construido sobre Laravel MCP. ### ¿Qué versiones de Laravel y PHP soporta Laravel Boost? La versión 2.10.0 pide PHP 8.2 o superior y Laravel 11.45.3, 12.41.1 o 13. Laravel 10 queda fuera. ### ¿Tengo que subir AGENTS.md y .mcp.json al repositorio? No hace falta: la documentación permite ignorar `.mcp.json`, `CLAUDE.md`, `AGENTS.md` y `boost.json` porque `boost:install` y `boost:update` los regeneran. Las reglas de `.ai/rules` conviene commitearlas para que las herede el equipo. ## Fuentes - [Documentación oficial de Laravel Boost](https://laravel.com/docs/boost) - [Repositorio laravel/boost en GitHub](https://github.com/laravel/boost), código de la versión 2.10.0 - [laravel/boost en Packagist](https://packagist.org/packages/laravel/boost) - [Esqueleto laravel/laravel v13.10.1](https://github.com/laravel/laravel/tree/v13.10.1) --- ## Sitemap Índice completo del sitio: [/sitemap.md](https://www.angelcruz.dev/sitemap.md) Canónico HTML: [https://www.angelcruz.dev/post/laravel-boost-que-es-como-usarlo](https://www.angelcruz.dev/post/laravel-boost-que-es-como-usarlo)