PlugWiki
CloudBase logo

CloudBase MCP Server: Setup for Claude Code, Cursor and Other Apps

OfficialRemoteLocal
Gethttps://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}tencentcloudbase/cloudbase-ai-toolkit

Lets Claude or Cursor manage your Tencent CloudBase databases, cloud functions, storage and hosting, and deploy from chat.

This is Tencent Cloud's own MCP server for CloudBase, its backend platform. It lets Claude, Cursor and other assistants work with your databases, cloud functions, storage, hosting and access rules, and deploy a site or app. You need a CloudBase environment first. You can connect over the hosted address and sign in with the browser, or run it on your own machine to use local file upload.

Good for

  • Developers building on Tencent CloudBase who want to create and deploy backends from chat
  • Teams that want one assistant to manage database, functions, hosting and permissions
  • Anyone starting a web or mini program project from a CloudBase template

Works in

14 should work

Tap an app to see how to set it up and any known problems.

Install CloudBase MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the CloudBase MCP server to Claude Code. Run this command:
    
    claude mcp add --transport http cloudbase https://tcb-api.cloud.tencent.com/mcp/v1
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Sign-in with the vendor account (OAuth).

Tencent lists Claude Code among the tools it supports, but its README shows browser sign-in only in general terms and gives no per-client OAuth steps, so how Claude Code handles it is not documented and untested here. The hosted address (recommended in the README) is the China site; for the international site use https://tcb-api.tencentcloud.com/mcp/v1. For CI or a client without OAuth, add ?env_id=<env_id> to the URL and send X-TencentCloud-SecretId and X-TencentCloud-SecretKey headers from a key pair made on the same site. Local npx runs @cloudbase/cloudbase-mcp@latest and adds file upload and template download, which the hosted address lacks. The commands are adapted by us from the README.

Built from the package data we hold. Not yet tested by us.

Tools

  • Signs you in to CloudBase and picks an environment

    Checks your login state, starts sign-in, signs in with an API key, binds an environment or signs out. Other tools work only after an environment is bound.

    Try: “Check my CloudBase login and bind my test environment.”

    Write · auth

  • Lists environments, domains, usage and metrics

    Returns your environments, one environment's details, its security domains, resource usage and monitoring metrics.

    Try: “List my CloudBase environments.”

    Network · queryEnv

  • Creates, upgrades or renews environments

    Lists plans, creates an environment, changes its plan, renews it, or adds and removes browser-origin (CORS) domains. Actions that cost money ask for confirmation.

    Try: “Add https://myapp.com to the allowed domains.”

    Write · manageEnv

  • Old way to edit allowed domains

    Deprecated. It manages the browser (CORS) allow-list and is replaced by the environment management tool, which does the same thing.

    Try: “Remove an old domain from the allow-list.”

    Write · envDomainManagement

  • Lists NoSQL collections and indexes

    Shows collections, their details and indexes, and checks whether an index exists.

    Try: “List the collections in my database.”

    Network · readNoSqlDatabaseStructure

  • Creates or deletes collections and indexes

    Adds or removes NoSQL collections and their indexes. Removing a collection drops it from the environment.

    Try: “Create a collection named orders with an index on userId.”

    Delete · writeNoSqlDatabaseStructure

  • Queries NoSQL records

    Reads records with filters, sorting and paging. Up to 1000 per call, 100 by default.

    Try: “Show the last 20 orders for user 42.”

    Network · readNoSqlDatabaseContent

  • Inserts, updates or deletes NoSQL records

    Writes records with insert, update, upsert and delete. Server-side writes carry no _openid, which can break row-level rules.

    Try: “Set status to shipped on order 123.”

    Delete · writeNoSqlDatabaseContent

  • Lists data models and their fields

    Read-only. Lists models, shows one model with its fields and relations, or generates SDK usage docs for it.

    Try: “Show the fields of the Product model.”

    Network · manageDataModel

  • Creates a data model from a diagram

    Builds a new data model from a Mermaid class diagram and waits for it to finish. It only creates new models.

    Try: “Create a Customer and Order model from this diagram.”

    Write · modifyDataModel

  • Reads from a PostgreSQL database

    Shows the Postgres context, objects, metadata and object structure, and runs read-only SQL.

    Try: “List the tables in my Postgres database.”

    Network · queryPgDatabase

  • Changes a PostgreSQL database

    Runs confirmed write SQL, checks SQL risk first, and manages migrations. Schema changes such as CREATE, ALTER and DROP go through migrations that are also saved as local files.

    Try: “Add an email column to users with a migration.”

    Delete · managePgDatabase

Read from the source code

Permissions

high risk · 5 things to watch

High risk

It can delete database records, files, services and keys, and change paid plans in your CloudBase environment. Use a test environment first, and prefer browser sign-in over a saved key pair.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete data, files and services

    Tools delete NoSQL records and collections, storage and hosting files, Cloud Run services, gateway routes, API keys and agents. Use a test environment first. github.com

  • It can create, renew and change paid plans

    The environment tool can create, upgrade or renew environments. These ask for confirmation, but read each request before you approve it. github.com

  • A static key pair never expires

    The README says a Secret ID and Key stays valid until rotated or deleted. Prefer browser sign-in, and keep keys out of repositories. github.com

  • Local mode reads and writes your files

    Upload, template download, deploy and local build tools use your project folder and run build commands. The README says local mode is equivalent to running the tools yourself. github.com

  • Any Tencent Cloud API can be called

    One general tool calls Tencent Cloud management actions by name, so it reaches past the CloudBase-specific tools. Review what it is asked to do. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toTencent Cloud CloudBase APIs (tcb-api.cloud.tencent.com or tcb-api.tencentcloud.com for the hosted endpoint)
Sign-in and keysHosted: browser sign-in, or a Tencent Cloud Secret ID and Key sent as headers. Local: login is saved on your machine, per site.

Questions

Is the CloudBase MCP server official?

Yes. It comes from Tencent Cloud's own CloudBase AI Toolkit repository, and the hosted endpoint is run by Tencent Cloud.

What is the CloudBase MCP server URL?

https://tcb-api.cloud.tencent.com/mcp/v1 for the China site and https://tcb-api.tencentcloud.com/mcp/v1 for the international site. Pick the site where your environment lives, because the two use separate accounts.

Do I need an API key?

No for the hosted address with browser sign-in. For CI or apps without browser sign-in, add env_id and a Tencent Cloud Secret ID and Key from the same site. Local mode logs you in through the auth tool.

Should I use the hosted address or run it locally?

The README recommends the hosted address for the fastest start. Run it locally if you need file upload or template download, which the hosted address does not offer.

Can I run it read-only?

No read-only switch is documented. You can turn tool groups off with the disable_plugins option on the hosted address or the CLOUDBASE_MCP_PLUGINS_DISABLED setting locally.

Does it work on the international site?

Yes, with the international endpoint. The README says that site does not yet expose NoSQL tools.

Do I need an existing CloudBase environment?

Yes. The README lists a CloudBase environment as a prerequisite, and tools work after one is bound with the sign-in tool. New users on the China site can create a free trial environment.

Information

updated Nov 2, 2026

Publisher
Official
Package
@cloudbase/cloudbase-mcp
Registry
npm
Endpoint
https://tcb-api.cloud.tencent.com/mcp/v1?env_id={env_id}
Transport
stdio, Streamable HTTP
Auth
OAuth
Version
2.36.2
License
MIT
Last commit
Oct 31, 2026
Open issues
1
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.