Bricks MCP

AI-ассистент для Bricks Builder. Плагин WordPress реализует протокол MCP (Model Context Protocol), позволяя AI-инструментам (Claude, Gemini и др.) читать и редактировать ваш сайт через естественный язык: управляйте страницами, шаблонами, глобальными классами, стилями темы, WooCommerce-макетами и многим другим.

Требования

• WordPress 6.4+
• PHP 8.2+
• Bricks Builder 1.6+

Установка

1. Скачайте последний релиз со страницы релизов GitHub.
2. В админке WordPress перейдите в Плагины > Добавить новый > Загрузить плагин и выберите скачанный ZIP-файл.
3. Активируйте плагин.
4. Зайдите в Настройки > Bricks MCP для конфигурации.

Настройка и подключение AI-инструментов

Claude Code

claude mcp add bricks-mcp https://yoursite.com/wp-json/bricks-mcp/v1/mcp --transport http

Claude Desktop / другие MCP-клиенты

Добавьте в конфигурационный файл (.mcp.json или аналогичный):

{
  "mcpServers": {
    "bricks-mcp": {
      "type": "http",
      "url": "https://yoursite.com/wp-json/bricks-mcp/v1/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Аутентификация выполняется через Application Passwords WordPress (инструкция). Создайте пароль в Users > Profile > Application Passwords.

Доступные инструменты

Конфигурация

В админке WordPress перейдите Настройки > Bricks MCP:

• Enable MCP Server — включение/отключение сервера.
• Require Authentication — ограничение доступа только аутентифицированным пользователям.
• Custom Base URL — для reverse proxy или кастомных доменов.
• Dangerous Actions — разрешить запись глобальных настроек Bricks и выполнение кода.

Расширение

Добавляйте собственные инструменты через фильтр bricks_mcp_tools:

add_filter('bricks_mcp_tools', function($tools) {
    $tools['my_custom_tool'] = [
        'name'        => 'my_custom_tool',
        'description' => 'Описание инструмента',
        'inputSchema' => [
            'type'       => 'object',
            'properties' => [],
        ],
        'handler'     => function($args) {
            return ['result' => 'success'];
        },
    ];
    return $tools;
});

Локальная разработка

npm install
npm run start          # Запуск WordPress (Docker через wp-env)
npm run test          # PHPUnit тесты
npm run lint          # Проверка соответствия стандартам WordPress
npm run lint:fix      # Автоисправление ошибок линтинга

Локальный сайт: http://localhost:8888 (admin / password).

Лицензия

GPL-2.0-or-later