Merge branch 'main' into local-installation

Author: victoriaplummer

README.md

@@ -19,7 +19,7 @@ Get started by installing Webflow's remote MCP server. The remote server uses OA
 
 - Node.js 22.3.0 or higher
 
-> Note: The MCP server currently supports Node.js 22.3.0 or higher. If you run into version issues, see the Node.js compatibility section below.
+> Note: The MCP server currently supports Node.js 22.3.0 or higher. If you run into version issues, see the [Node.js compatibility guidance.](https://developers.webflow.com/data/v2.0.0/docs/ai-tools#nodejs-compatibility)
 
 ### Cursor
 
@@ -122,6 +122,18 @@ Find older blog posts that mention similar topics and add internal links to my l
 Create a hero section card on my home page with a CTA button and responsive design
 ```
 
+### Reset your OAuth Token
+
+To reset your OAuth token, run the following command in your terminal.
+
+```bash
+rm -rf ~/.mcp-auth
+```
+
+### Node.js compatibility
+
+Please see the Node.js [compatibility guidance on Webflow's developer docs.](https://developers.webflow.com/data/v2.0.0/docs/ai-tools#nodejs-compatibility)
+
 ---
 
 ## Local Installation
@@ -207,6 +219,103 @@ $env:WEBFLOW_TOKEN="<YOUR_WEBFLOW_TOKEN>"
 npx -y webflow-mcp-server@latest
 ```
 
+---
+
+## Local Installation
+
+You can also configure the MCP server to run locally. This requires:
+
+- Creating and registering your own MCP Bridge App in a Webflow workspace with Admin permissions
+- Configuring your AI client to start the local MCP server with a Webflow API token
+
+### 1. Create and publish the MCP bridge app
+
+Before connecting the local MCP server to your AI client, create and publish the Webflow MCP Bridge App in your workspace.
+
+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.
+2. Clone the MCP Bridge App code:
+   ```bash
+   git clone https://github.com/virat21/webflow-mcp-bridge-app
+   cd webflow-mcp-bridge-app
+   ```
+3. Configure the app with your App credentials:
+   - Set your Client ID and Client Secret in an `.env` file for the App you registered.
+   - See the app repo’s README for exact variables and build steps.
+4. Build and publish the Designer Extension to your workspace:
+   - Build per the repo instructions.
+   - 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.
+
+Once published to your workspace, open your MCP Bridge App in a site on your workspace from the Designer’s Apps panel.
+
+### 2. Configure your AI client
+
+#### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "webflow": {
+      "command": "npx",
+      "args": ["-y", "webflow-mcp-server@latest"],
+      "env": {
+        "WEBFLOW_TOKEN": "<YOUR_WEBFLOW_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+#### Claude desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "webflow": {
+      "command": "npx",
+      "args": ["-y", "webflow-mcp-server@latest"],
+      "env": {
+        "WEBFLOW_TOKEN": "<YOUR_WEBFLOW_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+### 3. Use the MCP server with the Webflow Designer
+
+- Open your site in the Webflow Designer.
+- Open the Apps panel (press `E`) and launch your published “Webflow MCP Bridge App”.
+- Wait for the app to connect to the MCP server, then use tools from your AI client.
+- 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.
+
+### Optional: Run locally via shell
+
+```bash
+WEBFLOW_TOKEN="<YOUR_WEBFLOW_TOKEN>" npx -y webflow-mcp-server@latest
+```
+
+```powershell
+# PowerShell
+$env:WEBFLOW_TOKEN="<YOUR_WEBFLOW_TOKEN>"
+npx -y webflow-mcp-server@latest
+```
+
+### Reset your OAuth Token
+
+To reset your OAuth token, run the following command in your terminal.
+
+```bash
+rm -rf ~/.mcp-auth
+```
+
+### Node.js compatibility
+
+Please see the Node.js [compatibility guidance on Webflow's developer docs.](https://developers.webflow.com/data/v2.0.0/docs/ai-tools#nodejs-compatibility)
+
 ## ❓ Troubleshooting
 
 If you are having issues starting the server in your MCP client e.g. Cursor or Claude Desktop, please try the following.