About bkend-cookbook
bkend-cookbook is a collection of bkend.ai application guides and troubleshooting references for developers building common app types. It includes examples at several levels, chapter-based project guides, and help with common errors.
Key features
- 01Examples for a range of app projects
- 02Four complete chapter-based guides
- 03Common implementation steps
- 04Error causes and suggested fixes
- 05Frequently encountered configuration issues
Use cases
- 01Follow a guide to build a blog or recipe app
- 02Plan development steps including auth and file uploads
- 03Troubleshoot authorization, rate-limit, or MCP connection errors
MCP support
The material covers troubleshooting failed MCP connections, including completing browser OAuth authentication and checking MCP connection status in Claude Code.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/bkend-cookbookin Claude Code to confirm it loaded.
Details
From the project READMEbkend.ai Cookbook & Troubleshooting
Single Project Guides
| Project | Level | Key Features |
|---|---|---|
| Todo App | Beginner | Basic CRUD, state management |
| Note App | Beginner | Rich text, categories |
| Blog | Intermediate | Posts, tags, file upload |
| Chat App | Intermediate | Real-time messaging |
| E-commerce | Intermediate | Products, orders, payments |
| Booking System | Intermediate | Reservations, calendar |
| Social Feed | Advanced | Posts, follows, feeds |
| Dashboard | Advanced | Charts, analytics, roles |
| Multi-tenant | Advanced | Organization-scoped data |
| SaaS Starter | Advanced | Subscriptions, billing, onboarding |
Full Guide Projects (4, each with quick-start + 7 chapters)
| Project | Auth | Core CRUD | Files | Advanced | AI |
|---|---|---|---|---|---|
| Blog | Email/Social | Articles, Tags | Images | Bookmarks | AI summary |
| Recipe App | Email/Social | Recipes, Ingredients | Photos | Meal Plan, Shopping List | AI recommendations |
| Shopping Mall | Email/Social | Stores, Products, Orders | Product images | Reviews | AI search |
| Social Network | Email/Social | Profiles, Posts | Media | Follows, Feeds | AI recommendations |
Common Implementation Pattern
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
Troubleshooting Quick Reference
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Token expired | POST /v1/auth/refresh |
| 403 Forbidden | Insufficient permissions | Check RBAC settings |
| 404 Not Found | Wrong path/ID | Verify endpoint and environment |
| 409 Conflict | Unique field duplicate | Check duplicate data |
| 429 Rate Limit | Request limit exceeded (100/h) | Check Retry-After header |
| CORS Error | Domain not registered | Register in bkend console |
| MCP Connection Failed | OAuth incomplete | Complete browser auth |
| Schema Validation | BSON type mismatch | Check schema with backend_table_get |
FAQ
| Question | Answer |
|---|---|
| Table not visible | Check environment (dev/staging/prod) |
| MCP tools not showing | Run claude mcp list to verify connection |
| Social login not working | Check Provider settings in console |
| File upload fails | Verify size limits (image 10MB, video 100MB) |
| Slow queries | Add indexes via backend_index_manage |
| Data not syncing | Check x-environment header matches |
Official Documentation (Live Reference)
For the latest cookbook and troubleshooting, use WebFetch:
- Cookbooks: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/cookbooks/blog/01-quick-start.md
- Troubleshooting: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/troubleshooting/01-common-errors.md
- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
Comments
Markdown supported