Skip to main content

OpenCode Setup Guide

After setup, you can operate CloudBase services directly from OpenCode’s 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 from the CLI 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 .opencode.json:

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

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: 把这个 Web 前端接入 CloudBase 并部署到静态托管

FAQ​

Q: Connection keeps failing with ENOTEMPTY?

A: Leftover files in the local npx cache. Fully quit the AI tool, run the cleanup commands in the FAQ, then reconnect.

Q: MCP connection failed?

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

Q: Tool count shows 0?

A: See the FAQ.

More: FAQ

相关资源