How to Use the Makeswift MCP in Windsurf

Q: How do I connect the Makeswift MCP server to Windsurf?

Open /.codeium/windsurf/mcpconfig.json and add the Vinkius endpoint under the mcpServers key. Cascade automatically discovers the visual editing tools once you reload the IDE.

Q: Can Cascade automate visual backups in Makeswift using Windsurf?

Yes. Cascade uses listsnapshots to see what is already saved, then triggers createsnapshot to backup your Next.js layouts before you run migrations.

Q: How does Windsurf use the Makeswift MCP server to handle component mismatches?

Cascade runs listcomponents to pull registered visual blocks, compares them with your local Next.js files, and highlights missing props.

Q: What happens if a redirect breaks my visual editor routing?

Ask the agent to inspect the routing table. It runs listredirects and listhostnames to verify why a path is failing to load in the builder.

Control visual page building directly from Cascade. Deploy visual edits, manage snapshots, and audit Next.js page layouts without leaving Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Makeswift MCP to Windsurf

Create your Vinkius account to connect Makeswift to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Makeswift with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Visual page audits with Windsurf

The `list_pages` tool pulls your entire visual page tree directly into Cascade. Once Windsurf reads this list, it chains calls to `get_page` to inspect specific layouts and spot missing metadata or broken paths. Cascade does not stop to ask for permission after reading every visual page layout. It grabs the list, reads the details for each path, and outputs a complete structural report in one run.

Automated snapshot backups

The `create_snapshot` tool lets your agent capture the exact state of your visual builder page before deployment. Cascade coordinates this by checking existing snapshots with `list_snapshots` and automatically triggering a new backup if it detects differences. You do not need to manually trigger backups before running visual edits. This MCP server handles the timing, runs the snapshot creation, and outputs the confirmation hash to your workspace terminal.

Visual component synchronization

The `list_components` tool exposes the custom Next.js components registered in your Makeswift workspace. Windsurf reads these component definitions and compares them to your local React codebase to find mismatches. If a developer changes a prop in VS Code, Cascade notices the gap, checks `get_site_details` via the MCP connection, and flags exactly which components need a registration update to prevent visual editor crashes.

Setup guide

Set up Makeswift MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Makeswift MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Makeswift payment history." If connected, Cascade will call the Makeswift tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "makeswift-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Makeswift. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Makeswift now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Makeswift MCP in Windsurf

Open `~/.codeium/windsurf/mcp_config.json` and add the Vinkius endpoint under the `mcpServers` key. Cascade automatically discovers the visual editing tools once you reload the IDE.

Yes. Cascade uses `list_snapshots` to see what is already saved, then triggers `create_snapshot` to backup your Next.js layouts before you run migrations.

Cascade runs `list_components` to pull registered visual blocks, compares them with your local Next.js files, and highlights missing props.

Ask the agent to inspect the routing table. It runs `list_redirects` and `list_hostnames` to verify why a path is failing to load in the builder.

Vinkius runs the integration inside an isolated V8 sandbox, ensuring your page layouts, site configurations, and snapshot tokens never leak. Your API credentials stay encrypted, and each request executes in an ephemeral container.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript