
How to add CloudBase MCP to Claude Desktop
把腾讯云 CloudBase 接入 AI IDE,让 AI 生成的应用从提示词一键部署上线。 Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 · 1.0k★ · stdio · apikey · official
Claude Desktop config for CloudBase MCP
npx @cloudbase/cloudbase-mcp@latest{
"mcpServers": {
"cloudbase-mcp": {
"command": "npx",
"args": [
"@cloudbase/cloudbase-mcp@latest"
]
}
}
}Setup steps
- 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the CloudBase MCP config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm CloudBase MCP's tools appear under the 🔌 tools menu.
Before you start
- Node.js v18.15.0 及以上版本(本地模式需能执行 npx)
- 已开通腾讯云开发环境(CloudBase 环境)
- 支持 MCP 的 AI IDE(Cursor、WindSurf、CodeBuddy、Claude Code、Gemini CLI 等)
- 托管/云端模式需提供腾讯云 API 密钥(SecretId / SecretKey)及环境 ID
What CloudBase MCP can do in Claude Desktop
authCloudBase 开发阶段登录与环境绑定:查询状态、发起登录、绑定环境(set_env)、退出登录、获取临时密钥。
queryEnv查询 CloudBase 环境信息:环境列表/摘要筛选、指定环境详情(含计费信息)、安全域名列表。
envDomainManagement管理环境的安全域名(CORS 白名单),支持添加和删除。
readNoSqlDatabaseStructure读取 NoSQL 数据库集合与索引结构:列出集合、集合详情、列出索引、检查索引存在性。
writeNoSqlDatabaseStructure创建、删除和管理 NoSQL 数据库集合(collection)。
readNoSqlDatabaseContent查询 NoSQL 数据库记录,支持按条件筛选、分页、排序。
writeNoSqlDatabaseContent修改 NoSQL 数据库记录,支持插入、更新($set/$inc/$push 等)、删除、upsert。
manageDataModel数据模型只读查询工具,支持查询和列表数据模型。
Security
本地模式(npx)下 MCP 服务运行在开发者本机,通过 stdio 与 AI IDE 通信,代码不会离开本机直到主动部署;部分工具(如 downloadRemoteFile、manageCloudRun run)本质等同于开发者在本机执行命令。若在远程服务器上自建部署,务必设置环境变量 CLOUDBASE_MCP_CLOUD_MODE=true(或 MCP_CLOUD_MODE=true),启用后会自动禁用所有涉及本地文件读写和本地进程启动的工具(如 downloadRemoteFile、downloadTemplate、manageStorage、createFunction 等),防止远程调用方操作服务器本地资源;腾讯云托管模式(Streamable HTTP)已自动启用该保护。托管/云端模式需配置腾讯云 SecretId/SecretKey,均走 HTTPS 加密。
CloudBase MCP + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the CloudBase MCP config there under the "mcpServers" key and restart the client.
Is CloudBase MCP safe to use with Claude Desktop?
本地模式(npx)下 MCP 服务运行在开发者本机,通过 stdio 与 AI IDE 通信,代码不会离开本机直到主动部署;部分工具(如 downloadRemoteFile、manageCloudRun run)本质等同于开发者在本机执行命令。若在远程服务器上自建部署,务必设置环境变量 CLOUDBASE_MCP_CLOUD_MODE=true(或 MCP_CLOUD_MODE=true),启用后会自动禁用所有涉及本地文件读写和本地进程启动的工具(如 downloadRemoteFile、downloadTemplate、manageStorage、createFunction 等),防止远程调用方操作服务器本地资源;腾讯云托管模式(Streamable HTTP)已自动启用该保护。托管/云端模式需配置腾讯云 SecretId/SecretKey,均走 HTTPS 加密。
跟 Vercel / Railway / Netlify 有什么不同?
这些平台解决的是「部署」,CloudBase MCP 解决的是「从 AI 生成代码到部署上线」的完整链路。无需离开 IDE、无需写配置文件,AI 自动搞定云函数、数据库、CDN、域名等所有云资源。
不用 Cursor / Copilot 这些 AI IDE 也能用吗?
可以。CloudBase MCP 基于标准 MCP 协议,支持所有兼容 MCP 的工具,包括 Claude Code、Gemini CLI、OpenCode 等命令行工具,只要能配置 MCP Server 即可使用。
我的代码会被上传到哪里?安全吗?
代码只会部署到你自己的腾讯云开发环境,不经过任何第三方。本地模式下 MCP 服务运行在本机,代码不会离开电脑直到主动部署,所有云端通信均走 HTTPS 加密。