字节跳动的 AI 助手豆包正式接入 CloudBase。桌面端与网页版两种形态,装上插件就能用自然语言管理云开发资源。
为什么是豆包
豆包是字节跳动的 AI 助手,提供桌面端和网页版,两个客户端均可运行 CloudBase 插件。
在豆包的插件市场中,用户可以同时发现 GitHub、Gitee 以及火山 Supabase 等插件。腾讯云 CloudBase 现已作为官方精选插件入驻,位于「研发运维」分组,和 GitHub、Neon、PostgreSQL 等放在一起。
该插件由同名的连接器与同名技能两个部分组合而成。当用户在豆包客户端中成功启用此插件后,就可以在日常对话中通过发送自然语言指令,对云端资源进行各种管理与操作。
安装步骤
要在豆包中安装与启用 CloudBase 插件,请按照以下步骤操作:
- 打开豆包桌面端,点击左侧导航栏的「插件·技能·伙伴」按钮。
- 页面顶部展示有「插件」、「技能」和「工作伙伴」三个主要标签页。
- 选择「插件」标签,并在默认的「精选」分类列表下浏览。
- 往下拉到「研发运维」分组;也可以在右上角的「搜索插件 / 管理 / +添加」区域直接搜索。
- 找到「腾讯云 CloudBase」卡片,点击右侧的「安装」。

该精选页面内显示了腾讯云 CloudBase 插件卡片。卡片上提供了一句话描述:「通过腾讯云 CloudBase,构建和管理 Web 应用后端:数据库、云函数、云存储、认证与部署」。
安装完成后,在「管理」面板里可以看到这个插件的开关,以及它包含的连接器与技能。

背后的技术:远端 MCP + 标准 OAuth 授权
这个插件不需要你填任何 SecretId 或 API Key,授权在浏览器里点几下就完成。首次连接 CloudBase 时,豆包会把你带到腾讯云 CloudBase 的官方授权页。
该授权页面的标题为「授权 Doubao Connector」。页面中部会显示提示说明,其内容为「该应用申请访问您的 CloudBase 云开发环境」。页面底部同时会标明:「授权成功后将会跳转至 api.doubao-dev.com」。
页面上还会显示当前登录的腾讯云 UIN 账号,以及一句话授权说明:「读取和操作您选中的 CloudBase 环境内的所有资源」。
接下来在授权页里选一个要授权给豆包的环境,再点「授权访问」。

如果你是新用户、账号下还没有环境,授权页会提示你先创建一个。新用户可以免费开通,创建完回到本页刷新,就能看到新环境并选中。

以后 想换到别的环境上开发,重新走一遍授权、在授权页里选另一个环境就行,不需要改任何配置。
授权完成后,页面会自动跳转回 api.doubao-dev.com,整个过程都不需要你手动填写任何密钥。
回到豆包的对话窗口,插件的开关是打开的,连接器那一栏显示已连接。这时候说「看下我环境里的云函数」,它会去查你的环境并把结果列出来;说「把所有函数的内存改成 512MB」,它也是真的去改,改完会告诉你哪些动了。
远端 MCP 服务与动态客户端注册
豆包客户端接入的是我们的远端 MCP 服务。该服务的数据传输基于 Streamable HTTP 协议。我们为国内站提供的 MCP 远端服务端点地址为 https://tcb-api.cloud.tencent.com/mcp/v1。
在此架构中,鉴权完全遵循标准的 OAuth 2.0 规范。两处公开的元数据端点都可用:
- OAuth 2.0 授权服务器元数据(符合 RFC 8414 标准):
https://tcb-api.cloud.tencent.com/.well-known/oauth-authorization-server - 受保护资源元数据(符合 RFC 9728 标准):
https://tcb-api.cloud.tencent.com/.well-known/oauth-protected-resource
在授权服务器元数据中,包含了关键的接口地址,如 authorization_endpoint(路径为 /mcp/oauth2/authorize)、token_endpoint(路径为 /mcp/oauth2/token)以及 registration_endpoint(路径为 /mcp/oauth2/register)。
在受保护资源元数据中,声 明的 resource 对应上述 MCP 服务端点,而支持的承载令牌方法 bearer_methods_supported 则为 header。
得益于 registration_endpoint 的存在,客户端可以通过动态客户端注册(DCR,符合 RFC 7591 标准)来实现自我注册。这意味着客户端不需要提前向腾讯云申请 client_id,而是能够根据规范在运行时动态获取。
此外,授权码流程要求使用 PKCE(符合 RFC 7636 标准)。在元数据中,code_challenge_methods_supported 指定为 ["S256"]。
我们的服务支持的授权类型 grant_types_supported 包含 authorization_code 和 refresh_token,支持的范围 scopes_supported 定义为 mcp:full。
我们提供两种运行模式供开发者进行权衡:
- 远端模式:只给客户端一个 URL,OAuth 流程由客户端在后台自动发起并完成。
- 本地模式:通过
npx @cloudbase/cloudbase-mcp@latest启动一个 stdio 进程;依赖本地文件系统的能力(如本地文件上传、模板下载到本机)只有本地模式可用;本机访问不了外网时也用本地模式。
开发微信小程序
要做的是微信小程序,授权流程完全一样,只有登录方式不同:登录 CloudBase 时选微信公众平台登录,用小程序对应的公众平台账号进去,而不是腾讯云账号。
这样进去之后,授权页里能选到的就是你小程序账号下的那套环境。选好环境、点「授权访问」,回到豆包照常说需求。
后端部分可以交给它:建集合、写云函数、往存储里传文件,都是对话里说一句。小程序前端还是在微信开发者工具里写,云函数里用 wx-server-sdk 拿 OPENID,小程序侧用 wx.cloud 直接调,这两步不用额外配鉴权。
一键接入其他客户端
这套基于远端 MCP 服务的标准授权机制同样支持在其他开发者客户端中接入:客户端会自动拉取配置,并走同一套 OAuth 授权。选你的客户端,拿对应的配置和安装步骤:
远端模式只需填地址,客户端会在浏览器里引导你完成登录授权,密钥不落到配置文件。
配置你的 AI 工具以连接 CloudBase 能力 支持本地与远端两种连接方式,详见 连接方式。
步骤 1:安装 / 配置 CloudBase
一键安装:
或手动配置:
将以下配置添加到项目目录下的 .cursor/mcp.json:
1{2 "mcpServers": {3 "cloudbase": {4 "type": "http",5 "url": "https://tcb-api.cloud.tencent.com/mcp/v1"6 }7 }8}步骤 2:和 AI 对话
在 AI 对话中依次输入以下内容:
阅读 https://docs.cloudbase.net/skill.md,帮我介绍可以做什么使用 CloudBase Skills: 帮我检查这个 CloudBase Web 项目有没有鉴权配置问题国际站是同一套结构,端点为 https://tcb-api.tencentcloud.com/mcp/v1。
下一步
- CloudBase AI Toolkit 开发者总览 — 了解工具包支持的运行环境以及后端能力的完整介绍
- 连接模式说明 — 详细了解本地开发模式与远端托管模式之间的区别与适用场景
- GitHub 开源仓库 — 查看云开发 AI 工具包的源码,提交反馈或参与功能贡献