Laravel MCP : connectez vos applications aux agents IA avec le Model Context Protocol

Les agents IA comme Claude, Cursor ou GitHub Copilot sont devenus des outils quotidiens pour de nombreux développeurs. Pourtant, sans contexte réel sur votre application, ces outils naviguent à l'aveugle : ils inventent des noms de colonnes, génèrent des routes inexistantes ou se basent sur une documentation qui ne correspond pas à vos versions installées. Laravel MCP répond précisément à ce problème.

Source originale : cet article s'appuie sur le guide officiel publié sur laravel.com/blog.

Qu'est-ce que le Model Context Protocol ?

Le Model Context Protocol (MCP) est un standard ouvert introduit par Anthropic en novembre 2024. Son objectif est de définir une manière unifiée pour les agents IA de communiquer avec des outils externes et des sources de données.

Avant MCP, chaque outil IA qui souhaitait interagir avec vos données devait construire sa propre intégration propriétaire. Le résultat : une multiplication des connecteurs incompatibles entre eux, difficiles à maintenir et à sécuriser.

MCP change la donne en proposant un seul protocole standard. Tout client compatible MCP — Claude, Cursor, GitHub Copilot, ChatGPT — peut se connecter à tout serveur compatible MCP, y compris celui que vous construisez avec Laravel.

Concrètement, une fois votre serveur MCP en place, votre agent IA peut :

• Interroger le schéma réel de votre base de données avant d'écrire une migration
• Lister les routes disponibles dans votre application
• Vérifier la version exacte de vos packages installés (Filament, Livewire, etc.)
• Exécuter des actions métier exposées via des outils dédiés

Le package laravel/mcp : construire un serveur MCP en Laravel

Le package officiel laravel/mcp est la brique fondamentale pour exposer les capacités de votre application Laravel à des clients IA externes. Il s'installe via Composer et s'intègre naturellement dans l'écosystème Laravel.

composer require laravel/mcp

Une fois installé, vous pouvez définir des ressources, des outils et des prompts que votre serveur MCP va exposer.

Les ressources

Une ressource MCP représente une source d'information que l'agent peut consulter. Dans un contexte Laravel, cela peut être :

• Le schéma de votre base de données
• La liste de vos routes
• Le contenu d'un fichier de configuration

use Laravel\MCP\Facades\MCP;

MCP::resource('database-schema', function () {
    return Schema::getAllTables();
});

Les outils

Un outil MCP est une action que l'agent peut déclencher. C'est ici que réside toute la puissance du protocole : vous pouvez exposer des actions métier complexes avec une interface claire et typée.

MCP::tool('get-orders', [
    'status' => 'string',
    'limit'  => 'integer',
], function (string $status, int $limit = 10) {
    return Order::where('status', $status)
        ->limit($limit)
        ->get();
});

L'agent IA reçoit la description de cet outil, comprend ses paramètres et peut l'appeler en autonomie dans le cadre d'une conversation ou d'une tâche de développement.

Les prompts

Les prompts MCP permettent de proposer des modèles de conversation préconfigurés à l'agent, adaptés à des cas d'usage récurrents de votre application.

Un double bénéfice : développement et production

L'un des aspects les plus intéressants de Laravel MCP est qu'il sert deux usages distincts mais complémentaires.

En phase de développement, votre serveur MCP devient un assistant de contexte pour votre propre agent IA. Fini les hallucinations sur vos migrations ou vos contrôleurs : l'agent interroge directement votre application pour obtenir des réponses précises. Vous gagnez en vitesse et en fiabilité.

En production, ce même serveur devient un point d'entrée pour vos utilisateurs finaux. Imaginez une application SaaS dont les utilisateurs pourraient interagir via leur propre client IA préféré. Votre serveur MCP expose des outils sécurisés, vos règles métier restent côté serveur, et l'interopérabilité est garantie par le standard.

Cette dualité est rare dans l'outillage Laravel : une même fonctionnalité améliore à la fois l'expérience développeur et la valeur produit.

Sécurité et bonnes pratiques

Exposer des capacités applicatives à des agents IA implique une attention particulière à la sécurité. Quelques principes fondamentaux à respecter :

Contrôlez ce que vous exposez. N'exposez pas l'intégralité de votre schéma ou de vos données sans réflexion. Définissez explicitement les ressources et outils pertinents.

Authentifiez vos clients MCP. Le protocole MCP supporte des mécanismes d'authentification. Utilisez-les pour vous assurer que seuls les clients autorisés peuvent interagir avec votre serveur.

Validez les entrées des outils. Comme pour tout endpoint Laravel, les paramètres reçus par vos outils MCP doivent être validés. Le package s'appuie sur les conventions Laravel, ce qui vous permet d'utiliser les Form Requests ou la validation intégrée.

Limitez les permissions par contexte. Un agent de développement n'a pas besoin des mêmes droits qu'un utilisateur final. Adaptez les capacités exposées selon le contexte d'utilisation.

Conclusion

Laravel MCP marque une étape importante dans l'évolution du framework. En adoptant le Model Context Protocol, Laravel ne se contente pas de suivre une tendance : il positionne les applications Laravel comme des acteurs de premier plan dans l'écosystème IA émergent.

Pour les équipes PHP/Symfony habituées à des intégrations IA sur mesure, MCP représente exactement le type de standardisation qui simplifie l'architecture et réduit la dette technique. Si vous travaillez en PHP avec d'autres frameworks, ce standard mérite votre attention : les implémentations MCP se multiplient rapidement dans tout l'écosystème web.

Que vous souhaitiez améliorer la pertinence de votre agent IA de développement ou enrichir votre produit d'une nouvelle interface pour vos utilisateurs, laravel/mcp offre une fondation solide, cohérente avec l'écosystème Laravel que vous connaissez déjà.