MCP en Laravel: qué es el Model Context Protocol y cómo conectar Claude Code a tu proyecto

MCP (Model Context Protocol) es un estándar abierto, publicado por Anthropic en 2024, que define cómo un agente de IA se conecta a herramientas y datos externos. En MadBuilder, permite que Claude Code, Cursor u otro cliente MCP cree pantallas, genere registros, modele la base de datos y publique un proyecto Laravel, con un token por proyecto y cada llamada registrada.

Qué es MCP (Model Context Protocol)

Un agente de IA solo sabe lo que hay en la conversación. Para consultar una base de datos o tocar un sistema, alguien tiene que conectarlo a esas cosas, y antes de MCP cada conexión se hacía de una forma distinta, para cada herramienta y cada agente.

MCP estandariza esa conversación. Por un lado, el servidor MCP expone herramientas: acciones con nombre, descripción y parámetros, como “listar pedidos”. Por el otro, el cliente MCP, la app donde corre el agente, pregunta qué ofrece el servidor, y el modelo decide cuándo llamar a cada herramienta.

Dos puntos ayudan a no confundirse:

• MCP no es un modelo de IA. Es el protocolo entre el agente y las herramientas, y un servidor atiende a cualquier cliente que hable MCP.
• El protocolo define cómo pedir. Qué herramientas existen y quién puede usar cada una lo decide quien monta el servidor.

Claude Code, el agente de programación de Anthropic que corre en la terminal, es un cliente MCP. Cursor también lo es.

Por qué MCP importa si mantienes sistemas Laravel

Si ya usas Claude Code en un repositorio Laravel, conoces su forma de trabajar: lee los archivos, deduce la estructura y escribe código. Funciona, pero cada registro nuevo sale escrito a mano: migration, model, controller, vista, validación y el HTML, el CSS y el JS de cada campo.

Con un servidor MCP, el agente cambia parte de esa deducción por herramientas hechas para el trabajo. En vez de escribir varios archivos para armar un registro, llama a una acción que lo genera, en el mismo proyecto donde trabaja tu equipo.

El otro motivo es el control. Darle a un agente permiso de escritura en un sistema real exige respuestas claras: qué puede hacer, cómo cortar el acceso y dónde queda el registro. Eso lo responde el servidor que conectas, no el protocolo.

Qué expone MadBuilder por MCP

MadBuilder genera un proyecto Laravel común: models Eloquent, migrations, controllers, rutas y vistas en Blade con Alpine. El proyecto también trae el framework MAD en la carpeta packages/, de donde vienen los componentes <mad-*> y la clase base MadComponent. Mira en detalle qué entra en el proyecto Laravel generado.

El MCP Gateway te deja usar las herramientas del agente de MadBuilder fuera del editor. Por MCP, tu agente puede:

• crear pantallas;
• generar registros;
• modelar la base de datos;
• publicar.

Todo ocurre en el mismo proyecto que el equipo edita en el visual, en PHP y en Blade. ¿Quieres leer el código antes de conectar un agente? La página de MadBuilder para devs muestra los archivos que genera una pantalla.

Cómo conectar Claude Code a un proyecto en MadBuilder

La conexión es un solo comando:

claude mcp add madbuilder --token mgw_… --project 1042

• madbuilder es el nombre con el que el servidor aparece en tu Claude Code.
• --token recibe el token del proyecto, que empieza con mgw_.
• --project indica el proyecto en el que trabajará el agente. El 1042 es solo un ejemplo.

Después, solo pide en español. ¿No usas Claude Code? Cursor o cualquier otro cliente MCP también se conecta.

Los controles de acceso

• Un token por proyecto. Cada proyecto tiene su token exclusivo.
• Herramienta por herramienta. Cada token tiene una lista de herramientas habilitadas, y tú decides qué entra en ella.
• Revocación al instante. Si el token se filtra o el trabajo termina, lo revocas y el acceso se corta ahí.
• Cada llamada registrada. Toda llamada queda auditada, así que después puedes comprobar qué hizo el agente.

Para empezar, habilita las herramientas de modelar la base de datos y crear pantallas, revisa el resultado en el editor y solo después habilita la publicación, como harías con un dev nuevo en el equipo.

En qué plan está el MCP Gateway

En la tabla de precios, el ítem “Acceso desde otros agentes de IA (MCP Gateway)” está incluido en el plan Pro IA, con precio por desarrollador al año. Los planes inferiores no lo traen. El Mad Coding Plan, un complemento mensual, habilita el agente, el MCP Gateway y el Embed Chat en el plan Pro.

Tu agente o el nuestro

Conectar Claude Code no le quita nada al editor. MadBuilder tiene un agente propio, que lee la base de datos, crea tablas y genera pantallas en el mismo proyecto. Escribe la etiqueta del componente MAD, no el HTML, el CSS y el JS que hay detrás, y por eso gasta entre un 65% y un 75% menos de tokens. Mira un fragmento de un formulario generado:

<mad-form-grid :cols="2">
    <mad-money-field name="total" label="Total" prefix="$" :decimals="2" :readonly="true" />
    <mad-input-field data-mad-column-id="4536" data-mad-entity-id="693" name="status" label="Status" />
</mad-form-grid>

Cada línea es un campo completo. El resto vive en el componente, dentro del framework MAD.

En él, usas tu propia clave (Anthropic, OpenRouter, xAI, Z.AI o Ark) o el Mad Coding Plan. En el modo de planificación, propone un plan sin tocar nada y solo escribe lo que apruebes, ítem por ítem. Mira más sobre el agente de IA que arma pantallas y base de datos.

El otro lado: el sistema generado se vuelve herramienta de IA

Hasta aquí, MCP sirvió para construir. También sirve para operar: publicado como herramienta de IA, el sistema que generaste pasa a ser operado por los agentes de IA de tu empresa, por MCP, con permisos definidos y auditoría de cada acción. En el paso a paso de MadBuilder, esto aparece como una etapa opcional, después de la publicación.

La configuración de ese servidor MCP está en 9 pantallas. Algunas de ellas:

• Resumen: muestra si la configuración es válida, la dirección del servidor y lo que falta para que el agente trabaje bien.
• Contexto del sistema: el texto que el agente lee antes de cualquier llamada.
• Entidades y herramientas: eliges qué models se vuelven herramienta y con qué acciones.
• Permisos por perfil: la matriz que decide quién puede hacer qué.

También proteges los datos personales campo por campo, y una configuración con errores se rechaza. Mira las pantallas en administración y seguridad del sistema generado.

El copiloto que puedes incrustar en la app del cliente sigue la misma lógica: opera los datos por MCP, solo usa las herramientas que el usuario tiene permiso de usar y registra cada acción.

Punto	Tu agente en MadBuilder	Agentes en el sistema publicado
Para qué	Construir: pantallas, registros, base de datos y publicación	Operar el sistema y sus datos
Quién conecta	El dev, con Claude Code, Cursor u otro cliente MCP	Los agentes de IA de la empresa
Control	Token por proyecto, herramienta por herramienta, revocación al instante	Herramientas elegidas, permisos por perfil, datos personales protegidos
Registro	Cada llamada registrada	Auditoría de cada acción

Preguntas frecuentes

¿Qué es MCP, en pocas palabras?

Es un estándar abierto, publicado por Anthropic en 2024, para conectar agentes de IA con herramientas externas. Un servidor MCP expone acciones, y cualquier cliente compatible puede llamarlas.

¿Necesito usar Claude Code para trabajar con MadBuilder?

No. Cursor o cualquier cliente MCP también se conecta. O usa el agente del propio MadBuilder, con tu clave de API o con el Mad Coding Plan.

¿Se puede cortar el acceso de un agente conectado?

Sí. El token es por proyecto y se puede revocar al instante. Y como cada llamada queda registrada, ves lo que hizo el agente hasta ese momento.

¿En qué plan está el MCP Gateway?

En Pro IA. En Pro, lo habilita el Mad Coding Plan, un complemento mensual. Mira también la respuesta sobre conectar tu propio agente de IA.