关于 bkend-cookbook
bkend-cookbook 是 bkend.ai 应用开发指南与故障排查资料，面向构建常见应用的开发者。它提供从入门到进阶的项目示例、分章节完整指南和常见错误处理参考。
主要功能
- 01涵盖多种应用项目示例
- 02提供四个分章节完整指南
- 03梳理常见开发实施步骤
- 04列出错误原因与处理方法
- 05汇总常见配置问题
适用场景
- 01参考教程构建博客或食谱应用
- 02规划包含认证与文件上传的开发步骤
- 03排查授权、限流或 MCP 连接错误
MCP 相关
资料涵盖 MCP 连接失败的排查，包括完成浏览器 OAuth 认证，以及检查 Claude Code 中的 MCP 连接状态。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/bkend-cookbook确认已加载。
详细介绍
bkend.ai 指南与故障排除
单项目指南
| 项目 | 难度 | 主要功能 |
|---|---|---|
| 待办应用 | 入门 | 基本 CRUD、状态管理 |
| 笔记应用 | 入门 | 富文本、分类 |
| 博客 | 中级 | 文章、标签、文件上传 |
| 聊天应用 | 中级 | 实时消息 |
| 电子商务 | 中级 | 商品、订单、支付 |
| 预约系统 | 中级 | 预约、日历 |
| 社交动态 | 高级 | 帖子、关注、动态流 |
| 仪表板 | 高级 | 图表、分析、角色 |
| 多租户 | 高级 | 按组织范围限定数据 |
| SaaS 入门模板 | 高级 | 订阅、计费、引导流程 |
完整指南项目（4 个，每个包含快速入门和 7 个章节）
| 项目 | 身份验证 | 核心 CRUD | 文件 | 高级功能 | AI |
|---|---|---|---|---|---|
| 博客 | 邮箱/社交 | 文章、标签 | 图片 | 收藏 | AI 摘要 |
| 食谱应用 | 邮箱/社交 | 食谱、食材 | 照片 | 膳食计划、购物清单 | AI 推荐 |
| 购物商城 | 邮箱/社交 | 商店、商品、订单 | 商品图片 | 评论 | AI 搜索 |
| 社交网络 | 邮箱/社交 | 个人资料、帖子 | 媒体 | 关注、动态流 | AI 推荐 |
常见实现模式
1. Auth setup (email + social login)
2. Core CRUD (main data tables)
3. File upload (images/media)
4. Advanced features (search, filters, relationships)
5. AI integration (recommendations, summaries)
6. Troubleshooting & optimization
故障排除速查表
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 401 未授权 | 令牌已过期 | POST /v1/auth/refresh |
| 403 禁止访问 | 权限不足 | 检查 RBAC 设置 |
| 404 未找到 | 路径或 ID 错误 | 验证端点和环境 |
| 409 冲突 | 唯一字段重复 | 检查重复数据 |
| 429 请求速率限制 | 超出请求限制（100/h） | 检查 Retry-After 标头 |
| CORS 错误 | 域名未注册 | 在 bkend 控制台注册 |
| MCP 连接失败 | OAuth 未完成 | 完成浏览器身份验证 |
| 架构验证 | BSON 类型不匹配 | 使用 backend_table_get 检查架构 |
常见问题
| 问题 | 答案 |
|---|---|
| 表格不可见 | 检查环境（dev/staging/prod） |
| 未显示 MCP 工具 | 运行 claude mcp list 验证连接 |
| 社交登录无法使用 | 检查控制台中的 Provider 设置 |
| 文件上传失败 | 验证大小限制（图片 10MB，视频 100MB） |
| 查询缓慢 | 通过 backend_index_manage 添加索引 |
| 数据未同步 | 检查 x-environment 标头是否匹配 |
官方文档（实时参考）
如需查看最新指南和故障排除信息，请使用 WebFetch：
评论
支持 Markdown