Skip to main content
Documentation
Pro LTDExclusive

MCP Integration

Generate and modify Bricks Builder sections directly from your AI client. Describe what you need in a conversation, and the AI creates the section and pushes it to your WordPress site. No API keys required. Works with Claude Desktop, Codex (OpenAI), and any MCP-compatible client.

Before you start

  • A Pro LTD license. MCP is not available on the Essential plan. See pricing
  • An AI subscription: Claude Pro or Max from claude.ai, or ChatGPT Plus, Pro, Business, Edu, or Enterprise from chatgpt.com. This is your AI subscription, separate from Bricksfusion.
  • Bricksfusion Animations and Studio plugins installed and activated on your WordPress site. If you have not done this yet, follow the Installation guide first.

Common setup

These steps are the same regardless of which AI client you use.

1

Install Node.js on your computer

Your AI client needs a small program called Node.js to connect to Bricksfusion. This is a one-time installation. If you already have Node.js installed, skip to Step 2.

Go to nodejs.org and download the version labeled LTS (the one on the left). Run the installer and click Next through all steps. Do not change any settings.

Windows

Download the .msi file. Double-click it. Click Next on every screen. Click Finish.

Mac

Download the .pkg file. Double-click it. Click Continue on every screen. Click Install.

To check that it installed correctly, open a terminal and type node --version. If you see a number like v20.x.x or higher, you are ready.

2

Configure your Design System

Go to Dashboard, Design System on Bricksfusion and make sure your framework, colors, and spacing are set up. This is what the AI uses when generating sections for your project.

If you already configured your Design System for the wireframe library or Studio, you are ready. If not, select your CSS framework and customize the settings. Changes save automatically.

3

Set up your MCP connection

Go to Dashboard, MCP on Bricksfusion. You will see three sections: Connection, Design System, and Generation Context.

In the Connection section, your MCP token is already generated. Check that it shows Active with a green dot. If it shows Inactive, click Activate.

In the Design System section, click Sync to MCP. This sends your framework, colors, and spacing to the MCP server. You need to click this button every time you change your Design System.

Now choose your AI client and follow the setup instructions below.

Claude Desktop

4

Install Claude Desktop

If you already use the Claude Desktop app on your computer, skip to Step 5. If you only use Claude in the browser at claude.ai, you need the desktop app.

Go to claude.ai/download, download Claude Desktop for your operating system, and install it. Sign in with the same account you use at claude.ai.

5

Connect Claude Desktop to Bricksfusion

This is the most important step. You need to edit a small configuration file on your computer to tell Claude Desktop about Bricksfusion.

First, go to the Connection section of your MCP dashboard. Select the Claude Desktop tab and click the Copy button to copy the JSON configuration.

Now you need to find and edit the Claude Desktop configuration file on your computer:

Tip: The easiest way on any operating system is to open Claude Desktop, go to Settings, Developer, and click Edit Config. This opens the correct file automatically.

Windows — step by step

  1. 1.Press Win + R to open the Run dialog
  2. 2.Type %APPDATA%\Claude and press Enter. A folder will open.
  3. 3.Look for claude_desktop_config.json. If it exists, right-click and choose Open with Notepad.
  4. 4.If the file does not exist, create a new text file with that exact name (make sure it does not end in .txt). Open it with Notepad.
  5. 5.Paste the JSON you copied from the Bricksfusion dashboard. Save and close.
  6. 6.If the file already has content from other tools, see below for merging.

Mac — step by step

  1. 1.Open Finder, press Cmd + Shift + G
  2. 2.Paste ~/Library/Application Support/Claude and press Enter
  3. 3.Look for claude_desktop_config.json. If it exists, double-click to open in TextEdit.
  4. 4.If the file does not exist, open TextEdit, go to Format, Make Plain Text, paste the JSON and save as claude_desktop_config.json in the Claude folder.

If your file is empty or does not exist, paste the entire JSON from the dashboard. It looks like this:

{
  "mcpServers": {
    "bricksfusion": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://studio.bricksfusion.com/api/mcp?token=YOUR_TOKEN"
      ]
    }
  }
}

If your file already has other MCP servers, add Bricksfusion inside the existing mcpServers block with a comma separating entries:

{
  "mcpServers": {
    "other-tool": {
      "command": "...",
      "args": ["..."]
    },
    "bricksfusion": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://studio.bricksfusion.com/api/mcp?token=YOUR_TOKEN"
      ]
    }
  }
}
6

Restart Claude Desktop completely

After saving the configuration file, fully close and reopen Claude Desktop.

Windows

Check the system tray (icons near the clock). Right-click the Claude icon and choose Quit. Then reopen from the Start menu.

Mac

Press Cmd + Q to fully quit. Simply closing the window is not enough. Then reopen from Applications or Dock.

7

Verify the connection

Open Claude Desktop and start a new conversation. Look at the bottom of the chat input for a small B icon among the connected tools. That icon means Bricksfusion is connected.

Type your first prompt to test:

Using bricksfusion, generate a hero section for a fitness gym with dark background

Codex Desktop

Codex is the AI client from OpenAI. It uses your existing ChatGPT subscription. The same MCP token and design system work with both clients.

4

Install Codex Desktop

If you already have the Codex Desktop app, skip to Step 5. Codex is included in ChatGPT Plus ($20/mo), Pro ($200/mo), Business, Edu, and Enterprise plans.

Download Codex Desktop for your operating system from OpenAI and install it. Sign in with the same ChatGPT account you use at chatgpt.com.

5

Add Bricksfusion in Codex settings

This is simpler than Claude Desktop because Codex has a built-in UI for adding MCP servers. No configuration files to edit.

Go to Settings (bottom left), then MCP servers, then click + Add server.

Fill in the following fields:

Namebricksfusion
TypeSTDIO (do not change to HTTP)
Commandnpx
Argument 1-y
Argument 2mcp-remote
Argument 3https://studio.bricksfusion.com/api/mcp?token=YOUR_TOKEN

Add arguments one by one using + Add argument. Copy the full URL with your token from the MCP dashboard (select the Codex Desktop tab for the exact URL). Click Save.

6

Restart Codex and verify

Close Codex completely (Cmd + Q on Mac, not just closing the window) and reopen it.

Open a new chat and type /mcp. You should see bricksfusion listed as Authenticated and Enabled.

Test with a prompt:

List all available tools from the bricksfusion MCP server

You should see all 8 tools listed. From there, you can generate sections, search wireframes, and manage your WordPress pages in natural language.

Connect your WordPress site

This step is optional but recommended. Connecting your WordPress site lets your AI client read your existing pages, add sections, replace sections, and remove sections directly. No copy and paste needed. This works the same way with both Claude Desktop and Codex.

8

Generate a Site Token

Go to Dashboard, MCP and scroll down to the Site Connection section. Click Generate to create a secure Site Token. Then click Copy to copy it.

In the Site URL field, enter your WordPress site address. For example: https://yoursite.com. This saves automatically.

9

Add the token to WordPress

Log in to your WordPress admin panel. In the left sidebar, go to Settings, BricksFusion MCP. Paste the Site Token you copied in Step 8 into the token field and click Save Token.

This creates a secure connection between your AI client and your WordPress site. The same token must be in both places: your Bricksfusion dashboard and your WordPress settings.

10

Test the connection

In your AI client, start a new conversation and ask it to list your pages:

Using bricksfusion, list my Bricks pages

It will connect to your WordPress site and show you all pages that use Bricks Builder. From here you can ask to read any page, add new sections, replace existing sections, or remove sections:

Add a testimonials section to my homepage
Replace the hero section on page About with a more modern version
Remove the FAQ section from page Services

After changes are pushed, open your page in Bricks Builder or refresh the editor to see the updates. Changes are not visible in real time. You need to refresh.

Generation context

The MCP dashboard has a Generation Context section with optional settings that improve the quality of generated sections. You can set these now or come back later.

Language

Set the language for all generated text. 22 languages available including English, Spanish, German, French, Portuguese, Japanese, and Chinese.

Wireframe Mode

Controls how the AI uses the wireframe library. Auto lets the AI decide whether to start from a template or generate from scratch. Always uses a wireframe template first. Never generates everything from scratch. Auto is recommended for most users.

Style Instructions

Describe your visual preferences in plain language. For example: "clean minimal aesthetic, rounded corners on cards, tight spacing, subtle borders instead of shadows".

Project Brief

Describe your project, brand, and audience. The AI uses this to write realistic, relevant content instead of generic placeholder text.

What you can do

Generate any type of section

Heroes, feature grids, pricing tables, testimonials, FAQs, contact forms, footers, CTAs, team sections, and more. Your design system, framework, and colors are applied automatically.

Use wireframe templates

The AI can browse the wireframe library with over 370 templates, pick the best one for your request, and customize it with your content and branding.

Read and modify your WordPress pages

With your site connected, the AI can list all your Bricks pages, read their structure, add new sections at any position, replace existing sections, remove sections, or rebuild an entire page from scratch.

All five frameworks supported

Vanilla, ACSS, Core Framework, AT Framework, and Bricks Builder Design Tokens. Sections are generated using the correct variables, spacing tokens, and color system for your framework.

Troubleshooting

Bricksfusion icon does not appear in Claude Desktop

Make sure you fully closed and reopened Claude Desktop after editing the configuration file. On Windows, check the system tray near the clock and quit Claude from there. On Mac, press Cmd+Q. Also verify Node.js is installed by opening a terminal and typing node --version.

Bricksfusion does not show in Codex /mcp

Close Codex completely and reopen it. Verify that the three arguments are correct and in order: -y, mcp-remote, and the full URL with your token. Check that Type is set to STDIO, not HTTP. Verify Node.js is installed.

Invalid or inactive token error

Go to Dashboard, MCP and check that your token shows Active with a green dot. If you recently regenerated your token, update the token in your AI client configuration and restart the client.

Colors or framework variables are wrong

After changing anything in your Design System, go to Dashboard, MCP and click Sync to MCP. Changes to your Design System do not reach the AI automatically. If the sync indicator shows an amber dot, your MCP configuration is out of date.

Cannot list pages or push changes to WordPress

Check three things: your Site URL is correct in the MCP dashboard, the same Site Token is saved in WordPress at Settings, BricksFusion MCP, and your WordPress site is publicly accessible (not running on localhost).

Changes do not appear in Bricks Builder

After the AI pushes changes, refresh the Bricks Builder editor. If you had Bricks open, close the editor without saving, then reopen the page. If you save in Bricks after the AI writes, Bricks will overwrite the changes.

Tools disconnect between sessions

Start a new conversation. MCP tools sometimes disconnect between sessions. If the connection drops, close your AI client completely and reopen it.

Where is the Claude Desktop configuration file?

The easiest method is to open Claude Desktop, go to Settings, Developer, Edit Config. Otherwise: on Windows press Win + R and type %APPDATA%\Claude. On Mac open Finder, press Cmd + Shift + G and paste ~/Library/Application Support/Claude.

JSON syntax error in configuration file

The most common mistake is a missing comma between server entries. Every server block inside mcpServers needs a comma after its closing brace, except the last one. If in doubt, delete the contents, copy the configuration from the MCP dashboard again, and paste it fresh.

MCP for Claude Desktop — Setup Guide for Windows & Mac | Bricksfusion