Skill v1.0.1
currentAutomated scan100/1001 files
version: "1.0.1" 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, onboarding, setup, 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_contextMCP tool - Create .mcp.json (optional, for team sharing):
``json { "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:
- Quick Start: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/02-quick-start.md
- Core Concepts: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/getting-started/03-core-concepts.md
- Claude Code Setup: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/ai-tools/04-claude-code-setup.md
- MCP Overview: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/01-overview.md
- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md