AI Native 应用开发底座

AI Native 应用开发底座基于火山引擎 Supabase 实现，作为 Agent Plan 的 Harness 为 AI 工具（Claude Code、OpenClaw、TraeCode 等）提供云端数据库与后端基础设施，使 Agent 在开发应用时可直接通过 MCP Server 或 Skill 方式调用数据库、认证、存储、边缘函数等能力，无需手动搭建后端环境。

能力介绍#

火山引擎 Supabase，全称是 AI 原生 BaaS 平台 Supabase 版，是基于开源 Supabase 打造，100% 兼容 Supabase 开源用法，包括 PostgreSQL Database、Authentication、Storage、Edge Function、Realtime、AI 助手、API Docs 等，具备云原生服务特有的高弹性低价格等特点。基于火山引擎数据库 Serverless 架构，实现了更好可用性、性能和成本优势，可以高性价比一站式地满足用户在 AI Agent 开发构建、SaaS 服务开发、原型系统快速构建等场景的诉求。

支持的核心能力如下：

Database：基于 Serverless 的 PostgreSQL，支持秒级扩缩容（Scale to Zero）、数据分支管理及丰富插件。
Authentication：提供完整的认证体系，支持短信/邮箱、各类第三方授权、单点登录，并允许自定义逻辑。
Storage：提供对象存储服务，用于轻松管理文件的上传、下载及精细的权限控制。
Edge Function：边缘函数服务，支持在靠近用户的边缘节点快速执行各类自定义服务端逻辑。
Realtime：提供实时数据同步功能，支持将数据库变更结果进行实时推送与广播。
MCP Server：基于 MCP 协议的专属服务，支持通过自然语言直接输入与管理各类数据库资源。
前端部署：对接火山引擎 Pages，支持“推送即发布”（Push-to-Deploy）的一站式发布能力。开发者将代码推送至 Git 仓库后，平台可自动完成构建、部署和线上预览，打通"自然语言生成代码"到"应用发布"的最后一环，帮助用户降低部署运维成本，快速验证和交付应用。

使用限制#

仅支持完成了实名认证的企业用户和个人用户使用。
仅支持在北京地域使用 Agent Plan 套餐的 AFP 额度抵扣火山引擎 Supabase 资源的使用费用。
首次使用时，请注意：
- 如您是主账号：请为账号授权 ServiceRoleForAIDAP 角色。
- 如您是子账号：请联系主账号授权 ServiceRoleForAIDAP 角色，并为您再授予 IAM 的 AIDAPFullAccess 预设策略或包含 AIDAP 权限点的自定义策略。

使用火山引擎 Supabase#

步骤一：订阅套餐#

在开通管理-Agent Plan 页面购买 Agent Plan 个人版套餐。套餐说明参见套餐概览。
在控制台单击Harness，开启AI Native 应用开发底座的抵扣开关。

步骤二：安装与更新 CLI#

安装
执行以下命令，即可完成在 MCP Server、Skill 和 CLI 三种方式下的安装。
Bash
```
1npx @byted-supabase/cli@latest install
```
更新
如安装过程中收到“A new version of Byted Supabase CLI is available”的提示，按照指引或执行以下命令即可完成更新。
Bash
```
1byted-supabase-cli update
```

步骤三：登录 CLI#

登录 / 初始配置#

方式 1：浏览器 OAuth 登录（推荐）
Bash
```
1byted-supabase-cli login --is-agent-plan
```

方式 2：用 AK/SK 配置默认 profile

1byted-supabase-cli configure set --ak <AK> --sk <SK> --is-agent-plan

企业版切换为个人版#

如需从企业切换成个人版，只设置 --is-agent-plan 即可。

1byted-supabase-cli configure agent-plan --profile <profile-name> --is-agent-plan

--profile <profile-name> 用于指定已有的 profile 名称。profile 由 configure set 或 login 命令创建，直接传入名称即可。

关闭 AgentPlan 默认设置#

1byted-supabase-cli configure agent-plan --profile <profile-name> --is-agent-plan=false

--profile <profile-name> 用于指定已有的 profile 名称。profile 由 configure set 或 login 命令创建，直接传入名称即可。

步骤四：在工具中使用火山引擎 Supabase#

目前支持通过 Skill、CLI、MCP Server 三种方式使用火山引擎 Supabase。

Skill 接入方式#

通过 Skill 方式为 AI 工具快速安装并接入火山引擎 Supabase。

安装并配置 Claude Code，具体步骤见 Claude Code。

在终端执行以下命令为 Claude Code 安装并接入火山引擎 Supabase Skill。

1npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase --agent claude-code

安装完成后，执行 claude 命令启动 Claude Code。
在 Claude Code 中通过自然语言使用火山引擎 Supabase 能力，具体参见使用自然语言管理资源。

安装并配置 OpenCode，具体步骤见 OpenCode。

在终端执行以下命令为 OpenCode 安装并接入火山引擎 Supabase Skill。

1npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase --agent opencode

安装完成后，执行 opencode 命令启动 OpenCode。
在 OpenCode 中通过自然语言使用火山引擎 Supabase 能力，具体参见使用自然语言管理资源。

安装并配置 OpenClaw，具体步骤见 OpenClaw。

在终端执行以下命令为 OpenClaw 安装并接入火山引擎 Supabase Skill。

1npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase --agent openclaw

安装完成后，执行以下命令启动 OpenClaw。
Bash
```
1openclaw tui
```
在 OpenClaw 中通过自然语言使用火山引擎 Supabase 能力，具体参见使用自然语言管理资源。

安装并配置 TraeCode，具体步骤见 TraeCode。

在终端执行以下命令安装 byted-supabase Skill，安装过程中按需选择 agent。

1npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase

安装完成后，通过 TraeCode 打开对应的项目，在设置-技能与命令页面确认已安装 byted-supabase Skill。
在 TraeCode 中通过自然语言使用火山引擎 Supabase 能力，具体参见使用自然语言管理资源。

CLI 接入方式#

通过 CLI 方式可在终端直接管理 Workspace 等资源，常用命令如下：

创建 Workspace

1byted-supabase-cli projects create <your_workspace_name> --is-agent-plan

查询 Workspace 列表
Bash
```
1byted-supabase-cli projects list
```

查询某个 Workspace 的详细信息

1byted-supabase-cli projects list --workspace-id <Workspace-id>

MCP 接入方式#

以下为常用 AI 工具的 MCP 接入方案，其他工具可按需调整配置文件格式。

安装并配置 Claude Code，具体步骤见 Claude Code。

编辑配置文件 ~/.claude.json，添加 MCP 配置。

1
2
3
4
5
6
7
8
9
10
11
12
13
14{
  ...
  "mcpServers": {
    "byted-supabase-mcp": {
      "command": "byted-supabase-cli",
      "args": [
        "mcp",
        "serve",
        "--agent-plan"
      ]
    }
  }
  ...
}

在终端执行claude命令启动 Claude 服务后，输入/mcp后看到byted-supabase-mcp，说明配置成功。
MCP 安装完成后即可使用火山引擎 Supabase 能力。

安装并配置 OpenCode，具体步骤见 OpenCode。

编辑配置文件 ~/.config/opencode/opencode.json，添加 MCP 配置。

1
2
3
4
5
6
7
8
9
10
11
12
13
14{
  ...
  "mcp": {
    "byted-supabase-mcp": {
      "command": "byted-supabase-cli",
      "args": [
        "mcp",
        "serve",
        "--agent-plan"
      ]
    }
  }
  ...
}

在终端执行opencode命令启动 OpenCode 服务后，输入/mcp后看到byted-supabase-mcp状态为 Enabled，说明配置成功。
MCP 安装完成后即可使用火山引擎 Supabase 能力。

安装并配置 OpenClaw，具体步骤见 OpenClaw。
在终端执行如下命令安装 MCPorter。
Bash
```
1npm install -g mcporter
```

编辑配置文件 ~/.openclaw/openclaw.json，添加 MCP 配置。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23{
  ...
  "mcp": {
    "servers": {
      "byted-supabase-mcp": {
        "command": "byted-supabase-cli",
        "args": [
          "mcp",
          "serve",
          "--agent-plan"
        ]
      }
    }
  },
  "skills": {
    "entries": {
      "mcporter": {
        "enabled": true
      }
    }
  }
  ...
}

在终端执行如下命令使配置生效。
Bash
```
1openclaw gateway restart
```
在项目目录下，执行如下命令查看已安装的 byted-supabase-mcp MCP。
Bash
```
1mcporter list
```
启动 OpenClaw，随后即可使用火山引擎 Supabase 能力。

安装并配置 TraeCode，具体步骤见 TraeCode。
在设置页面，选择左侧菜单 MCP，在 MCP 页面右上角选择添加-手动配置。

在手动配置弹窗添加 MCP 配置信息。

1
2
3
4
5
6
7
8
9
10
11
12{
  "mcpServers": {
    "byted-supabase-mcp": {
      "command": "byted-supabase-cli",
      "args": [
        "mcp",
        "serve",
        "--agent-plan"
      ]
    }
  }
}

MCP 安装完成后，在 AI 对话框选择 Agent 模式使用火山引擎Supabase。

计费说明#

未开启超额后付费：请求调用产生的费用使用套餐内 AFP 进行抵扣，不消耗其他资源包或账户余额。抵扣规则参见套餐内 AFP 抵扣规则。
开启超额后付费：在套餐周期内额度未用尽时优先抵扣套餐额度；当套餐周期内额度用尽时，无需修改任何配置信息，系统将自动切换至超额后付费模式继续使用，并产生后付费账单。具体规则与操作参见超额后付费规则和超额后付费管理。

实践教程#

搭建销售团队工作台
基于 Agent Plan + Codex + AI Native 应用开发底座 + 豆包搜索 + 专业数据集 + Agent 记忆，把散落在飞书会话、云文档里的私域销售资料和外部专业信息，搭成一个能查公司、看档案、问历史的销售团队定制工作台。

搭建资料管理与AI 问答工具
基于 Agent Plan + AI Native 应用开发底座，搭建一个面向个人和小团队的轻量资料管理与 AI 问答工具。该工具支持文件上传、共享协作、通知提醒，帮助用户存储资料、发现资料，是一个全栈 App。

常见问题#

如何获取 Workspace 的连接信息？

在 AI 原生 BaaS 平台 Supabase 版的 Workspace 详情页，可查看 Supabase URL、API Key 及数据库连接串。
Workspace 暂停后数据会丢失吗？

不会。暂停仅停止算力计费，数据存储空间仍会保留。恢复 Workspace 后可继续使用。

AI Native 应用开发底座

能力介绍#

使用限制#

使用火山引擎 Supabase#

步骤一：订阅套餐#

步骤二：安装与更新 CLI#

步骤三：登录 CLI#

登录 / 初始配置#

企业版切换为个人版#

关闭 AgentPlan 默认设置#

步骤四：在工具中使用火山引擎 Supabase#

Skill 接入方式#

CLI 接入方式#

MCP 接入方式#

计费说明#

实践教程#

常见问题#

服务协议#