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.

¿Quieres el mapa completo? Este post es parte de la guía IA para desarrolladores Laravel, que ordena todo: codear con Claude Code, exponer tu app con MCP y las piezas oficiales del ecosistema.

Preguntas frecuentes