Bricks Builder MCP

Serveur Model Context Protocol (MCP) qui permet à Claude (Desktop, Cowork, Claude Code) de piloter Bricks Builder sur un site WordPress : lister les pages, lire/modifier le JSON Bricks, ajouter ou réorganiser des sections, etc.

Architecture

Claude (Desktop / Cowork)
    ↓ MCP (stdio)
bricks-builder-mcp  (ce package)
    ↓ HTTPS + X-API-Key
WordPress + plugin "Bricks Builder MCP Server"
    ↓
Pages Bricks Builder

Installation

Prérequis côté WordPress

Le plugin compagnon Bricks Builder MCP Server doit être installé et activé sur le WordPress cible. Il expose les endpoints REST /wp-json/bricks-mcp/v2/* et permet de générer la clé API.

Configuration côté Claude

Ajoute dans le fichier de configuration Claude (claude_desktop_config.json ou équivalent) :

{
  "mcpServers": {
    "bricks-mcp": {
      "command": "npx",
      "args": ["-y", "bricks-builder-mcp"],
      "env": {
        "WORDPRESS_URL": "https://exemple-de-site.com",
        "API_KEY": "bricks_xxxxxxxx"
      }
    }
  }
}

Redémarre Claude. C'est tout.

Variables d'environnement

| Variable | Requis | Description | |---|---|---| | WORDPRESS_URL | oui | URL racine du site WordPress (ex : https://exemple.com) | | API_KEY | oui | Clé API générée dans les réglages du plugin WordPress | | INSECURE_SSL | non | true pour désactiver la vérification SSL (utile en pré-prod avec certificat invalide). N'utiliser qu'en pré-prod ! |

Outils MCP exposés

| Outil | Description | |---|---| | list_bricks_pages | Liste toutes les pages Bricks | | get_page_json | Récupère le JSON complet d'une page | | update_page_json | Sauvegarde le JSON complet d'une page | | analyze_json_structure | Analyse la structure d'un JSON Bricks | | get_page_structure | Vue d'ensemble légère (économe en tokens) | | find_elements | Recherche d'éléments par critères | | get_element | Récupère un élément précis | | update_element | Modifie un élément précis | | add_element | Ajoute un élément | | batch_add | Ajoute plusieurs éléments en une fois | | delete_element | Supprime un élément | | reorder_sections | Réorganise l'ordre des sections (header en haut, footer en bas) |

Licence

MIT