WebMCP en Laravel: añada herramientas para agentes de IA a su aplicación PHP

Una aplicación Laravel ya tiene lo que necesitan las herramientas WebMCP: rutas, validación, políticas y sesión. Solo tiene que añadir un pequeño script a la página. ¿Es nuevo en el tema? Empiece por qué es WebMCP.

Paso 1: Una pequeña ruta JSON

Use una ruta en routes/web.php para que se aplique la sesión del visitante y añada un límite de peticiones:

Route::get('/agent/products', function (Illuminate\Http\Request $request) {
    $data = $request->validate(['q' => 'required|string|max:80']);

    return App\Models\Product::query()
        ->where('published', true)
        ->where('name', 'like', '%'.$data['q'].'%')
        ->limit(5)
        ->get(['name', 'price', 'slug']);
})->middleware('throttle:30,1');

Seleccione solo las columnas que un cliente puede ver. Nunca devuelva un modelo completo.

Paso 2: Registre la herramienta en Blade

Añada un script a su layout, o inclúyalo solo en las páginas que lo necesiten:

@push('scripts')
<script>
  const mc = document.modelContext || navigator.modelContext;
  if (mc && mc.registerTool) {
    mc.registerTool({
      name: 'search_products',
      description: 'Search published products. Returns name, price and slug.',
      inputSchema: {
        type: 'object',
        properties: { q: { type: 'string', description: 'Keywords' } },
        required: ['q'],
      },
      annotations: { readOnlyHint: true },
      execute: async ({ q }) => {
        const res = await fetch('/agent/products?q=' + encodeURIComponent(q));
        return await res.text();
      },
    });
  }
</script>
@endpush

Paso 3: Formularios Blade como herramientas

Añada toolname y tooldescription a un formulario que ya tenga. Los campos con etiqueta se convierten en las entradas de la herramienta. Mantenga @csrf en su sitio. El navegador rellena el formulario y, por defecto, el visitante pulsa el botón.

Paso 4: Acciones sensibles

En una herramienta POST, envíe el token CSRF en la cabecera X-CSRF-TOKEN y autorice la acción con una política, como siempre. Marque la herramienta con consequentialHint: true.

Reglas de seguridad

• Empiece con solo lectura. Primero búsqueda y detalles; márquelos con readOnlyHint.
• Pregunte antes de actuar. Marque las acciones de carrito, reserva y formularios con consequentialHint para que el visitante confirme.
• Compruebe en el servidor. El navegador no es una barrera de seguridad, así que valide cada entrada y cada permiso en su backend.
• Devuelva lo mínimo. Envíe solo lo que un cliente puede ver, nunca datos de administración ni registros de otros clientes.

Pruébelo

1. Use una versión reciente de Chrome con WebMCP activado, mediante la prueba de origen o la opción de pruebas.
2. Llame a cada herramienta con entradas correctas e incorrectas.
3. Compruebe que los visitantes normales no notan ningún cambio.
4. Ejecute el comprobador WebMCP gratuito en la página exacta donde están sus herramientas.

¿Prefiere que lo hagamos por usted?

Añadimos WebMCP a aplicaciones Laravel y PHP. Conozca nuestros servicios de integración de WebMCP, o revise su versión actual de PHP con nuestro comprobador gratuito de versiones de PHP.