bkend-quickstart

用途

bkend-quickstart 是 bkend.ai 的入门引导技能，面向希望在 AI 工具中接入 bkend.ai 后端服务的开发者。bkend.ai 是一个基于 MCP 的 BaaS（后端即服务）平台，提供数据库、身份认证和存储服务，允许用户通过自然语言从 AI 工具（如 Claude Code、Cursor）管理后端。

主要能力

该技能提供以下内容：

MCP 连接设置：通过一条命令完成 Claude Code 与 bkend.ai 的 MCP 连接。
资源层级说明：组织（团队/计费）→ 项目（服务单元）→ 环境（dev/staging/prod，数据隔离）。
租户与用户模型：租户为服务构建者（OAuth 2.1 认证，可访问 MCP/管理 API）；用户为应用终端用户（JWT 认证，可访问服务 API）；同一人可同时具备两种角色。
MCP 固定工具：get_context（会话上下文）、search_docs（搜索文档）、get_operation_schema（获取工具输入/输出 schema）。
MCP 项目管理工具：backend_org_list、backend_project_list、backend_project_get、backend_project_create、backend_project_update、backend_project_delete、backend_env_list、backend_env_get、backend_env_create。
MCP 资源（只读）：通过 bkend:// URI 进行轻量、缓存（60 秒 TTL）的只读查询，包括组织列表、项目列表、环境列表、表列表及 schema。
可搜索指南：通过 search_docs 访问 1_concepts（BSON schema、权限、层级）和 2_tutorial（项目到表创建教程）。
故障排查：针对 OAuth 弹窗未出现、MCP 工具不可见、连接丢失、项目/环境错误等问题的解决方案。

使用方式

快速设置（一条命令）

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

分步指南

前置条件：拥有 bkend.ai 账号（在 https://console.bkend.ai 注册）。
运行设置命令：claude mcp add bkend --transport http https://api.bkend.ai/mcp
OAuth 认证：浏览器自动打开进行 OAuth 2.1 + PKCE 认证（无需 API key）。
验证连接：询问“Show my connected bkend projects”或使用 get_context MCP 工具。
创建 .mcp.json（可选，用于团队共享）：

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

首个项目清单

在 bkend.ai 注册 → 创建组织
创建项目 → 自动创建 dev 环境
连接 MCP → claude mcp add bkend
创建首个表 → “Create a users table”
开始数据操作 → 通过自然语言进行 CRUD

控制台 URL：https://console.bkend.ai

适用场景

首次接入 bkend.ai 的开发者。
需要在 Claude Code 或 Cursor 中配置 bkend MCP 连接的用户。
需要了解 bkend.ai 资源层级和租户/用户模型的用户。
需要创建首个 bkend 项目并开始数据操作的用户。

限制

该技能主要针对 Claude Code 的 MCP 设置，其他 AI 工具的配置方式资料中未提供。
删除项目操作不可逆。
部分功能（如数据库操作、认证、文件存储、实用教程）需参考其他技能（bkend-data、bkend-auth、bkend-storage、bkend-cookbook）。
官方文档为实时参考，需通过 WebFetch 获取最新内容。