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
get_context MCP 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 get_context to check current session |
MCP Fixed Tools
| Tool |
Purpose |
get_context |
Session context (org/project/env, API endpoint) |
search_docs |
Search bkend documentation |
get_operation_schema |
Get tool input/output schema |
Searchable Guides (via search_docs)
| Doc ID |
Content |
1_concepts |
BSON schema, permissions, hierarchy |
2_tutorial |
Project~table creation tutorial |
MCP Project Management Tools
| Tool |
Purpose |
Key Parameters |
backend_org_list |
List organizations |
None |
backend_project_list |
List projects |
organizationId |
backend_project_get |
Get project detail |
organizationId, projectId |
backend_project_create |
Create project |
organizationId, name, description? |
backend_project_update |
Update project |
organizationId, projectId, name?, description? |
backend_project_delete |
Delete project (irreversible!) |
organizationId, projectId |
backend_env_list |
List environments |
organizationId, projectId |
backend_env_get |
Get environment detail |
organizationId, projectId, environmentId |
backend_env_create |
Create environment |
organizationId, projectId, name |
MCP Resources (Read-Only)
Lightweight, cached (60s TTL) read-only queries via bkend:// URI:
| URI |
Description |
bkend://orgs |
Organization list |
bkend://orgs/{orgId}/projects |
Project list |
bkend://orgs/{orgId}/projects/{pId}/environments |
Environment list |
bkend://orgs/{orgId}/projects/{pId}/environments/{eId}/tables |
Table list with schema |
Tip: Prefer Resources over Tools for listing operations (lighter, cached).
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:
1---2name: bkend-quickstart3description: bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project. Triggers: bkend quickstart, bkend onboarding, bkend setup, bkend MCP4---56# bkend.ai Quick Start Guide78## What is bkend.ai910MCP-based BaaS platform providing Database, Authentication, and Storage services.11Manage backend via natural language from AI tools (Claude Code, Cursor).1213## Resource Hierarchy1415```16Organization (team/billing) -> Project (service unit) -> Environment (dev/staging/prod, data isolation)17```1819## Tenant vs User2021- **Tenant**: Service builder (OAuth 2.1 auth, MCP/Management API access)22- **User**: App end-user (JWT auth, Service API access)23- One person can have both roles2425## MCP Setup (Claude Code)2627### Quick Setup (One Command)2829```bash30claude mcp add bkend --transport http https://api.bkend.ai/mcp31```3233### Step-by-Step Guide34351. **Prerequisites**: bkend.ai account (signup at https://console.bkend.ai)362. **Run setup command**: `claude mcp add bkend --transport http https://api.bkend.ai/mcp`373. **OAuth authentication**: Browser auto-opens for OAuth 2.1 + PKCE auth (no API key needed)384. **Verify connection**: Ask "Show my connected bkend projects" or use `get_context` MCP tool395. **Create .mcp.json** (optional, for team sharing):40 ```json41 {42 "mcpServers": {43 "bkend": {44 "type": "http",45 "url": "https://api.bkend.ai/mcp"46 }47 }48 }49 ```5051### Troubleshooting MCP Connection5253| Problem | Solution |54|---------|----------|55| OAuth popup not appearing | Check browser popup blocker |56| MCP tools not visible | Run `claude mcp list` to verify, re-add if needed |57| Connection lost | Re-authenticate (automatic on next MCP call) |58| Wrong project/env | Use `get_context` to check current session |5960## MCP Fixed Tools6162| Tool | Purpose |63|------|---------|64| `get_context` | Session context (org/project/env, API endpoint) |65| `search_docs` | Search bkend documentation |66| `get_operation_schema` | Get tool input/output schema |6768## Searchable Guides (via search_docs)6970| Doc ID | Content |71|--------|---------|72| `1_concepts` | BSON schema, permissions, hierarchy |73| `2_tutorial` | Project~table creation tutorial |7475## MCP Project Management Tools7677| Tool | Purpose | Key Parameters |78|------|---------|----------------|79| `backend_org_list` | List organizations | None |80| `backend_project_list` | List projects | organizationId |81| `backend_project_get` | Get project detail | organizationId, projectId |82| `backend_project_create` | Create project | organizationId, name, description? |83| `backend_project_update` | Update project | organizationId, projectId, name?, description? |84| `backend_project_delete` | Delete project (irreversible!) | organizationId, projectId |85| `backend_env_list` | List environments | organizationId, projectId |86| `backend_env_get` | Get environment detail | organizationId, projectId, environmentId |87| `backend_env_create` | Create environment | organizationId, projectId, name |8889## MCP Resources (Read-Only)9091Lightweight, cached (60s TTL) read-only queries via bkend:// URI:9293| URI | Description |94|-----|-------------|95| `bkend://orgs` | Organization list |96| `bkend://orgs/{orgId}/projects` | Project list |97| `bkend://orgs/{orgId}/projects/{pId}/environments` | Environment list |98| `bkend://orgs/{orgId}/projects/{pId}/environments/{eId}/tables` | Table list with schema |99100**Tip**: Prefer Resources over Tools for listing operations (lighter, cached).101102## First Project Checklist1031041. Sign up at bkend.ai -> Create Organization1052. Create Project -> dev environment auto-created1063. Connect MCP -> `claude mcp add bkend`1074. Create first table -> "Create a users table"1085. Start data operations -> CRUD via natural language109110## Console URL111112```113https://console.bkend.ai114```115116## Next Steps117118- Database operations: refer to bkend-data skill119- Authentication: refer to bkend-auth skill120- File storage: refer to bkend-storage skill121- Practical tutorials: refer to bkend-cookbook skill122123## Official Documentation (Live Reference)124125For the latest bkend documentation, use WebFetch:126- Quick Start: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/02-quick-start.md127- Core Concepts: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/03-core-concepts.md128- Claude Code Setup: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/ai-tools/04-claude-code-setup.md129- MCP Overview: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/01-overview.md130- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
popup-studio-ai