MCP for Claude Desktop
Generate and modify Bricks Builder sections directly from Claude Desktop. Describe what you need in a conversation, and Claude creates the section and pushes it to your WordPress site. No API keys required. Uses your existing Claude Pro or Max subscription.
Before you start
- A Pro LTD license. MCP is not available on the Essential plan. See pricing
- A Claude Pro or Max subscription from claude.ai. 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.
Setup guide
Install Node.js on your computer
Claude Desktop 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.
How to open a terminal on Windows
Press Win + R, type cmd, press Enter.
How to open a terminal on Mac
Press Cmd + Space, type Terminal, press Enter.
Install Claude Desktop
If you already use the Claude Desktop app on your computer, skip to Step 3. 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.
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 Claude 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.
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 so Claude can use them. You need to click this button every time you change your Design System.
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. You will see a block labeled Claude Desktop Configuration with a JSON code snippet. Click the Copy button to copy it.
Now you need to find and edit the Claude Desktop configuration file on your computer. Follow the instructions for your operating system:
Windows — step by step
- 1.Press Win + R to open the Run dialog
- 2.Type
%APPDATA%\Claudeand press Enter. A folder will open. - 3.Look for a file called
claude_desktop_config.json. If it exists, right-click it and choose Open with Notepad. - 4.If the file does not exist, right-click in the empty space of the folder, choose New, Text Document. Rename it to exactly
claude_desktop_config.json(make sure it does not end in .txt). Open it with Notepad. - 5.If the file is empty, paste the JSON you copied from the Bricksfusion dashboard. Save and close.
- 6.If the file already has content from other tools, see the instructions below for merging.
Mac — step by step
- 1.Open Finder
- 2.Press Cmd + Shift + G to open the Go to Folder dialog
- 3.Paste
~/Library/Application Support/Claudeand press Enter - 4.Look for
claude_desktop_config.json. If it exists, double-click to open it in TextEdit. - 5.If the file does not exist, open TextEdit, go to Format, Make Plain Text, then paste the JSON from the Bricksfusion dashboard. Save the file as
claude_desktop_config.jsonin the Claude folder. - 6.If the file already has content from other tools, see the instructions below for merging.
If your file is empty or does not exist, paste the entire JSON you copied 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, you need to add Bricksfusion inside the existing mcpServers block. For example, if you already have a server called "other-tool", the file should look like this:
{
"mcpServers": {
"other-tool": {
"command": "...",
"args": ["..."]
},
"bricksfusion": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://studio.bricksfusion.com/api/mcp?token=YOUR_TOKEN"
]
}
}
}Note the comma after the closing } of "other-tool". Every server entry needs a comma after it except the last one.
Restart Claude Desktop completely
After saving the configuration file, you must fully close and reopen Claude Desktop. This is important because Claude only reads the configuration file when it starts.
Windows
Look at the system tray (the small icons near the clock at the bottom-right of your screen). If you see the Claude icon there, right-click it and choose Quit. Then open Claude Desktop again from the Start menu.
Mac
Press Cmd + Q to fully quit Claude Desktop. Simply closing the window is not enough. Then reopen Claude Desktop from the Applications folder or Dock.
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 and ready.
Type your first prompt to test:
Using bricksfusion, generate a hero section for a fitness gym with dark background
Claude will load your design system, use your framework and colors, and generate a complete Bricks Builder JSON section. You can copy the result and paste it into Bricks Builder, or connect your WordPress site to push changes directly.
Connect your WordPress site
This step is optional but recommended. Connecting your WordPress site lets Claude read your existing pages, add sections, replace sections, and remove sections directly. No copy and paste needed.
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.
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 Claude Desktop and your WordPress site. The same token must be in both places: your Bricksfusion dashboard and your WordPress settings.
Test the connection
In Claude Desktop, start a new conversation and type:
Using bricksfusion, list my Bricks pages
Claude will connect to your WordPress site and show you all the pages that use Bricks Builder. From here you can ask Claude to read any page, add new sections, replace existing sections, or remove sections. For example:
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 Claude makes changes, 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 what Claude generates. You can set these now or come back later.
Language
Set the language for all generated text. Claude will write headings, paragraphs, buttons, and placeholder text in your selected language. 22 languages available including English, Spanish, German, French, Portuguese, Japanese, and Chinese.
Wireframe Mode
Controls how Claude uses the wireframe library. Auto lets Claude decide whether to start from a template or generate from scratch. Always makes Claude pick 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". Claude applies these to every section it generates.
Project Brief
Describe your project, brand, and audience. For example: "we are a SaaS platform for remote teams, our tone is direct and technical, our users are CTOs and engineering leads". Claude 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. Claude follows your design system, framework, and colors automatically. Just describe what you want.
Use wireframe templates
Claude can browse the wireframe library with over 370 templates, pick the best one for your request, and customize it with your content and branding. This produces faster results with proven, professional layouts.
Read and modify your WordPress pages
With your site connected, Claude 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. Claude generates sections 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.
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, you also need to update the claude_desktop_config.json file on your computer with the new token, and restart Claude Desktop.
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 Claude 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 Claude pushes changes, you need to refresh the Bricks Builder editor. If you had Bricks open while Claude was making changes, close the editor without saving, then reopen the page in Bricks. If you save in Bricks after Claude writes, Bricks will overwrite the changes with what it had in memory.
Claude says tools are not connected
Start a new conversation in Claude Desktop. MCP tools sometimes disconnect between sessions. If the Bricksfusion icon disappears, close Claude Desktop completely and reopen it. The icon should reappear.
Where is the configuration file on Windows?
Press Win + R, type %APPDATA%\Claude, press Enter. The folder that opens is where claude_desktop_config.json should be. If the file does not exist, create a new text file with that exact name. Make sure Windows is not hiding the .txt extension. Go to View in File Explorer and check "File name extensions" to verify.
Where is the configuration file on Mac?
Open Finder, press Cmd + Shift + G, paste ~/Library/Application Support/Claude, press Enter. Open or create claude_desktop_config.json with TextEdit. If using TextEdit, make sure the file is in plain text mode: go to Format, Make Plain Text before saving.
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. Also check that there are no extra commas at the end, no missing quotation marks, and no invisible special characters from rich text editors. If in doubt, delete the file contents, go to the MCP dashboard, copy the configuration again, and paste it fresh.