Laravel MCP 1.0 lar agenten søke opp verktøy i stedet for å laste hele katalogen

Der en MCP-server hittil har måttet sende hele verktøykatalogen inn i modellens kontekstvindu, kan Laravel MCP 1.0 legge de sjeldne verktøyene bak et søk. Laravel News beskriver ToolSearch, der du beholder de vanlige verktøyene i hovedlisten og skyver resten inn i en søkbar katalog. Pakken registrerer to verktøy for å håndtere det: search_tools gir treff med navn, beskrivelse og forventede inndata, og execute_tools kjører ett eller flere av dem ved navn.

Resten av utgivelsen følger protokollrevisjonen 2026-07-28. Håndtrykket initialize er byttet ut med server/discover, og serveren behandler hver forespørsel for seg. Headeren MCP-Session-Id, metodene Request::sessionId() og Request::setSessionId() og hendelsen SessionInitialized er fjernet, så skal du knytte sammen kall må du sende din egen identifikator i argumentene eller i _meta. Eldre klienter som fortsatt kobler til med initialize fungerer: serveren svarer da med protokollversjon 2025-11-25 eller 2025-06-18, avhengig av hva klienten ber om.

Cache-hint er nytt: serveren forteller klienten hvilke svar som kan gjenbrukes, hvor lenge, og om de kan deles på tvers av brukere. Standarden settes med attributtet Cacheable og overstyres per metode med cacheHints(). Verktøykall caches aldri. OAuth krever nå PKCE, og client_id kan være en HTTPS-URL til et JSON-dokument som beskriver klienten. Bruker du den formen, er $token->clientSecret null, så databasekolonnen må tåle null.

Oppgraderer du fra 0.9, er det headerne som biter. Mellomvaren ValidateMcpHeaders kjører på alle ruter registrert via Mcp::web(), og POST-forespørsler i den nye protokollen må ha MCP-Protocol-Version og Mcp-Method som stemmer med kroppen. Kall til tools/call, prompts/get og resources/read trenger i tillegg Mcp-Name. Avvik gir HTTP 400 med JSON-RPC-feilkode -32020, og testene dine som sender postJson() må ha både headerne og feltene i params._meta.

Hva bør du gjøre?

1. Søk etter MCP-Session-Id og Request::sessionId() i koden din før du oppgraderer. Begge er borte i 1.0, og tilstand må flyttes til en egen identifikator i _meta.
2. Flytt de sjeldent brukte verktøyene bak ToolSearch og mål hvor mye kontekst verktøydefinisjonene spiser før og etter.
3. Kjør testsuiten mot den nye mellomvaren først. Mangler en header, får du 400 og feilkode -32020, ikke en beskrivende feilmelding.