MCP et Intégration IA
Vue d'ensemble
"BWEB n'est plus juste un outil de construction. C'est le framework que l'IA utilise pour construire des applications web."
L'intégration IA repose sur 3 points d'entrée :
| Point d'entrée | Rôle | Description |
|---|---|---|
| CLAUDE.md | Règles et conventions | Instructions projet chargées au démarrage. Conventions, style, patterns. |
| MCP Server | Outils spécialisés | Claude peut chercher dans la doc, récupérer des patterns, convertir du HTML. |
| Claude API | Actions directes | Point d'entrée HTTP pour lire/écrire dans la base 4D via curl. |
Outils MCP disponibles
| Outil | Description |
|---|---|
| get_4d_context | Contexte complet (instructions, règles, index) |
| search_4d_documentation | Recherche dans la doc BWEB par mot-clé |
| get_4d_pattern | Récupère un pattern (formcontroller, orda, listbox...) |
| read_4d_file | Lit un fichier de documentation spécifique |
| search_4d_official | Recherche dans developer.4d.com |
| convert_html_to_bweb | Convertit HTML/Tailwind en fichier .bspkExp |
| update_4d_documentation | Met à jour un fichier de documentation |
Claude API (/_claude/)
Point d'entrée HTTP intégré au composant BSPK. Claude appelle 4D directement via curl.
| Route | Description |
|---|---|
| GET /_claude/ping | Test de disponibilité |
| POST /_claude/exec | Exécute une méthode 4D |
| GET /_claude/data/TABLE/query | Requête ORDA avec pagination |
| POST /_claude/data/TABLE/create | Crée une entité |
| POST /_claude/data/TABLE/update | Modifie une entité |
| POST /_claude/data/TABLE/delete | Supprime une entité |
Sécurité : Accès autorisé en localhost ou avec un token temporaire. Écriture protégée par une whitelist de tables (claude-api-write-tables.json).
Workflow IA complet
- Prompt - Décrivez ce dont vous avez besoin en langage naturel
- Claude - Lit la doc (MCP), interroge la base (API)
- Génération - Crée des fichiers .bspkExp, des méthodes .4dm, du CSS
- Dev Panel - Import, ajustement et déploiement
Exemples de prompts
- "Crée-moi une landing page pour un restaurant avec hero, menu grid et formulaire de réservation"
- "Ajoute une listbox connectée à la DataClass SUPPLIER avec tri et pagination"
- "Génère un formulaire d'édition pour l'entité POST avec validation"
"L'IA construit, l'humain maintient et affine."