Skip to main content

WindSurf Setup Guide

After setup, you can operate CloudBase services directly from WindSurf’s AI chat.

Examples:

  • "Build a WeChat Mini Program ordering system with CloudBase" — AI scaffolds pages, creates the cloud database, writes cloud functions, and guides preview
  • "Build a reservation management system that lets users place orders and admins update status" — AI models it with CloudBase PostgreSQL, configures permissions, and wires up frontend and backend
  • "Add phone-number login to a Web app" — AI enables the auth method and integrates the CloudBase SDK

No need to switch to the Cloud console — you can do everything in WindSurf with natural language.

Prerequisites​

Before you start, make sure you have:

Node.js and a CloudBase environment ready

Node.js: Install Node.js v18.15.0 or later:

node --version

If you don’t have it installed, download it from the Node.js website.

CloudBase environment: See Create a CloudBase environment. New users on the domestic site can start for free.

Client
Connection
Site

Remote needs only a URL — your client walks you through browser authorization, so no keys land in config files.

Configure your AI tool to connect with CloudBase capabilities. Supports local and remote connection. See connection modes.

Step 1: Install / Configure CloudBase

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

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "type": "http",
5      "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
6    }
7  }
8}
Need help?View WindSurf docs

Step 2: Chat with AI

Enter the following in your AI chat in order:

prompt
Read https://docs.cloudbase.net/skill.md and tell me what it can do
Use CloudBase Skills: 在 Android 应用中集成 CloudBase HTTP API

FAQ​

Q: MCP connection failed?

A: Check the MCP configuration format, restart WindSurf, and confirm your network is working.

Q: Tool count shows 0?

A: See the FAQ.

More: FAQ

相关资源