Skip to content

Commit 478ecfd

Browse files
added local installation information
1 parent 15b7d61 commit 478ecfd

File tree

1 file changed

+85
-0
lines changed

1 file changed

+85
-0
lines changed

README.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,91 @@ Find older blog posts that mention similar topics and add internal links to my l
122122
Create a hero section card on my home page with a CTA button and responsive design
123123
```
124124

125+
---
126+
127+
## Local Installation
128+
129+
You can also configure the MCP server to run locally. This requires:
130+
131+
- Creating and registering your own MCP Bridge App in a Webflow workspace with Admin permissions
132+
- Configuring your AI client to start the local MCP server with a Webflow API token
133+
134+
### 1. Create and publish the MCP bridge app
135+
136+
Before connecting the local MCP server to your AI client, create and publish the Webflow MCP Bridge App in your workspace.
137+
138+
1. Register a Webflow App in your Workspace. Follow the [Register an App](https://developers.webflow.com/data/v2.0.0/docs/register-an-app) guidance for more details.
139+
2. Clone the MCP Bridge App code:
140+
```bash
141+
git clone https://github.com/virat21/webflow-mcp-bridge-app
142+
cd webflow-mcp-bridge-app
143+
```
144+
3. Configure the app with your App credentials:
145+
- Set your Client ID and Client Secret in an `.env` file for the App you registered.
146+
- See the app repo’s README for exact variables and build steps.
147+
4. Build and publish the Designer Extension to your workspace:
148+
- Build per the repo instructions.
149+
- Publish the App to your workspace via the Webflow Dashboard → Workspace settings → Apps & Integrations → Develop→ your App → “Publish Extension Version” and upload your `bundle.zip` file.
150+
151+
Once published to your workspace, open your MCP Bridge App in a site on your workspace from the Designer’s Apps panel.
152+
153+
### 2. Configure your AI client
154+
155+
#### Cursor
156+
157+
Add to `.cursor/mcp.json`:
158+
159+
```json
160+
{
161+
"mcpServers": {
162+
"webflow": {
163+
"command": "npx",
164+
"args": ["-y", "webflow-mcp-server@latest"],
165+
"env": {
166+
"WEBFLOW_TOKEN": "<YOUR_WEBFLOW_TOKEN>"
167+
}
168+
}
169+
}
170+
}
171+
```
172+
173+
#### Claude desktop
174+
175+
Add to `claude_desktop_config.json`:
176+
177+
```json
178+
{
179+
"mcpServers": {
180+
"webflow": {
181+
"command": "npx",
182+
"args": ["-y", "webflow-mcp-server@latest"],
183+
"env": {
184+
"WEBFLOW_TOKEN": "<YOUR_WEBFLOW_TOKEN>"
185+
}
186+
}
187+
}
188+
}
189+
```
190+
191+
### 3. Use the MCP server with the Webflow Designer
192+
193+
- Open your site in the Webflow Designer.
194+
- Open the Apps panel (press `E`) and launch your published “Webflow MCP Bridge App”.
195+
- Wait for the app to connect to the MCP server, then use tools from your AI client.
196+
- If the Bridge App prompts for a local connection URL, call the `get_designer_app_connection_info` tool from your AI client and paste the returned `http://localhost:<port>` URL.
197+
198+
### Optional: Run locally via shell
199+
200+
```bash
201+
WEBFLOW_TOKEN="<YOUR_WEBFLOW_TOKEN>" npx -y webflow-mcp-server@latest
202+
```
203+
204+
```powershell
205+
# PowerShell
206+
$env:WEBFLOW_TOKEN="<YOUR_WEBFLOW_TOKEN>"
207+
npx -y webflow-mcp-server@latest
208+
```
209+
125210
## ❓ Troubleshooting
126211

127212
If you are having issues starting the server in your MCP client e.g. Cursor or Claude Desktop, please try the following.

0 commit comments

Comments
 (0)