| name | bkend-quickstart |
| classification | capability |
| classification-reason | Pattern guidance may overlap with model's built-in knowledge as it improves |
| deprecation-risk | medium |
| effort | medium |
| description | bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project.
Triggers: bkend quickstart, bkend onboarding, bkend setup, bkend MCP
|
| user-invocable | false |
| agent | bkit:bkend-expert |
| allowed-tools | ["Read","WebFetch","mcp__bkend__*"] |
| imports | ["${PLUGIN_ROOT}/templates/shared/bkend-patterns.md"] |
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 to verify, re-add if needed |
