MCP/Setup/Windsurf

Connect Claivra to Windsurf

Connect Claivra to Cascade in Windsurf. Add the Claivra MCP server once and your agent can generate ad creatives, edit images, manage brand kits, and ship client review shares — all 29 tools, one endpoint.

First, grab an API key — you'll paste it into the config below.

Stays in your browser — it's inserted into the snippet locally, never sent anywhere.

Add this to your config

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claivra": {
      "serverUrl": "https://claivra.com/api/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer ck_live_YOUR_KEY"
      }
    }
  }
}

Replace ck_live_YOUR_KEY with a key from your dashboard.

Set up Windsurf

  1. 1

    Open the MCP config

    Edit ~/.codeium/windsurf/mcp_config.json, or use Windsurf → Settings → Cascade → MCP Servers → Manage → View raw config.

  2. 2

    Add the Claivra block

    Paste the snippet above, replacing ck_live_YOUR_KEY with your API key.

  3. 3

    Refresh the server list

    Hit Refresh in the MCP panel so Cascade picks up the new server.

  4. 4

    Ask Cascade

    Try "Generate an ad concept with Claivra."

Note: Windsurf uses the `serverUrl` key plus `type: "streamable-http"` for remote HTTP servers — different from the `url` key other clients use. Copy the snippet exactly.

Try these once you're connected

Talk to Windsurf in plain language — it calls the right Claivra tools for you.

  • "Scan https://example.com and create a brand kit from it"
  • "Generate 5 ad concepts for my brand — Square and Google Ad sizes"
  • "Remove the location text from the latest square ad in my media library"
  • "Bundle my newest ads into a client review share"
Browse all 29 tools