跳到主要内容

CloudBase 现已成为豆包官方精选插件

CloudBase TeamCloudBase Team
阅读需 7 分钟
CloudBase 现已成为豆包官方精选插件

字节跳动的 AI 助手豆包正式接入 CloudBase。桌面端与网页版两种形态,装上插件就能用自然语言管理云开发资源。

为什么是豆包​

豆包是字节跳动的 AI 助手,提供桌面端和网页版,两个客户端均可运行 CloudBase 插件。

在豆包的插件市场中,用户可以同时发现 GitHub、Gitee 以及火山 Supabase 等插件。腾讯云 CloudBase 现已作为官方精选插件入驻,位于「研发运维」分组,和 GitHub、Neon、PostgreSQL 等放在一起。

该插件由同名的连接器与同名技能两个部分组合而成。当用户在豆包客户端中成功启用此插件后,就可以在日常对话中通过发送自然语言指令,对云端资源进行各种管理与操作。

安装步骤​

要在豆包中安装与启用 CloudBase 插件,请按照以下步骤操作:

  1. 打开豆包桌面端,点击左侧导航栏的「插件·技能·伙伴」按钮。
  2. 页面顶部展示有「插件」、「技能」和「工作伙伴」三个主要标签页。
  3. 选择「插件」标签,并在默认的「精选」分类列表下浏览。
  4. 往下拉到「研发运维」分组;也可以在右上角的「搜索插件 / 管理 / +添加」区域直接搜索。
  5. 找到「腾讯云 CloudBase」卡片,点击右侧的「安装」。

豆包「精选」里的腾讯云 CloudBase 插件卡片

该精选页面内显示了腾讯云 CloudBase 插件卡片。卡片上提供了一句话描述:「通过腾讯云 CloudBase,构建和管理 Web 应用后端:数据库、云函数、云存储、认证与部署」。

安装完成后,在「管理」面板里可以看到这个插件的开关,以及它包含的连接器与技能。

豆包的 CloudBase 插件管理面板:连接器与技能,开关已打开

背后的技术:远端 MCP + 标准 OAuth 授权​

这个插件不需要你填任何 SecretId 或 API Key,授权在浏览器里点几下就完成。首次连接 CloudBase 时,豆包会把你带到腾讯云 CloudBase 的官方授权页。

该授权页面的标题为「授权 Doubao Connector」。页面中部会显示提示说明,其内容为「该应用申请访问您的 CloudBase 云开发环境」。页面底部同时会标明:「授权成功后将会跳转至 api.doubao-dev.com」。

页面上还会显示当前登录的腾讯云 UIN 账号,以及一句话授权说明:「读取和操作您选中的 CloudBase 环境内的所有资源」。

接下来在授权页里选一个要授权给豆包的环境,再点「授权访问」。

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 授权。选你的客户端,拿对应的配置和安装步骤:

Client
连接方式
站点

远端模式只需填地址,客户端会在浏览器里引导你完成登录授权,密钥不落到配置文件。

配置你的 AI 工具以连接 CloudBase 能力 支持本地与远端两种连接方式,详见 连接方式。

步骤 1:安装 / 配置 CloudBase

一键安装:

Add to Cursor

或手动配置:

将以下配置添加到项目目录下的 .cursor/mcp.json:

json
1{
2 "mcpServers": {
3 "cloudbase": {
4 "type": "http",
5 "url": "https://tcb-api.cloud.tencent.com/mcp/v1"
6 }
7 }
8}
需要帮助?查看 Cursor 文档

步骤 2:和 AI 对话

在 AI 对话中依次输入以下内容:

prompt
阅读 https://docs.cloudbase.net/skill.md,帮我介绍可以做什么
使用 CloudBase Skills: 帮我检查这个 CloudBase Web 项目有没有鉴权配置问题

国际站是同一套结构,端点为 https://tcb-api.tencentcloud.com/mcp/v1。

下一步​

用 CloudBase 构建下一款应用

一站式后端云服务,覆盖数据库、云函数、静态托管与 AI 能力。