/ Annuaire / Playground / MCP Apps Protocol
● Officiel modelcontextprotocol ⚡ Instantané

MCP Apps Protocol

par modelcontextprotocol · modelcontextprotocol/ext-apps

L'extension officielle qui permet aux serveurs MCP de livrer des fragments d'UI interactifs — Claude intègre votre formulaire, graphique ou sélecteur directement dans la conversation.

MCP Apps est une extension officiellement approuvée de MCP permettant aux serveurs de déclarer des IUs interactives (formulaires, graphiques, sélecteurs) que l'hôte chatbot affiche. Ce dépôt contient la spec, le SDK de référence et les exemples.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-apps-protocol",
      "args": []
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-apps-protocol": {
      "command": {
        "args": []
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add mcp-apps-protocol -- undefined 

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : MCP Apps Protocol

Ajouter une confirmation par formulaire à un outil MCP

👤 Développeurs ⏱ ~15 min intermediate

Quand l'utiliser : Un outil a des effets de bord destructeurs ; vous souhaitez une confirmation utilisateur avant exécution.

Déroulement
  1. Lire la spec
    Parcourez la section Apps de la spec.✓ Copié
    → Modèle mental acquis
  2. Ajouter le fragment UI
    Retournez un composant App depuis votre gestionnaire d'outil.✓ Copié
    → L'hôte affiche le formulaire
  3. Connecter la soumission
    À la soumission, l'outil se ré-invoque avec les arguments confirmés.✓ Copié
    → Outil destructeur plus sûr

Résultat : Vos outils MCP peuvent demander des confirmations structurées.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcp-apps-protocol + fastmcp

Utiliser fastmcp comme serveur MCP ; Apps pour les parties interactives

Combiner mcp-apps-protocol avec fastmcp : fastmcp pour le serveur MCP, Apps pour les parties interactives✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
protocol-spec (voir la documentation) Pas d'outils appelables — c'est une extension de protocole 1 appel

Coût et limites

Coût d'exécution

Quota d'API
N/A
Tokens par appel
0
Monétaire
Gratuit
Astuce
Gardez les Apps légères — elles sont rendues inline

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucune
Sortie de données : Aucune

Dépannage

Erreurs courantes et correctifs

L'hôte n'affiche pas l'App

Confirmez que l'hôte supporte l'extension Apps ; c'est opt-in

Alternatives

MCP Apps Protocol vs autres

AlternativeQuand l'utiliserCompromis
Outil simple avec confirmation par promptL'hôte ne supporte pas AppsPas de saisie structurée

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills