Skip to content

feat(site): built-for-ai MCP showcase#131

Merged
remigit55 merged 2 commits into
masterfrom
claude/built-for-ai-mcp-demo-zvd3dv
Jun 16, 2026
Merged

feat(site): built-for-ai MCP showcase#131
remigit55 merged 2 commits into
masterfrom
claude/built-for-ai-mcp-demo-zvd3dv

Conversation

@remigit55

Copy link
Copy Markdown
Collaborator

Built for AI — Modular consommable par un agent via MCP

Nouvelle page publique /built-for-ai qui met en scène le différenciateur : Blueprint Modular est nativement consommable par un agent IA via le serveur MCP. Aucun design system ne montre ça.

Ce que fait la page

  1. Section descriptive — les 4 outils MCP read-only (list_components, search_components, get_component, suggest_composition) + comment un agent se connecte (endpoint mcp.blueprint-modular.com).
  2. Démo interactive — champ libre / presets → suggest_compositionréponse brute affichée (ce que reçoit l'agent) → composition vérifiéerendu live des composants bpm.* correspondants.
  3. Vérification de cohérence — chaque suggestion est confirmée par get_component ; la composition ne référence que des composants réels du barrel.
  4. UI construite avec bpm.* (Input, Button, Badge, Chip, CodeBlock, Card, Message).

Intégration MCP (fiabilité d'abord)

  • Route interne /api/built-for-ai/suggest qui appelle la vraie logique d'outil du connecteur (lib/mcp/registry.suggestComposition + getComponent) in-process, read-only — plus fiable qu'un appel à l'hôte externe (injoignable depuis le serveur selon la politique réseau), tout en restant le vrai outil.
  • Double repli : erreur inattendue côté route → snapshot pré-capturé ; échec réseau côté client → même snapshot. Le snapshot est identique à la sortie live (vérifié) → la page de différenciation ne casse jamais devant un visiteur.
  • Zéro duplication : lib/mcp/tools.ts devient la source unique des métadonnées des 4 outils ; /mcp la réutilise désormais.

Contraintes respectées

  • Read-only de bout en bout (aucune capacité d'écriture exposée).
  • layout / style.css / règles 'use client' inchangées.
  • Définition des outils référencée, non recopiée.

Validation

  • npm run build ✅ (routes /built-for-ai et /api/built-for-ai/suggest présentes)
  • npm run test ✅ 83/83 · npm run gate ✅ GATE GREEN
  • curl localhost:3000/built-for-ai200
  • POST /api/built-for-ai/suggestsource: mcp-registry, 8 composants, tous verified: true
  • Besoin vide → 400 structuré (hint actionnable du registre)
  • Repli : snapshot pré-capturé byte-identique à la sortie live, tous composants vérifiés dans le barrel

https://claude.ai/code/session_01FekeK8iAdZkNabAKbz1sAC


Generated by Claude Code

claude added 2 commits June 15, 2026 21:11
…fallback)

Route interne /api/built-for-ai/suggest qui appelle la vraie logique d'outil
du connecteur (lib/mcp/registry.suggestComposition + getComponent) en in-process,
read-only. Chaque suggestion est vérifiée via get_component (cohérence barrel).

- lib/mcp/tools.ts : source unique des métadonnées des 4 outils (endpoint + signatures),
  pour ne pas dupliquer la définition entre /mcp et /built-for-ai.
- lib/built-for-ai/types.ts : types partagés + snapshot RÉEL pré-capturé de
  suggest_composition (repli hors-ligne, identique à la sortie live).
- Erreurs de validation = 400 structuré ; erreur inattendue = repli pré-capturé.
Nouvelle page publique /built-for-ai : différenciateur « consommable par un agent ».

- Section descriptive : les 4 outils MCP + comment un agent se connecte (endpoint).
- Démo interactive : champ libre / presets → suggest_composition → réponse brute
  affichée (ce que reçoit l'agent) → composition vérifiée → rendu live des
  composants bpm.* correspondants (aperçus réels du barrel ; fiche catalogue sinon).
- UI construite avec bpm.* (Input, Button, Badge, Chip, CodeBlock, Card, Message).
- i18n FR/EN + lien de nav. /mcp réutilise désormais lib/mcp/tools (zéro duplication).
@remigit55
remigit55 merged commit 65dd38e into master Jun 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants