Cartes interactives

Dans l’app Claude, chaque résultat d’outil VibeSell s’affiche sous forme de carte : le nombre de leads, les personnes d’un aperçu, les forfaits, vos domaines et vos boîtes d’envoi, la campagne, une approbation avec ses boutons Approve et Reject. Les cartes ci-dessous sont la vraie carte VibeSell, alimentée par des données d’exemple — essayez les boutons.

Aperçu · données d'exempleestimate_lead_pool

estimate_lead_pool — le nombre, les filtres recherchés et un bouton pour prévisualiser des personnes.

Aperçu · données d'exempleorder_sending_setup

order_sending_setup — une carte d'approbation. Approve ou Reject : rien ne sort de cette page.

Fonctionnement

La carte suit l’extension MCP Apps :

1. Chaque outil déclare la carte dans _meta.ui.resourceUri — ui://vibesell/card-2f87d8dc967b.
2. Le client lit cette ressource une seule fois : un unique document HTML autonome (text/html;profile=mcp-app), sans script distant.
3. Après chaque appel, le client transmet à la carte le structuredContent de l’outil ; la carte l’affiche selon son kind, avec les mots et l’ordre des écrans de l’app VibeSell.
4. La carte suit le thème clair ou sombre du client, et demande à ouvrir les liens (ui/open-link) — VibeSell, un profil LinkedIn — plutôt que de les ouvrir elle-même.

Les logos d’entreprise ne se chargent que depuis media.licdn.com et logo.clearbit.com ; ailleurs, la politique de sécurité de contenu du client les bloque et la carte affiche des initiales à la place.

Questions sur une carte

Les outils qui vous demandent quelque chose — la source d’envoi, les noms de domaine, chaque email de la séquence — affichent leurs choix sous forme de boutons. Un clic rappelle le même outil avec votre réponse, exactement comme le ferait l’assistant.

Aperçu · données d'exemplechoose_sending_source

choose_sending_source — cliquez sur un choix.

Aperçu · données d'exemplepropose_domains

propose_domains — toute l'infrastructure, noms et adresses, à garder ou à changer.

Approve et Reject

Sur une carte d’approbation, Approve et Reject appellent decide_approval, un outil que l’app Claude cache au modèle (_meta.ui.visibility: ["app"]). Seul votre clic peut l’appeler. Voir Cartes d’approbation.

Dites à votre assistant ce que vous avez cliqué

La carte transmet votre clic au contexte du modèle de Claude, mais Claude ne le relaie pas encore au modèle. Après un clic, dites ce que vous avez fait — l’assistant relit alors l’état (list_pending_approvals, get_sending_setup, get_campaign).

Une campagne, avant et après le lancement

Aperçu · données d'exempleget_campaign

get_campaign — une campagne préparée et ses quatre chiffres de lancement.

Aperçu · données d'exempleget_campaign

get_campaign — une campagne en cours d'envoi et les compteurs du fournisseur.

Dans Claude : « Interactive tools »

Comme chaque outil VibeSell déclare la carte, Claude les liste sous Interactive tools dans les réglages du connecteur. Comme les outils de tout connecteur, ils démarrent sur Needs approval ; passez-les sur Always allow pour que Claude cesse de demander avant chaque appel. Les cartes d’approbation attendent toujours votre clic.

La carte est mise en cache

Claude garde une carte par son adresse jusqu’à ce que vous ouvriez une nouvelle conversation. L’adresse de la carte se termine par une empreinte de son code : une nouvelle version obtient donc une nouvelle adresse ; toute ancienne adresse renvoie toujours la carte du jour, si bien qu’une conversation qui a gardé une ancienne liste d’outils continue de fonctionner.

Si une carte semble dépassée après une mise à jour, démarrez une nouvelle conversation.

Clients texte

Codex, Claude Code et les autres clients qui n’affichent pas les MCP Apps ignorent la carte. Ils reçoivent le même structuredContent et un résumé Markdown dans content[0].text, et l’outil réservé à la carte, decide_approval, ne leur est pas listé : les cartes d’approbation se décident dans l’app VibeSell.