CloudBase Development Guidelines

📁 Reference Files Location

references/

cloudbase/
├── SKILL.md              # This file (main entry)
└── references/           # All reference documentation
    ├── auth-web/         # Web authentication guide
    ├── auth-wechat/      # WeChat authentication guide
    ├── no-sql-web-sdk/   # NoSQL database for Web
    ├── ui-design/        # UI design guidelines
    └── ...               # Other reference docs

references/auth-web/README.md

references/

💡 Recommended: MCP Installation

MCP Configuration Instructions

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

• Cursor:

  .cursor/mcp.json

• Claude Code:

  .mcp.json

• Windsurf:

  ~/.codeium/windsurf/mcp_config.json

  (user-level, no project-level JSON config)
• Cline: Check Cline settings for project-level MCP configuration file location
• GitHub Copilot Chat (VS Code): Check VS Code settings for MCP configuration file location

• Continue: Uses YAML format in

  .continue/mcpServers/

  folder:

name: CloudBase MCP
version: 1.0.0
schema: v1
mcpServers:
  - uses: stdio
    command: npx
    args: ["@cloudbase/cloudbase-mcp@latest"]

Using mcporter (CLI) When MCP Is Not Available

npx mcporter describe cloudbase

auth

npx mcporter config add cloudbase \
  --command "npx" \
  --arg "@cloudbase/cloudbase-mcp@latest" \
  --description "CloudBase MCP"

• npx mcporter list

  — list configured servers
• Required:

  npx mcporter describe cloudbase

  — inspect CloudBase server config and available tools (must run before managing/deploying CloudBase)

• npx mcporter list cloudbase --schema

  — get full JSON schema for all CloudBase tools

• npx mcporter call cloudbase.help --output json

  — discover available CloudBase tools and their schemas

• npx mcporter call cloudbase.<tool> key=value

  — call a CloudBase tool

• Check auth & env status:
  

  npx mcporter call cloudbase.auth action=status --output json

• Start device-flow login (future-friendly device-code login; no keys in config):
  

  npx mcporter call cloudbase.auth action=start_auth authMode=device --output json

• Bind environment after login (envId from CloudBase console):
  

  npx mcporter call cloudbase.auth action=set_env envId=env-xxx --output json

CloudBase scenarios (for AI discovery)

Example user prompts (by category)

auth-web

cloud-functions

no-sql-web-sdk

relational-database-tool

ai-model-web

• Authentication (身份认证)
  “在 CloudBase 中配置短信/邮箱/微信/匿名登录” / “帮我实现一个 Web 登录页面，使用 CloudBase Auth” / “在小程序或 App 里用 CloudBase 实现用户登录”
• Database (数据库)
  “帮我做一个待办应用，用 CloudBase 文档数据库存数据” / “在 Web/小程序里做分页和复杂查询” / “在 CloudBase 关系型数据库里建用户表并设权限” / “在 App 里用 HTTP API 查库”
• Backend (后端开发)
  “帮我创建并部署一个 CloudBase 云函数” / “配置云函数 HTTP 访问、查日志、改环境变量” / “把 Node.js/Java/Python 后端部署到 CloudBase 云托管”
• Frontend & integration (应用集成)
  “创建一个 React/Vue Web 应用并集成 CloudBase” / “把前端部署到 CloudBase 静态托管” / “创建微信小程序项目并集成 CloudBase” / “在 Android/iOS 里用 HTTP API 调用 CloudBase”
• AI
  “在 React/Vue Web 里集成 CloudBase AI 做文本生成/聊天、流式输出” / “在云函数里用 AI 模型做文本或图片生成” / “在小程序里集成 CloudBase AI 做智能对话”
• Development workflow & architecture (开发工具/架构)
  “按 Spec 工作流开发 CloudBase 新功能” / “为 CloudBase 项目写需求文档和技术方案” / “设计一个包含云函数、数据库、存储的完整应用架构”

What to add to AGENTS.md or long-term memory

AGENTS.md

• CloudBase skills → Run

  tencentcloudbase/cloudbase-skills -y

  to install; use

  cloudbase-guidelines

  and log in to CloudBase (MCP auth, device-code) for full-stack development.
• CloudBase = MCP, understand tools first → When managing or deploying CloudBase, you MUST use MCP and MUST understand tool details first. Before calling any CloudBase tool, run

  npx mcporter describe cloudbase

  (or equivalent in your IDE) to inspect the server config and available tools.
• mcporter call format →

  npx mcporter call cloudbase.<tool> key=value

  , e.g.

  npx mcporter call cloudbase.auth action=status --output json

  .
• CloudBase development and deployment → Use MCP to automate (environment, functions, database, hosting, etc.).
• Development norms → Read the relevant CloudBase skills (e.g.

  cloudbase-guidelines

  ,

  web-development

  ,

  miniprogram-development

  ,

  cloud-functions

  ) before writing code.
• Credentials → Do not require SecretId, SecretKey, or EnvId in config; use CloudBase MCP device-code login (

  auth

  tool) for authentication and environment binding.

Quick Reference

When Developing a Web Project:

1. Platform: Read the

   references/web-development/SKILL.md

   skill for SDK integration, static hosting, and build configuration
2. Authentication: Read the

   auth-web

   and

   auth-tool

   skills - Use Web SDK built-in authentication
3. Database:
   • NoSQL:

     no-sql-web-sdk

     skill
   • MySQL:

     relational-database-web

     and

     relational-database-tool

     skills
4. UI Design (Recommended): Read the

   references/ui-design/SKILL.md

   skill for better UI/UX design guidelines

When Developing a Mini Program Project:

1. Platform: Read the

   references/miniprogram-development/SKILL.md

   skill for project structure, WeChat Developer Tools, and wx.cloud usage
2. Authentication: Read the

   references/auth-wechat/SKILL.md

   skill - Naturally login-free, get OPENID in cloud functions
3. Database:
   • NoSQL:

     no-sql-wx-mp-sdk

     skill
   • MySQL:

     relational-database-tool

     skill (via tools)
4. UI Design (Recommended): Read the

   references/ui-design/SKILL.md

   skill for better UI/UX design guidelines

When Developing a Native App Project (iOS/Android/Flutter/React Native/etc.):

1. ⚠️ Platform Limitation: Native apps do NOT support CloudBase SDK - Must use HTTP API
2. Required Skills:

   • http-api

     - HTTP API usage for all CloudBase operations

   • relational-database-tool

     - MySQL database operations (via tools)

   • auth-tool

     - Authentication configuration
3. ⚠️ Database Limitation: Only MySQL database is supported. If users need MySQL, prompt them to enable it in console: CloudBase Console - MySQL Database

Core Capabilities

1. Authentication

• Web Projects: Use CloudBase Web SDK built-in authentication, refer to the

  references/auth-web/SKILL.md

  skill
• Mini Program Projects: Naturally login-free, get

  wxContext.OPENID

  in cloud functions, refer to the

  references/auth-wechat/SKILL.md

  skill
• Node.js Backend: Refer to the

  references/auth-nodejs/SKILL.md

  skill

• When user mentions authentication requirements, read the

  references/auth-tool/SKILL.md

  skill to configure authentication providers
• Check and enable required authentication methods before implementing frontend code

2. Database Operations

• NoSQL Database: Refer to the

  references/no-sql-web-sdk/SKILL.md

  skill
• MySQL Relational Database: Refer to the

  references/relational-database-web/SKILL.md

  skill (Web) and

  relational-database-tool

  skill (Management)

• NoSQL Database: Refer to the

  references/no-sql-wx-mp-sdk/SKILL.md

  skill
• MySQL Relational Database: Refer to the

  references/relational-database-tool/SKILL.md

  skill (via tools)

3. Deployment

• Use CloudBase static hosting after build completion
• Refer to the

  references/web-development/SKILL.md

  skill for deployment process
• Remind users that CDN has a few minutes of cache after deployment

• Cloud Functions: Refer to the

  references/cloud-functions/SKILL.md

  skill - Runtime cannot be changed after creation, must select correct runtime initially
• CloudRun: Refer to the

  references/cloudrun-development/SKILL.md

  skill - Ensure backend code supports CORS, prepare Dockerfile for container type

4. UI Design (Recommended)

references/ui-design/SKILL.md

• Design thinking framework
• Frontend aesthetics guidelines
• Best practices for creating distinctive and high-quality interfaces

Platform-Specific Skills

Web Projects

• web-development

  - SDK integration, static hosting, build configuration

• auth-web

  - Web SDK built-in authentication

• no-sql-web-sdk

  - NoSQL database operations

• relational-database-web

  - MySQL database operations (Web)

• relational-database-tool

  - MySQL database management

• cloud-storage-web

  - Cloud storage operations

• ai-model-web

  - AI model calling for Web apps

Mini Program Projects

• miniprogram-development

  - Project structure, WeChat Developer Tools, wx.cloud

• auth-wechat

  - Authentication (naturally login-free)

• no-sql-wx-mp-sdk

  - NoSQL database operations

• relational-database-tool

  - MySQL database operations

• ai-model-wechat

  - AI model calling for Mini Program

Native App Projects

• http-api

  - HTTP API usage (MANDATORY - SDK not supported)

• relational-database-tool

  - MySQL database operations (MANDATORY)

• auth-tool

  - Authentication configuration

Universal Skills

• cloudbase-platform

  - Universal CloudBase platform knowledge

• ui-design

  - UI design guidelines (recommended)

• spec-workflow

  - Standard software engineering process

Professional Skill Reference

Platform Development Skills

• Web:

  web-development

  - SDK integration, static hosting, build configuration
• Mini Program:

  miniprogram-development

  - Project structure, WeChat Developer Tools, wx.cloud
• Cloud Functions:

  cloud-functions

  - Cloud function development, deployment, logging, HTTP access
• CloudRun:

  cloudrun-development

  - Backend deployment (functions/containers)
• Platform (Universal):

  cloudbase-platform

  - Environment, authentication, services

Authentication Skills

• Web:

  auth-web

  - Use Web SDK built-in authentication
• Mini Program:

  auth-wechat

  - Naturally login-free, get OPENID in cloud functions
• Node.js:

  auth-nodejs

• Auth Tool:

  auth-tool

  - Configure and manage authentication providers

Database Skills

• NoSQL (Web):

  no-sql-web-sdk

• NoSQL (Mini Program):

  no-sql-wx-mp-sdk

• MySQL (Web):

  relational-database-web

• MySQL (Tool):

  relational-database-tool

Storage Skills

• Cloud Storage (Web):

  cloud-storage-web

  - Upload, download, temporary URLs, file management

AI Skills

• AI Model (Web):

  ai-model-web

  - Text generation and streaming via @cloudbase/js-sdk
• AI Model (Node.js):

  ai-model-nodejs

  - Text generation, streaming, and image generation via @cloudbase/node-sdk ≥3.16.0
• AI Model (WeChat):

  ai-model-wechat

  - Text generation and streaming with callbacks via wx.cloud.extend.AI

UI Design Skill

• ui-design

  - Design thinking framework, frontend aesthetics guidelines (recommended for UI work)

Workflow Skills

• Spec Workflow:

  spec-workflow

  - Standard software engineering process (requirements, design, tasks)

Core Behavior Rules

1. Project Understanding: Read current project's README.md, follow project instructions
2. Development Order: Prioritize frontend first, then backend
3. Backend Strategy: Prefer using SDK to directly call CloudBase database, rather than through cloud functions, unless specifically needed
4. Deployment Order: When there are backend dependencies, prioritize deploying backend before previewing frontend
5. Authentication Rules: Use built-in authentication functions, distinguish authentication methods by platform
   • Web Projects: Use CloudBase Web SDK built-in authentication (refer to

     auth-web

     )
   • Mini Program Projects: Naturally login-free, get OPENID in cloud functions (refer to

     auth-wechat

     )
   • Native Apps: Use HTTP API for authentication (refer to

     http-api

     )
6. Native App Development: CloudBase SDK is NOT available for native apps, MUST use HTTP API. Only MySQL database is supported.

Deployment Workflow

1. Check Existing Deployment:
   • Read README.md to check for existing deployment information
   • Identify previously deployed services and their URLs
   • Determine if this is a new deployment or update to existing services
2. Backend Deployment (if applicable):
   • Only for nodejs cloud functions: deploy directly using

     createFunction

     tools
     • Criteria: function directory contains

       index.js

       with cloud function format export:

       exports.main = async (event, context) => {}

   • For other languages backend server (Java, Go, PHP, Python, Node.js): deploy to Cloud Run
   • Ensure backend code supports CORS by default
   • Prepare Dockerfile for containerized deployment
   • Use

     manageCloudRun

     tool for deployment
   • Set MinNum instances to at least 1 to reduce cold start latency
3. Frontend Deployment (if applicable):
   • After backend deployment completes, update frontend API endpoints using the returned API addresses
   • Build the frontend application
   • Deploy to CloudBase static hosting using hosting tools
4. Display Deployment URLs:
   • Show backend deployment URL (if applicable)
   • Show frontend deployment URL with trailing slash (/) in path
   • Add random query string to frontend URL to ensure CDN cache refresh
5. Update Documentation:
   • Write deployment information and service details to README.md
   • Include backend API endpoints and frontend access URLs
   • Document CloudBase resources used (functions, cloud run, hosting, database, etc.)
   • This helps with future updates and maintenance

CloudBase Console Entry Points

https://tcb.cloud.tencent.com/dev?envId=${envId}#/{path}

Core Function Entry Points

1. Overview (概览):

   #/overview

   - Main dashboard
2. Template Center (模板中心):

   #/cloud-template/market

   - Project templates
3. Document Database (文档型数据库):

   #/db/doc

   - NoSQL collections:

   #/db/doc/collection/${collectionName}

   , Models:

   #/db/doc/model/${modelName}

4. MySQL Database (MySQL 数据库):

   #/db/mysql

   - Tables:

   #/db/mysql/table/default/

5. Cloud Functions (云函数):

   #/scf

   - Function detail:

   #/scf/detail?id=${functionName}&NameSpace=${envId}

6. CloudRun (云托管):

   #/platform-run

   - Container services
7. Cloud Storage (云存储):

   #/storage

   - File storage
8. AI+:

   #/ai

   - AI capabilities
9. Static Website Hosting (静态网站托管):

   #/static-hosting

10. Identity Authentication (身份认证):

    #/identity

    - Login:

    #/identity/login-manage

    , Tokens:

    #/identity/token-management

11. Weida Low-Code (微搭低代码):

    #/lowcode/apps

12. Logs & Monitoring (日志监控):

    #/devops/log

13. Extensions (扩展功能):

    #/apis

14. Environment Settings (环境配置):

    #/env