popup-studio-ai/bkend-quickstart
skills/bkend-quickstart/SKILL.md
bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project. Triggers: bkend quickstart, onboarding, setup, MCP, 시작하기, 온보딩.
$ install --global
skillsauthnpx skillsauth add popup-studio-ai/bkit-claude-code bkend-quickstartInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 6:20 AM68.0s1 file scanned
SKILL.md
- 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:
- |
- Triggers:
- bkend quickstart, onboarding, setup, MCP, 시작하기, 온보딩.
- user-invocable:
- false
- agent:
- bkit:bkend-expert
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):
{ "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
Related Skills
popup-studio-ai/sprint
testing
VerifiedTrustedCommunity
Sprint Management — generic sprint capability for ANY bkit user. 16 sub-actions: init, start, status, watch, phase, iterate, qa, report, archive, list, feature, pause, resume, fork, help, master-plan. Triggers: sprint, sprint start, sprint init, sprint status, sprint list, 스프린트, 스프린트 시작, 스프린트 상태, スプリント, スプリント開始, スプリント状態, 冲刺, 冲刺开始, 冲刺状态, sprint, iniciar sprint, estado sprint, sprint, demarrer sprint, statut sprint, Sprint, Sprint starten, Sprint Status, sprint, avviare sprint, stato sprint, master plan, multi-sprint plan, sprint master plan, 마스터 플랜, 멀티 스프린트 계획, 스프린트 마스터 플랜, マスタープラン, マルチスプリント計画, スプリントマスタープラン, 主计划, 多冲刺计划, 冲刺主计划, plan maestro, plan multi-sprint, plan maestro sprint, plan maître, plan multi-sprint, plan maître sprint, Masterplan, Multi-Sprint-Plan, Sprint-Masterplan, piano principale, piano multi-sprint, piano principale sprint.
548SKILL.mdUpdated May 13, 2026
popup-studio-ai/cc-version-analysis
tools
VerifiedTrustedCommunity
CC CLI version upgrade impact analysis — research changes, analyze bkit impact, generate report. Triggers: cc-version-analysis, CC upgrade, version analysis, CC 버전 분석, 버전 영향.
545SKILL.mdUpdated Apr 18, 2026
popup-studio-ai/rollback
testing
VerifiedTrustedCommunity
Manage PDCA checkpoints and rollback — create, list, restore for safe recovery. Rollback events are recorded via lib/audit/audit-logger ACTION_TYPES.rollback_executed. For sprint-level recovery, individual feature rollbacks may be triggered from within sprint phases (sprint itself is forward-only — terminal state is `archived`, not rolled back; v2.1.13). Triggers: rollback, checkpoint, restore, undo, 롤백, 체크포인트, 복원.
539SKILL.mdUpdated Apr 18, 2026
popup-studio-ai/qa-phase
testing
VerifiedTrustedCommunity
QA Phase execution — L1-L5 test planning, generation, execution, and reporting for a single feature. For sprint-level QA (7-Layer dataFlowIntegrity / S1 gate across multiple features) use /sprint qa <sprintId> which delegates to sprint-qa-flow agent (v2.1.13). Triggers: qa phase, QA test, qa run, QA 실행, QAフェーズ, QA阶段, fase QA, phase QA, QA-Phase, fase QA.
539SKILL.mdUpdated Apr 18, 2026