文档中心

火山方舟

配置 Harness

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 三种方式下的安装。

npx @byted-supabase/cli@latest install

更新

如安装过程中收到“A new version of Byted Supabase CLI is available”的提示，按照指引或执行以下命令即可完成更新。

byted-supabase-cli update

步骤三：登录 CLI

方式 1：浏览器 OAuth 登录（推荐）

byted-supabase-cli login --is-agent-plan

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

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

企业版切换为个人版

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

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

关闭 AgentPlan 默认设置

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

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

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

Skill 接入方式

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

Claude Code

OpenCode

OpenClaw

TraeCode

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

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

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

安装完成后，执行 claude 命令启动 Claude Code。

在 Claude Code 中通过自然语言使用火山引擎 Supabase 能力，具体参见使用自然语言管理资源。

CLI 接入方式

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

创建 Workspace

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

查询 Workspace 列表

byted-supabase-cli projects list

查询某个 Workspace 的详细信息

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

MCP 接入方式

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

Claude Code

OpenCode

OpenClaw

TraeCode

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

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

{
...
"mcpServers": {
"byted-supabase-mcp": {
"command": "byted-supabase-cli",
"args": [
"mcp",
"serve",
"--agent-plan"
]
}
}
...
}

说明

配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。

在终端执行claude命令启动 Claude 服务后，输入/mcp后看到byted-supabase-mcp，说明配置成功。

MCP 安装完成后即可使用火山引擎 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 后可继续使用。

服务协议

产品和服务测试协议

Harness 能力说明和产品专用条款

最近更新时间：2026.09.14 11:10:08

这个页面对您有帮助吗？

有用

无用