bkend-quickstart
0
总安装量
1
周安装量
安装命令
npx skills add https://github.com/popup-studio-ai/bkit-claude-code --skill bkend-quickstart
Agent 安装分布
opencode
1
cursor
1
claude-code
1
Skill 文档
bkend.ai Quick Start Guide
What is bkend.ai
MCP-based BaaS platform providing Database, Authentication, and Storage services. Manage backend via natural language from AI tools (Claude Code, Cursor).
Resource Hierarchy
Organization (team/billing) -> Project (service unit) -> Environment (dev/staging/prod, data isolation)
Tenant vs User
- Tenant: Service builder (OAuth 2.1 auth, MCP/Management API access)
- User: App end-user (JWT auth, Service API access)
- One person can have both roles
MCP Setup (Claude Code)
Quick Setup (One Command)
claude mcp add bkend --transport http https://api.bkend.ai/mcp
Step-by-Step Guide
- Prerequisites: bkend.ai account (signup at https://console.bkend.ai)
- Run setup command:
claude mcp add bkend --transport http https://api.bkend.ai/mcp - OAuth authentication: Browser auto-opens for OAuth 2.1 + PKCE auth (no API key needed)
- Verify connection: Ask “Show my connected bkend projects” or use
0_get_contextMCP tool - Create .mcp.json (optional, for team sharing):
{ "mcpServers": { "bkend": { "type": "http", "url": "https://api.bkend.ai/mcp" } } }
Troubleshooting MCP Connection
| Problem | Solution |
|---|---|
| OAuth popup not appearing | Check browser popup blocker |
| MCP tools not visible | Run claude mcp list to verify, re-add if needed |
| Connection lost | Re-authenticate (automatic on next MCP call) |
| Wrong project/env | Use 0_get_context to check current session |
MCP Guide Tools (No Parameters)
| Tool | Purpose |
|---|---|
| 0_get_context | Session context (org/project/env) |
| 1_concepts | Core concepts (BSON, permissions, hierarchy) |
| 2_tutorial | Project~table creation tutorial |
First Project Checklist
- Sign up at bkend.ai -> Create Organization
- Create Project -> dev environment auto-created
- Connect MCP ->
claude mcp add bkend - Create first table -> “Create a users table”
- Start data operations -> CRUD via natural language
Console URL
https://console.bkend.ai
Next Steps
- Database operations: refer to bkend-data skill
- Authentication: refer to bkend-auth skill
- File storage: refer to bkend-storage skill
- Practical tutorials: refer to bkend-cookbook skill
Official Documentation (Live Reference)
For the latest bkend documentation, use WebFetch:
- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
- Getting Started: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/src/getting-started/
- AI Tools/MCP: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/src/ai-tools/
- Console: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/src/console/