MCP para Laravel: conecta tu app con la IA

Si programas en Laravel, el Model Context Protocol (MCP) te toca por dos caminos oficiales, y conviene no confundirlos:

• Laravel Boost: un servidor MCP que le da a tu agente de IA (Claude Code, Cursor) contexto de tu aplicación para que escriba mejor Laravel.
• Laravel MCP: un paquete para construir tus propios servidores MCP dentro de tu app y exponerla a clientes externos como ChatGPT, Claude o Cursor.

Uno es para codear con IA; el otro es para que la IA use tu app. Vamos con cada uno.

Laravel Boost: que tu agente escriba mejor Laravel

El problema real: los LLM están entrenados con datos viejos, así que "alucinan" APIs que ya no existen o ignoran features recientes de Laravel. Laravel Boost lo arregla dándole al agente contexto de tu proyecto y documentación siempre actualizada.

Se instala como dependencia de desarrollo:

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

El comando boost:install detecta tu editor/agente (Claude Code, Cursor, Codex, Gemini CLI, Copilot, Junie) y genera la configuración MCP y los archivos de guías. Boost te da tres cosas:

1. Herramientas MCP para que el agente inspeccione tu app de verdad, entre ellas:

• Application Info: versiones de PHP y Laravel, paquetes instalados y modelos Eloquent.
• Database Schema y Database Query: leer el esquema y consultar la base de datos.
• Read Log Entries / Last Error / Browser Logs: leer logs y errores.
• Search Docs: consultar la API de documentación de Laravel.

2. AI Guidelines y Agent Skills: convenciones y patrones del ecosistema (Laravel, Livewire, Inertia, Pest, Tailwind, Flux…) que el agente carga para generar código idiomático y en la versión correcta.

3. API de documentación: más de 17.000 fragmentos de documentación de Laravel con búsqueda semántica, filtrada a las versiones que usas. Como dijo Taylor Otwell: si Laravel publica una feature el martes, el LLM no la conoce, pero Boost sí se la puede pasar.

Si tu agente no lo detecta solo, en Claude Code lo registras a mano:

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

O con el .mcp.json manual:

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

Laravel MCP: expón tu app a ChatGPT, Claude o Cursor

El otro camino es al revés: en vez de que la IA te ayude a programar, tu aplicación se vuelve una herramienta que la IA puede usar. Eso es construir un servidor MCP, y Laravel tiene un paquete oficial para hacerlo sin salir de tu app:

composer require laravel/mcp

Un servidor MCP en Laravel expone las tres primitivas del protocolo:

• Tools: acciones que el agente puede ejecutar (crear una factura, disparar un flujo, consultar datos). Cualquier cosa que puedas codear puede ser una tool.
• Resources: contenido que el cliente puede leer como contexto (documentos, registros, config).
• Prompts: plantillas de prompt reutilizables.

El ejemplo canónico: una app de facturación expone una tool CreateInvoice. Un usuario le dice a ChatGPT "crea una factura para Acme por 2.400 dólares", y la tool valida con las reglas de Laravel, crea el registro y devuelve una respuesta estructurada. El usuario nunca salió de su chat.

Los servidores pueden ser locales (un comando Artisan) o web (HTTP), con autenticación vía Laravel Passport (OAuth) o Sanctum (tokens). Dato interesante: Boost está construido sobre Laravel MCP; cada tool de Boost (Schema, Tinker) es una tool MCP hecha con este mismo paquete.

¿Cuál necesitas?

Laravel tiene tres piezas de IA y es fácil mezclarlas. La regla rápida:

No son excluyentes: una app puede usar las tres. Si estás empezando, instala Boost primero: mejora de inmediato la calidad del código que tu agente genera.

Preguntas frecuentes

¿Qué es Laravel Boost?

Es un paquete oficial de Laravel que corre como servidor MCP en tu entorno local y le da a tu agente de IA (Claude Code, Cursor, etc.) contexto de tu app (esquema, modelos, logs) y documentación actualizada, para que escriba código Laravel idiomático y en la versión correcta.

¿Cómo instalo Laravel Boost?

Con composer require laravel/boost --dev y luego php artisan boost:install, que configura el servidor MCP y las guías para el agente que uses.

¿Cuál es la diferencia entre Laravel Boost y Laravel MCP?

Boost es un servidor MCP listo para codear con IA (te ayuda a ti). Laravel MCP es un paquete para construir tus propios servidores MCP y exponer tu app a clientes de IA externos. De hecho, Boost está construido sobre Laravel MCP.

¿Puedo exponer mi app Laravel a ChatGPT o Claude?

Sí: con Laravel MCP defines tools, resources y prompts, y expones un servidor (local o HTTP, con auth vía Passport o Sanctum) que ChatGPT, Claude o Cursor pueden usar para actuar sobre tu aplicación.