bricks-builder-mcp 3.7.3 → 3.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +34 -18
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -24,21 +24,41 @@ Tu installes **2 choses** :
24
24
 
25
25
  ---
26
26
 
27
- ## Installation en 4 étapes
27
+ ## Installation — La méthode recommandée (Cowork, 1 clic)
28
28
 
29
- ### 1. Installer le plugin WordPress
29
+ C'est la méthode **complète et la plus simple**. Tu obtiens : les outils MCP **+ le skill embarqué** (doc, règles d'or, patterns Bricks 2.3, cheat-sheets, etc.) — Claude est immédiatement opérationnel.
30
30
 
31
- Télécharge la dernière version ici → **[Releases GitHub](https://github.com/Scott1012/bricks-builder-mcp/releases)** (fichier `bricks-mcp.zip`).
31
+ 1. **Installe le plugin WordPress** : télécharge le `.zip` depuis les **[Releases GitHub](https://github.com/Scott1012/bricks-builder-mcp/releases)** → WP admin → Extensions → Ajouter → Téléverser → Activer
32
+ 2. Dans WP admin → **Bricks MCP** → clique sur **"Télécharger pour Claude"**. Tu reçois un fichier `.plugin` qui contient tout : config MCP (URL + clé API auto-générée) + skill + doc
33
+ 3. Glisse ce `.plugin` dans la fenêtre Cowork → Activate
32
34
 
33
- Dans WP admin → Extensions → Ajouter → Téléverser une extension → choisis le `.zip` → Activer.
35
+ C'est fini. Aucun terminal, aucun JSON à éditer.
34
36
 
35
- ### 2. Générer ta clé API
37
+ ### (Optionnel mais recommandé) Activer `verify_element`
36
38
 
37
- Dans WP admin → **Réglages → Bricks MCP** → clique "Générer une clé API" → copie-la (commence par `bricks_...`).
39
+ Dans un terminal, une seule fois :
38
40
 
39
- ### 3. Configurer Claude Desktop
41
+ ```bash
42
+ npx playwright install chromium
43
+ ```
44
+
45
+ Ça télécharge Chromium (~130 Mo) pour que Claude puisse prendre des screenshots de tes pages et vérifier le rendu visuellement.
46
+
47
+ ### Test final
48
+
49
+ Demande à Claude : *"Liste les pages Bricks de mon site"*. Si ça répond, tout marche.
50
+
51
+ ---
52
+
53
+ ## Méthode alternative — Claude Desktop / Claude Code (config manuelle)
40
54
 
41
- Édite ton fichier `claude_desktop_config.json` (Cmd+, dans Claude Desktop → Developer → Edit Config) :
55
+ > ⚠️ **À savoir** : cette méthode te donne accès **aux outils MCP** mais pas au **skill** (doc + règles d'or + patterns). Claude doit deviner les bonnes pratiques sans la doc, ce qui multiplie les erreurs en construction.
56
+ >
57
+ > **Recommandé** : utilise plutôt la méthode Cowork ci-dessus, ou bien clone le repo skill localement (voir plus bas).
58
+
59
+ 1. **Installe le plugin WordPress** : pareil que ci-dessus (étape 1 de la méthode recommandée)
60
+ 2. **Génère ta clé API** : WP admin → **Bricks MCP** → "Générer une clé API" → copie-la (`bricks_...`)
61
+ 3. **Édite ton `claude_desktop_config.json`** (Cmd+, dans Claude Desktop → Developer → Edit Config) :
42
62
 
43
63
  ```json
44
64
  {
@@ -55,21 +75,17 @@ Dans WP admin → **Réglages → Bricks MCP** → clique "Générer une clé AP
55
75
  }
56
76
  ```
57
77
 
58
- Remplace `WORDPRESS_URL` par l'URL de ton site et `API_KEY` par la clé copiée à l'étape 2.
59
-
60
- ### 4. Pour utiliser `verify_element` (recommandé) — 1 commande supplémentaire
78
+ 4. **Redémarre Claude Desktop**.
61
79
 
62
- Dans un terminal, lance une fois :
80
+ ### Pour récupérer le skill manuellement (Claude Code uniquement)
63
81
 
64
82
  ```bash
65
- npx playwright install chromium
83
+ curl -L https://github.com/Scott1012/bricks-builder-mcp/archive/main.tar.gz | tar -xz -C /tmp && \
84
+ mkdir -p ~/.claude/skills && \
85
+ cp -r /tmp/bricks-builder-mcp-main/skill ~/.claude/skills/bricks-builder
66
86
  ```
67
87
 
68
- Ça télécharge Chromium (~130 Mo) pour que Claude puisse prendre des screenshots de tes pages et vérifier le rendu visuellement.
69
-
70
- ### Redémarre Claude Desktop. C'est tout.
71
-
72
- Demande à Claude : *"Liste les pages Bricks de mon site"* — si ça répond, tout marche.
88
+ Claude Code détectera automatiquement le skill au prochain démarrage.
73
89
 
74
90
  ---
75
91
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "bricks-builder-mcp",
4
- "version": "3.7.3",
4
+ "version": "3.7.5",
5
5
  "description": "Serveur MCP pour piloter Bricks Builder (WordPress) depuis Claude — édition de pages, gestion d'éléments, réordonnancement des sections, vérification visuelle (verify_element), upload optimisé WebP. Communauté Discord : https://discord.gg/rX22zHRzH",
6
6
  "homepage": "https://discord.gg/rX22zHRzH",
7
7
  "main": "server.js",