Guide
MCP Apps : interfaces interactives dans le chat
MCP Apps permet à un serveur MCP d'afficher un formulaire ou un tableau de bord dans la conversation : fonctionnement, sécurité, clients compatibles.
Mis à jour le
Un serveur MCP (Model Context Protocol) renvoie normalement du texte, des images, des ressources ou des données structurées. L'extension MCP Apps va plus loin : le serveur peut renvoyer une interface HTML interactive (graphique, formulaire, tableau de bord) qui s'affiche directement dans la conversation. Page rédigée d'après la documentation officielle lue le 16/11/2026.
Pour comparer les outils à exposer dans une interface, consultez le catalogue MCP d’ALMA. Le support d’outils MCP ne garantit pas celui de MCP Apps : confirmez l’extension des deux côtés avant de prévoir une interface HTML.
À quoi ça sert
La documentation part d'un constat : le texte a des limites, et parfois l'utilisateur doit manipuler les données, pas seulement les lire. Elle donne cinq situations où une MCP App apporte quelque chose :
- Explorer des données complexes : une carte où l'on clique sur une région pour détailler, plutôt qu'une liste de chiffres.
- Configurer avec beaucoup d'options : un formulaire qui présente tous les choix d'un coup, plutôt qu'un échange de questions.
- Voir des médias riches : un lecteur de PDF ou de modèle 3D intégré.
- Suivre en temps réel : un tableau de bord qui se met à jour sans qu'on redemande l'état.
- Enchaîner des étapes : approuver des notes de frais ou trier des tickets avec boutons de navigation et état conservé.
Pourquoi pas une simple application web avec un lien ? La documentation avance quatre avantages : l'application reste dans la conversation (on ne perd pas son fil), elle peut appeler les outils du serveur dans les deux sens sans bâtir sa propre interface de programmation ni sa propre authentification, elle peut déléguer des actions à l'hôte avec l'accord de l'utilisateur, et elle tourne dans un bac à sable. Si votre cas n'a besoin d'aucune de ces propriétés, une application web classique sera plus simple, dit la documentation.
Comment ça marche
Le principe combine deux briques déjà connues de MCP : un outil et une ressource. La description de l'outil déclare une référence vers l'interface ; l'interface elle-même est une ressource. Quand le modèle décide d'appeler un tel outil :
- Préchargement : la description de l'outil contient un champ
_meta.ui.resourceUriqui pointe vers une ressourceui://. L'hôte peut la charger avant même l'appel. - Récupération : l'hôte demande la ressource au serveur. C'est une page HTML, souvent livrée avec son JavaScript et son CSS. Les origines externes autorisées se déclarent dans
_meta.ui.csp. - Affichage isolé : les hôtes web affichent le HTML dans une iframe en bac à sable. L'objet
_meta.uipeut aussi demander despermissions(microphone, caméra par exemple). - Dialogue : l'application et l'hôte échangent en JSON-RPC, un dialecte de MCP. Certains messages sont communs (
tools/call), d'autres propres aux applications, avec le préfixeui/(ui/initialize). Le transport estpostMessage, pas stdio ni HTTP.
L'application peut ainsi demander un appel d'outil, envoyer un message, mettre à jour le contexte du modèle et recevoir des données de l'hôte, tout en restant isolée.
Le modèle de sécurité
Le bac à sable empêche l'application d'accéder au DOM de la page parente, de lire les cookies ou le stockage local de l'hôte, de naviguer dans la page parente ou d'y exécuter des scripts. Toute communication passe par l'API postMessage, et l'hôte décide de ce que l'application peut faire : il peut par exemple limiter les outils appelables ou désactiver sendOpenLink. Les hôtes peuvent ainsi afficher des applications tierces sans faire une confiance totale à l'auteur du serveur.
Cela ne dispense pas du reste : un serveur qui expose une interface reste un serveur à auditer, voir la sécurité des serveurs MCP.
Quels clients la prennent en charge
Au 16/11/2026, la documentation cite Claude, Claude Desktop, GitHub Copilot dans VS Code, Microsoft 365 Copilot, Goose, Postman, MCPJam et Archestra.AI, et renvoie vers une matrice de compatibilité des extensions par client. Cette extension est facultative : vérifiez les capacités et les réglages de votre client avant de bâtir dessus.
Concevoir un repli sans interface
Pour un tableau de suivi des tickets, gardez un résultat textuel ou structuré compréhensible si le client n'affiche pas l'application. Faites porter les autorisations par le serveur : masquer un bouton dans l'interface ne bloque pas un appel direct à l'outil correspondant.
Avant une ouverture à l'équipe, testez un client compatible et un client sans MCP Apps, une ressource HTML indisponible et une action refusée. Vérifiez que l'utilisateur voit une explication utile et qu'un double clic ne déclenche pas deux modifications. Ces essais sont proposés pour votre intégration ; la présence de l'extension ne garantit pas ces comportements métier.
Par où commencer
La documentation propose un guide « Build an MCP App » et des modèles de départ pour React, Vue, Svelte, Preact, Solid et JavaScript sans framework, dans le dépôt ext-apps. Pour les briques de base, voir outils, ressources et prompts et comment fonctionne MCP.
Questions fréquentes
MCP Apps fait-il partie de la spécification de base de MCP ?
Non, c'est une extension. La documentation précise que la prise en charge varie selon les clients.
Une MCP App peut-elle accéder aux cookies de l'application hôte ?
Non : elle s'exécute dans une iframe isolée par l'hôte et ne peut ni lire les cookies ou le stockage local de l'hôte, ni accéder à son DOM, d'après la documentation.
Faut-il un framework particulier pour écrire une MCP App ?
Non. La communication passe par des primitives web standard (postMessage), donc n'importe quel framework convient, ou aucun. La classe App du paquet @modelcontextprotocol/ext-apps est un confort, pas une obligation.
Références du carnet
Pages consultées pour écrire cet article :