Skip to main content

WindSurf Configuration Guide

After configuration, you can directly operate CloudBase services in WindSurf's AI conversations.

For example:

  • "Create user table" - AI automatically creates database collection
  • "Deploy this function" - AI automatically uploads and configures cloud function
  • "Deploy frontend to CDN" - AI automatically uploads files and configures hosting

No need to switch to cloud console, all operations can be completed in WindSurf using natural language.

Prerequisites​

Before starting configuration, please ensure the following conditions are met:

Node.js environment and CloudBase environment are ready

Node.js Environment: Ensure Node.js v18.15.0 or higher is installed:

node --version

If not installed, please download and install from Node.js official website.

CloudBase Environment: Please refer to the documentation Create CloudBase Environment. New users can sign up for free.

Client

Configure your MCP client to connect with your CloudBase environment

Step 1: Configure CloudBase MCP

Use project template (recommended) - Template includes MCP configuration and AI rulesView templates

Or add this configuration to .windsurf/mcp.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "command": "npx",
5      "args": ["@cloudbase/cloudbase-mcp@latest"],
6      "env": {
7        "INTEGRATION_IDE": "WindSurf"
8      }
9    }
10  }
11}
Need help?View WindSurf docs

Step 2: Chat with AI

After configuration, enter the following in your AI chat:

prompt
调用 MCP 工具下载 CloudBase AI 开发规则到当前项目，然后介绍CloudBase MCP 的所有功能
在 CloudBase 控制台帮我配置短信登录方式

Common Questions​

Q: MCP connection failed? A: Check if configuration file format is correct, restart WindSurf, confirm network connection is normal.

Q: Tool count shows 0? A: Please refer to FAQ.

More questions please check: Complete FAQ

相关资源