# AI Native 应用开发底座 > 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。 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 ## 步骤一：订阅套餐 1. 在 [开通管理-Agent Plan](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan) 页面购买 Agent Plan 个人版套餐。套餐说明参见[套餐概览](/docs/agent-plan-personal-plan-overview)。 2. 在控制台单击**Harness**，开启AI Native 应用开发底座的抵扣开关。 ![native.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/native.png) ## 步骤二：安装与更新 CLI - **安装** 执行以下命令，即可完成在 MCP Server、Skill 和 CLI 三种方式下的安装。 ```Bash npx @byted-supabase/cli@latest install ``` - **更新** 如安装过程中收到“A new version of Byted Supabase CLI is available”的提示，按照指引或执行以下命令即可完成更新。 ```Bash byted-supabase-cli update ``` ## 步骤三：登录 CLI ### 登录 / 初始配置 - **方式 1**：浏览器 OAuth 登录（推荐） ```Bash byted-supabase-cli login --is-agent-plan ``` - **方式 2**：用 AK/SK 配置默认 profile ```Bash byted-supabase-cli configure set --ak --sk --is-agent-plan ``` ### 企业版切换为个人版 如需从企业切换成个人版，只设置 `--is-agent-plan` 即可。 ```Bash byted-supabase-cli configure agent-plan --profile --is-agent-plan ``` > `--profile ` 用于指定已有的 profile 名称。profile 由 `configure set` 或 `login` 命令创建，直接传入名称即可。 ### 关闭 AgentPlan 默认设置 ```Bash byted-supabase-cli configure agent-plan --profile --is-agent-plan=false ``` > > `--profile ` 用于指定已有的 profile 名称。profile 由 `configure set` 或 `login` 命令创建，直接传入名称即可。 ## 步骤四：在工具中使用火山引擎 Supabase 目前支持通过 Skill、CLI、MCP Server 三种方式使用火山引擎 Supabase。 ### Skill 接入方式 通过 Skill 方式为 AI 工具快速安装并接入火山引擎 Supabase。 **选项：Claude Code** 1. 安装并配置 Claude Code，具体步骤见 [Claude Code](/docs/agent-plan-personal-claude-code)。 2. 在终端执行以下命令为 Claude Code 安装并接入火山引擎 Supabase Skill。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase --agent claude-code ``` 3. 安装完成后，执行 `claude` 命令启动 Claude Code。 4. 在 Claude Code 中通过自然语言使用火山引擎 Supabase 能力，具体参见 [使用自然语言管理资源](https://docs.volcengine.com/docs/87275/2105771?lang=zh)。 **选项：OpenCode** 1. 安装并配置 OpenCode，具体步骤见 [OpenCode](/docs/agent-plan-personal-opencode)。 2. 在终端执行以下命令为 OpenCode 安装并接入火山引擎 Supabase Skill。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase --agent opencode ``` 3. 安装完成后，执行 `opencode` 命令启动 OpenCode。 4. 在 OpenCode 中通过自然语言使用火山引擎 Supabase 能力，具体参见 [使用自然语言管理资源](https://docs.volcengine.com/docs/87275/2105771?lang=zh)。 **选项：OpenClaw** 1. 安装并配置 OpenClaw，具体步骤见 [OpenClaw](/docs/agent-plan-personal-openclaw)。 2. 在终端执行以下命令为 OpenClaw 安装并接入火山引擎 Supabase Skill。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase --agent openclaw ``` 3. 安装完成后，执行以下命令启动 OpenClaw。 ```Bash openclaw tui ``` 4. 在 OpenClaw 中通过自然语言使用火山引擎 Supabase 能力，具体参见 [使用自然语言管理资源](https://docs.volcengine.com/docs/87275/2105771?lang=zh)。 **选项：TraeCode** 1. 安装并配置 TraeCode，具体步骤见 [TraeCode](/docs/agent-plan-personal-trae)。 2. 在终端执行以下命令安装 `byted-supabase` Skill，安装过程中按需选择 agent。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-supabase ``` 3. 安装完成后，通过 TraeCode 打开对应的项目，在**设置-技能与命令**页面确认已安装 `byted-supabase` Skill。 4. 在 TraeCode 中通过自然语言使用火山引擎 Supabase 能力，具体参见 [使用自然语言管理资源](https://docs.volcengine.com/docs/87275/2105771?lang=zh)。 ### CLI 接入方式 通过 CLI 方式可在终端直接管理 Workspace 等资源，常用命令如下： - 创建 Workspace ```Bash byted-supabase-cli projects create --is-agent-plan ``` - 查询 Workspace 列表 ```Bash byted-supabase-cli projects list ``` - 查询某个 Workspace 的详细信息 ```Bash byted-supabase-cli projects list --workspace-id ``` ### MCP 接入方式 以下为常用 AI 工具的 MCP 接入方案，其他工具可按需调整配置文件格式。 **选项：Claude Code** 1. 安装并配置 Claude Code，具体步骤见 [Claude Code](/docs/agent-plan-personal-claude-code)。 2. 编辑配置文件 `~/.claude.json`，添加 MCP 配置。 ```JSON { ... "mcpServers": { "byted-supabase-mcp": { "command": "byted-supabase-cli", "args": [ "mcp", "serve", "--agent-plan" ] } } ... } ``` > **说明** > > 配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。 3. 在终端执行`claude`命令启动 Claude 服务后，输入`/mcp`后看到`byted-supabase-mcp`，说明配置成功。 4. MCP 安装完成后即可使用火山引擎 Supabase 能力。 **选项：OpenCode** 1. 安装并配置 OpenCode，具体步骤见 [OpenCode](/docs/agent-plan-personal-opencode)。 2. 编辑配置文件 `~/.config/opencode/opencode.json`，添加 MCP 配置。 ```JSON { ... "mcp": { "byted-supabase-mcp": { "command": "byted-supabase-cli", "args": [ "mcp", "serve", "--agent-plan" ] } } ... } ``` > **说明** > > 配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。 3. 在终端执行`opencode`命令启动 OpenCode 服务后，输入`/mcp`后看到`byted-supabase-mcp`状态为 Enabled，说明配置成功。 4. MCP 安装完成后即可使用火山引擎 Supabase 能力。 **选项：OpenClaw** 1. 安装并配置 OpenClaw，具体步骤见 [OpenClaw](/docs/agent-plan-personal-openclaw)。 2. 在终端执行如下命令安装 MCPorter。 ```Bash npm install -g mcporter ``` 3. 编辑配置文件 `~/.openclaw/openclaw.json`，添加 MCP 配置。 ```JSON { ... "mcp": { "servers": { "byted-supabase-mcp": { "command": "byted-supabase-cli", "args": [ "mcp", "serve", "--agent-plan" ] } } }, "skills": { "entries": { "mcporter": { "enabled": true } } } ... } ``` > **说明** > > 配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。 4. 在终端执行如下命令使配置生效。 ```Bash openclaw gateway restart ``` 5. 在项目目录下，执行如下命令查看已安装的 `byted-supabase-mcp` MCP。 ```Bash mcporter list ``` 6. 启动 OpenClaw，随后即可使用火山引擎 Supabase 能力。 **选项：TraeCode** 1. 安装并配置 TraeCode，具体步骤见 [TraeCode](/docs/agent-plan-personal-trae)。 2. 在设置页面，选择左侧菜单 **MCP**，在 MCP 页面右上角选择**添加-手动配置**。 3. 在手动配置弹窗添加 MCP 配置信息。 ```JSON { "mcpServers": { "byted-supabase-mcp": { "command": "byted-supabase-cli", "args": [ "mcp", "serve", "--agent-plan" ] } } } ``` 4. MCP 安装完成后，在 AI 对话框选择 **Agent** 模式使用火山引擎Supabase。 # 计费说明 - **未开启超额后付费**：请求调用产生的费用使用套餐内 AFP 进行抵扣，不消耗其他资源包或账户余额。抵扣规则参见 [套餐内 AFP 抵扣规则](/docs/agent-plan-personal-afp-credits-billing-rules#c8d3b9a1)。 - **开启超额后付费**：在套餐周期内额度未用尽时优先抵扣套餐额度；当套餐周期内额度用尽时，无需修改任何配置信息，系统将自动切换至超额后付费模式继续使用，并产生后付费账单。具体规则与操作参见 [超额后付费规则](/docs/agent-plan-personal-over-quota-postpaid-rules#8b7e0f2a) 和 [超额后付费管理](/docs/agent-plan-personal-over-quota-postpaid-management#1a2b3c4d)。 # 实践教程 **[搭建销售团队工作台](https://bytedance.larkoffice.com/wiki/WpXuw57E0i69sHkK9DNcraEPn1c)** 基于 Agent Plan + Codex + AI Native 应用开发底座 + 豆包搜索 + 专业数据集 + Agent 记忆，把散落在飞书会话、云文档里的私域销售资料和外部专业信息，搭成一个能查公司、看档案、问历史的销售团队定制工作台。 **[搭建资料管理与AI 问答工具](https://bytedance.larkoffice.com/docx/Qs00dZCoTod1FtxKTQScgKHKnjh)** 基于 Agent Plan + AI Native 应用开发底座，搭建一个面向个人和小团队的轻量资料管理与 AI 问答工具。该工具支持文件上传、共享协作、通知提醒，帮助用户存储资料、发现资料，是一个全栈 App。 # 常见问题 * 如何获取 Workspace 的连接信息？ 在 [AI 原生 BaaS 平台 Supabase 版](https://console.volcengine.com/aidap) 的 Workspace 详情页，可查看 Supabase URL、API Key 及数据库连接串。 * Workspace 暂停后数据会丢失吗？ 不会。暂停仅停止算力计费，数据存储空间仍会保留。恢复 Workspace 后可继续使用。 # 服务协议 - [产品和服务测试协议](https://docs.volcengine.com/docs/87275/2105928?lang=zh) - [Harness 能力说明和产品专用条款](/docs/harness-rules)