Agent skill

bkend-quickstart

bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project. Triggers: bkend quickstart, onboarding, setup, MCP, 시작하기, 온보딩.

View SKILL.md on GitHub Repository
Stars 491
Forks 125

Install this agent skill to your Project

npx add-skill https://github.com/popup-studio-ai/bkit-claude-code/tree/main/skills/bkend-quickstart

SKILL.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)

bash
claude mcp add bkend --transport http https://api.bkend.ai/mcp

Step-by-Step Guide

  1. Prerequisites: bkend.ai account (signup at https://console.bkend.ai)
  2. Run setup command: claude mcp add bkend --transport http https://api.bkend.ai/mcp
  3. OAuth authentication: Browser auto-opens for OAuth 2.1 + PKCE auth (no API key needed)
  4. Verify connection: Ask "Show my connected bkend projects" or use get_context MCP tool
  5. 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

  1. Sign up at bkend.ai -> Create Organization
  2. Create Project -> dev environment auto-created
  3. Connect MCP -> claude mcp add bkend
  4. Create first table -> "Create a users table"
  5. 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:

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

popup-studio-ai/bkit-claude-code

phase-5-design-system

491 125
Explore
popup-studio-ai/bkit-claude-code

zero-script-qa

Zero Script QA — test without scripts using structured JSON logging and Docker monitoring. Triggers: zero-script-qa, log testing, docker logs, QA, 제로 스크립트 QA.

491 125
Explore
popup-studio-ai/bkit-claude-code

phase-6-ui-integration

Implement frontend UI and integrate with backend APIs — state management and API clients. Triggers: UI integration, frontend-backend, API client, 프론트엔드 통합, UI 구현.

491 125
Explore
popup-studio-ai/bkit-claude-code

phase-3-mockup

Create UI/UX mockups and HTML/CSS/JS prototypes without a designer. Triggers: mockup, prototype, wireframe, UI design, 목업, 프로토타입.

491 125
Explore
popup-studio-ai/bkit-claude-code

desktop-app

Desktop app development guide — Electron and Tauri for cross-platform apps. Triggers: desktop app, Electron, Tauri, mac app, windows app, 데스크톱 앱.

491 125
Explore
popup-studio-ai/bkit-claude-code

btw

By-The-Way: 작업 중 개선 제안을 즉시 수집하고 관리하는 스킬. Triggers: /btw, /btw list, /btw analyze, /btw promote, /btw stats Keywords: btw, 개선, 제안, suggestion, improve, idea, feedback

491 125
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results