bkend-quickstart

bkend.ai 快速入门指南

什么是 bkend.ai

基于 MCP 的 BaaS 平台，提供数据库、身份验证和存储服务。 通过 AI 工具（Claude Code、Cursor）使用自然语言管理后端。

资源层级

Organization (team/billing) -> Project (service unit) -> Environment (dev/staging/prod, data isolation)

租户与用户

• 租户：服务构建者（OAuth 2.1 身份验证，可访问 MCP/Management API）
• 用户：应用终端用户（JWT 身份验证，可访问 Service API）
• 同一人可以同时拥有这两种角色

MCP 设置（Claude Code）

快速设置（一条命令）

claude mcp add bkend --transport http https://api.bkend.ai/mcp

分步指南

1. 前置条件：bkend.ai 账号（在 https://console.bkend.ai 注册）
2. 运行设置命令：claude mcp add bkend --transport http https://api.bkend.ai/mcp
3. OAuth 身份验证：浏览器会自动打开，进行 OAuth 2.1 + PKCE 身份验证（无需 API 密钥）
4. 验证连接：询问“显示我已连接的 bkend 项目”，或使用 get_context MCP 工具
5. 创建 .mcp.json（可选，用于团队共享）：

   {
     "mcpServers": {
       "bkend": {
         "type": "http",
         "url": "https://api.bkend.ai/mcp"
       }
     }
   }
   

MCP 连接故障排除

问题	解决方案
未出现 OAuth 弹窗	检查浏览器是否拦截了弹窗
看不到 MCP 工具	运行 claude mcp list 进行验证，如有需要则重新添加
连接丢失	重新进行身份验证（下次调用 MCP 时会自动进行）
项目/环境错误	使用 get_context 检查当前会话

MCP 固定工具

工具	用途
get_context	会话上下文（组织/项目/环境、API 端点）
search_docs	搜索 bkend 文档
get_operation_schema	获取工具输入/输出架构

可搜索指南（通过 search_docs）

文档 ID	内容
1_concepts	BSON 架构、权限、层级
2_tutorial	项目和表创建教程

MCP 项目管理工具

工具	用途	关键参数
backend_org_list	列出组织	无
backend_project_list	列出项目	organizationId
backend_project_get	获取项目详情	organizationId, projectId
backend_project_create	创建项目	organizationId, name, description?
backend_project_update	更新项目	organizationId, projectId, name?, description?
backend_project_delete	删除项目（不可撤销！）	organizationId, projectId
backend_env_list	列出环境	organizationId, projectId
backend_env_get	获取环境详情	organizationId, projectId, environmentId
backend_env_create	创建环境	organizationId, projectId, name

MCP 资源（只读）

通过 bkend:// URI 执行轻量级、已缓存（TTL 为 60 秒）的只读查询：

URI	描述
bkend://orgs	组织列表
bkend://orgs/{orgId}/projects	项目列表
bkend://orgs/{orgId}/projects/{pId}/environments	环境列表
bkend://orgs/{orgId}/projects/{pId}/environments/{eId}/tables	包含架构的表列表

提示：列举操作优先使用资源而非工具（更轻量且有缓存）。

第一个项目检查清单

1. 在 bkend.ai 注册 -> 创建组织
2. 创建项目 -> 自动创建 dev 环境
3. 连接 MCP -> claude mcp add bkend
4. 创建第一张表 -> “创建一个 users 表”
5. 开始数据操作 -> 使用自然语言执行 CRUD

控制台 URL

https://console.bkend.ai

后续步骤

• 数据库操作：参阅 bkend-data skill
• 身份验证：参阅 bkend-auth skill
• 文件存储：参阅 bkend-storage skill
• 实用教程：参阅 bkend-cookbook skill

官方文档（实时参考）

如需获取最新的 bkend 文档，请使用 WebFetch：

• 快速入门：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/02-quick-start.md
• 核心概念：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/03-core-concepts.md
• Claude Code 设置：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/ai-tools/04-claude-code-setup.md
• MCP 概览：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/01-overview.md
• 完整目录：https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md