No API key
You sign in in the browser. The connection can do what you can do in the console, never more.
Deploy from Windsurf · Agent Lab Deploy
Say "deploy" in Windsurf.
It's live.
Connect Agent Lab MCP to Windsurf once (sign in in the browser, no API key), then say "deploy this". Windsurf creates the project, uploads, waits for the build and asks before it goes live. Every version gets a preview URL and rollback; apps and databases run on Google Cloud in Taiwan.
> deploy this
sites_createmy-windsurf-app
sites_deployframework detected
sites_deploy_statusbuilt · secret scan passed
Live at my-windsurf-app--acme.hosting.agentlab.run
Why deploy from Windsurf to Agent Lab
Windsurf does the deploy, you approve it
Preview, go live, roll back
Every upload is a new version with its own URL. Look first, then go live; switch back in one click.
Leaked keys caught
Uploads are checked for API keys and credentials before they can go live.
PostgreSQL in one click
Create a database and connect it; the connection is written into the app.
Your options
Windsurf with Agent Lab MCP, or your own server
Scroll the table sideways.
| What you care about | Agent Lab Deploy | Your own server |
|---|---|---|
| Setup | Connect MCP once, sign in in the browser | Install a CLI, create a token, write a deploy script |
| Credentials | No API key; the AI never sees a token | A token in the environment or pasted into the chat |
| Preview and rollback | Every version has its own URL; roll back in one click | Write your own scripts |
| Before going live | Uploads checked for leaked keys | Nothing unless you set it up |
| Database | PostgreSQL in one click, connection written into the app | Install and back it up yourself |
| Cost to start | Free plan: US$0, one size-S app (sleeps when idle) | A VPS at roughly US$6–20 a month, plus your time |
Steps
Deploy from Windsurf in four steps
Connect Agent Lab MCP
Refresh MCP servers in Windsurf and follow the prompt to sign in in the browser and choose your organization.
Ask in the project
Open the project in Windsurf and paste the prompt below, or just say "deploy this".
Check the plan and secrets
It shows the build plan and the variables the code reads. Enter secrets in the console, never in the chat.
Preview and go live
The first version goes live once it builds. Later ones get a preview URL; go live when you're happy.
Setup
Connect Windsurf to Agent Lab
Ask Cascade to deploy; it calls the Agent Lab tools. Put the deploy sentence in .windsurf/rules so every project ships the same way.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agentlab-acme": { "serverUrl": "https://mcp.agentlab.cresclab.com/mcp" }
}
}agentlab-acmereplace acme with your organization; the console's MCP page shows the filled-in setup..windsurf/rulesput the prompt here once and every later deploy follows it.
Then say this
Read https://app.agentlab.cresclab.com/agent/deploy.md and deploy this project to Agent Lab. Show me the build plan and the environment variables it needs first, tell me where to enter any secrets, and wait for my OK before it goes live.FAQ
Deploying from Windsurf: questions
Can Windsurf deploy a website by itself?
Yes, once Agent Lab MCP is connected. Windsurf creates the project, uploads the folder, waits for the build and reports the URL; it asks before a version goes live. Docs →
Do I give Windsurf an API key or token?
No. The connection signs in with OAuth in your browser. Secrets your app needs go in the console, and the AI never sees them.
How do I put a Windsurf project online?
Connect Agent Lab MCP and tell Cascade to deploy: it creates the project, uploads, waits for the build and reports the URL. Every version has a preview URL and one-click rollback.
Which frameworks does it support?
JavaScript, Python and Go projects build from source with no Dockerfile (Next.js, Vite, Nuxt, SvelteKit, Express, FastAPI, Django, Go and more); anything else ships a Dockerfile. All deploy guides →
Is there a free way to deploy?
The Free plan is US$0: one size-S app that sleeps after 15 idle minutes, one size-S database, three static web pages, 100 build minutes and 5 GB of traffic a month, pausing at the limit instead of charging. Pro (US$29 a month before tax) keeps apps running and adds custom domains. Pricing →