WebMCP in Laravel: KI-Agenten-Tools für Ihre PHP-App

Eine Laravel-App hat bereits alles, was WebMCP-Tools brauchen: Routen, Validierung, Policies und eine Sitzung. Sie ergänzen nur ein kleines Skript auf der Seite. Ist das Thema neu für Sie? Lesen Sie zuerst, was WebMCP ist.

Schritt 1: Eine kleine JSON-Route

Nutzen Sie eine Route in routes/web.php, damit die Sitzung des Besuchers gilt, und ergänzen Sie ein Rate Limit:

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');

Wählen Sie nur die Spalten aus, die ein Kunde sehen darf. Geben Sie niemals ein ganzes Model zurück.

Schritt 2: Das Tool in Blade registrieren

Fügen Sie ein Skript in Ihr Layout ein, oder laden Sie es per Push nur auf den Seiten, die es brauchen:

@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

Schritt 3: Blade-Formulare als Tools

Ergänzen Sie toolname und tooldescription in einem bestehenden Formular. Felder mit Label werden zu Eingaben des Tools. Lassen Sie @csrf stehen. Der Browser füllt das Formular aus, und den Button klickt standardmäßig der Besucher.

Schritt 4: Sensible Aktionen

Senden Sie bei einem POST-Tool das CSRF-Token im Header X-CSRF-TOKEN und autorisieren Sie die Aktion wie gewohnt mit einer Policy. Kennzeichnen Sie das Tool mit consequentialHint: true.

Sicherheitsregeln

• Starten Sie mit reinem Lesezugriff. Zuerst Suche und Details; kennzeichnen Sie diese mit readOnlyHint.
• Fragen Sie vor dem Handeln. Kennzeichnen Sie Warenkorb-, Buchungs- und Formularaktionen mit consequentialHint, damit der Besucher bestätigt.
• Prüfen Sie auf dem Server. Der Browser ist keine Sicherheitsgrenze. Prüfen Sie deshalb jede Eingabe und jede Berechtigung in Ihrem Backend.
• Geben Sie wenig zurück. Senden Sie nur, was ein Kunde sehen darf, niemals Admin-Daten oder Datensätze anderer Kunden.

Testen

1. Nutzen Sie ein aktuelles Chrome mit aktiviertem WebMCP, über den Origin Trial oder das Test-Flag.
2. Rufen Sie jedes Tool mit gültigen und ungültigen Eingaben auf.
3. Prüfen Sie, dass normale Besucher keine Änderung bemerken.
4. Prüfen Sie genau die Seite, auf der Ihre Tools liegen, mit dem kostenlosen WebMCP-Checker.

Sollen wir das für Sie übernehmen?

Wir bringen WebMCP in Laravel- und PHP-Apps. Sehen Sie sich unsere WebMCP-Integrationsservices an, oder prüfen Sie Ihre aktuelle PHP-Version mit unserem kostenlosen PHP-Versions-Checker.