
ChatGPT MCP App TypeScript Template
Interface UIpar pomerium
Template de démarrage prêt pour la production pour créer des Apps MCP avec des widgets React, TypeScript, Tailwind CSS v4 et Storybook.
Ce qu'il fait
Template de démarrage complet pour App MCP qui vous permet de déployer des widgets React interactifs directement dans les interfaces de chat IA. Créé par l'équipe Pomerium, il relie un serveur MCP, un pipeline de build de widgets React et toute la plomberie nécessaire pour obtenir un rendu UI dans ChatGPT, Claude, VS Code Copilot et d'autres hôtes compatibles Apps MCP en moins de 5 minutes.
Fonctionnalités clés
- Outil Echo avec widget interactif — exemple fonctionnel de bout en bout : invocation de l'outil → UI React rendue en ligne dans le chat
- Commutation du mode d'affichage — en ligne, picture-in-picture et plein écran avec basculement au runtime via
requestDisplayMode() - Négociation des capacités UI — le serveur détecte automatiquement les capacités de l'hôte et repasse au texte brut pour les clients sans UI
- Assets de widgets en ligne — mode HTML autonome pour les hôtes iframe sandbox (Claude.ai)
- Tunnel SSH Pomerium — une seule commande (
ssh -R 0 pom.run) expose publiquement le serveur de dev local pour les tests ChatGPT - Configuration de test complète — Vitest pour le serveur + les widgets, Storybook avec addon a11y, helper d'App simulée pour les tests de composants isolés
Installation
Claude Desktop
Ce template s'exécute comme votre propre serveur hébergé. Clonez, buildz, déployez, puis ajoutez à claude_desktop_config.json :
{
"mcpServers": {
"my-app": {
"command": "node",
"args": ["/path/to/your-app/server/dist/server.js"]
}
}
}
VS Code Copilot / ChatGPT (HTTP)
git clone https://github.com/pomerium/chatgpt-app-typescript-template your-app
cd your-app && npm install && npm run dev
# Exposer : ssh -R 0 pom.run
# Ajouter https://<tunnel-url>/mcp comme connecteur
Claude.ai web
Exécutez avec npm run dev:inline, exposez via tunnel, puis ajoutez l'URL /mcp dans Claude.ai Settings → Integrations.
Hôtes supportés
ChatGPT (principal), Claude Desktop, Claude.ai, VS Code Copilot, Goose, Cursor — tout client compatible Apps MCP.
Installation rapide
git clone https://github.com/pomerium/chatgpt-app-typescript-template my-mcp-app && cd my-mcp-app && npm install && npm run dev





