Skip to main content
Windsurf logo

Ship your mobile app from Windsurf with Capgo

Windsurf builds, publishes, and live-updates your Capacitor app: iOS and Android builds without a Mac, OTA fixes in minutes, one-click rollback.

  • IDE
  • Hosted MCP
  • Local MCP
  • Skills
  • CLI

Set up Capgo in Windsurf

Three steps or less. Copy each block as is.

  1. Step 1

    Add the hosted Capgo MCP

    In the Cascade panel, open the Actions menu and click Open MCP config file. Add Capgo and sign in when prompted. No API key needed.

    mcp_config.json 
    {
  "mcpServers": {
    "capgo": {
      "serverUrl": "https://api.capgo.app/mcp"
    }
  }
}

  2. Step 2

    Add the local CLI MCP for builds and uploads

    Run npx @capgo/cli@latest login once in the terminal, then add the capgo-cli entry.

    mcp_config.json 
    {
  "mcpServers": {
    "capgo": {
      "serverUrl": "https://api.capgo.app/mcp"
    },
    "capgo-cli": {
      "command": "npx",
      "args": [
        "@capgo/cli@latest",
        "mcp"
      ]
    }
  }
}

  3. Step 3

    Install the Capgo skills

    The installer supports Windsurf and Devin skill folders.

    Terminal
    $ npx skills add Cap-go/capgo-skills

What you can ask Windsurf

Copy a prompt and paste it into Windsurf. Replace the app ID and versions with yours.

  • Build

    “Build a signed iOS release of this app with Capgo Build.”

  • Publish

    “Request an Android release build and send it to the Google Play internal track.”

  • Update

    “Check if this change needs a native build or can ship as a live update.”

  • Update

    “Build the web app and push this fix to the production channel.”

  • Rollback

    “Roll back the last bundle on the production channel.”

  • Observe

    “Show update stats for v2.3.0: how many devices have it and how many failed.”

  • Observe

    “Why did my last iOS build fail? Read the build logs and suggest a fix.”

  • Update

    “Create a beta channel and send this branch to it as a live update.”

The full release loop

One account covers every step, from the first build to the next live fix.

  1. 1

    Build

    Signed iOS and Android builds in the cloud. No Mac and no Xcode on your side.

    Capgo Build for native apps
  2. 2

    Publish

    Send builds to TestFlight and Google Play, or submit them for store review.

    Build and publish iOS apps without a Mac
  3. 3

    Update

    Push JavaScript, HTML, and CSS fixes to a channel in minutes. Roll back in one step.

    Capgo live updates
  4. 4

    Observe

    See who got the update, what failed, and how each release performs.

    Capgo Observe

Windsurf notes and limits

  • Windsurf is now Devin Desktop. The setup above uses the Cascade MCP config file.
  • With the Devin CLI, run devin mcp add -s user capgo https://api.capgo.app/mcp, then devin mcp login capgo.
  • On Teams and Enterprise, an admin MCP allowlist blocks servers that are not on it. Ask your admin to add Capgo.

FAQ

Capgo and Windsurf: common questions

Can Windsurf build my iOS app without a Mac?

Yes. Windsurf runs the Capgo CLI, which uploads your project to Capgo Build. Capgo signs and builds the iOS and Android apps in the cloud and can send them to TestFlight and Google Play.

Native build docs

Do I need a Capgo API key for Windsurf?

No API key needed for the hosted MCP: it signs in with OAuth. The local CLI MCP and the CLI use an API key that you save once with npx @capgo/cli@latest login. Create the key in the Capgo console under Settings, Organization, API keys.

Create a Capgo API key

Can Windsurf roll back a bad update?

Yes. Ask Windsurf to point the channel back to the previous bundle. Devices switch on their next update check. The Capgo updater also rolls back on its own when a new bundle fails to start.

Live update docs

Are live updates allowed on the App Store and Google Play?

Yes, for the web layer: JavaScript, HTML, CSS, and assets. Native code, new permissions, and new plugins still need a store release, which Capgo Build can make for you.

What does it cost to use Capgo from Windsurf?

The MCP servers, skills, and CLI are free to use. You need a Capgo plan, and every plan starts with a 14-day free trial with no credit card. Builds, live updates, and Observe are in every plan.

Pricing

Ship your next release from Windsurf

Create a Capgo account, connect Windsurf, and push your first build or live update today.

Docs

Related pages